Save
Save(string)
Speichert das Dokument in einer Datei. Das Speicherformat wird automatisch anhand der Erweiterung ermittelt.
public SaveOutputParameters Save(string fileName)
Parameter | Typ | Beschreibung |
---|---|---|
fileName | String | Der Name des Dokuments. Wenn bereits ein Dokument mit dem angegebenen Dateinamen vorhanden ist, wird das vorhandene Dokument überschrieben. |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Beispiele
Zeigt, wie man ein Dokument öffnet und in das PDF-Format konvertiert.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "Document.ConvertToPdf.pdf");
Zeigt, wie man eine PDF-Datei in eine DOCX-Datei konvertiert.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
// Laden Sie das gerade gespeicherte PDF-Dokument und konvertieren Sie es in .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.docx");
Siehe auch
- class SaveOutputParameters
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words
Save(string, SaveFormat)
Speichert das Dokument in einer Datei im angegebenen Format.
public SaveOutputParameters Save(string fileName, SaveFormat saveFormat)
Parameter | Typ | Beschreibung |
---|---|---|
fileName | String | Der Name des Dokuments. Wenn bereits ein Dokument mit dem angegebenen Dateinamen vorhanden ist, wird das vorhandene Dokument überschrieben. |
saveFormat | SaveFormat | Das Format, in dem das Dokument gespeichert werden soll. |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Beispiele
Zeigt, wie man vom DOCX- ins HTML-Format konvertiert.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "Document.ConvertToHtml.html", SaveFormat.Html);
Siehe auch
- class SaveOutputParameters
- enum SaveFormat
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words
Save(string, SaveOptions)
Speichert das Dokument mit den angegebenen Speicheroptionen in einer Datei.
public SaveOutputParameters Save(string fileName, SaveOptions saveOptions)
Parameter | Typ | Beschreibung |
---|---|---|
fileName | String | Der Name des Dokuments. Wenn bereits ein Dokument mit dem angegebenen Dateinamen vorhanden ist, wird das vorhandene Dokument überschrieben. |
saveOptions | SaveOptions | Gibt die Optionen an, die steuern, wie das Dokument gespeichert wird. Kann seinnull . |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Beispiele
Zeigt, wie die Qualität eines gerenderten Dokuments mit SaveOptions verbessert werden kann.
Document doc = new Document(MyDir + "Rendering.docx");
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Font.Size = 60;
builder.Writeln("Some text.");
SaveOptions options = new ImageSaveOptions(SaveFormat.Jpeg);
doc.Save(ArtifactsDir + "Document.ImageSaveOptions.Default.jpg", options);
options.UseAntiAliasing = true;
options.UseHighQualityRendering = true;
doc.Save(ArtifactsDir + "Document.ImageSaveOptions.HighQuality.jpg", options);
Zeigt, wie Sie eine PDF-Datei in eine DOCX-Datei konvertieren und den Speichervorgang mit einem SaveOptions-Objekt anpassen.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.pdf");
// Laden Sie das gerade gespeicherte PDF-Dokument und konvertieren Sie es in .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.pdf");
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
// Legen Sie die Eigenschaft „Passwort“ fest, um das gespeicherte Dokument mit einem Passwort zu verschlüsseln.
saveOptions.Password = "MyPassword";
pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.docx", saveOptions);
Zeigt, wie jede Seite eines Dokuments in ein separates TIFF-Bild gerendert wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 2.");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 3.");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Tiff);
for (int i = 0; i < doc.PageCount; i++)
{
// Setze die Eigenschaft "PageSet" auf die Nummer der ersten Seite von
// von wo aus mit dem Rendern des Dokuments begonnen werden soll.
options.PageSet = new PageSet(i);
// Seite mit 2325 x 5325 Pixeln und 600 dpi exportieren.
options.Resolution = 600;
options.ImageSize = new Size(2325, 5325);
doc.Save(ArtifactsDir + $"ImageSaveOptions.PageByPage.{i + 1}.tiff", options);
}
Zeigt, wie eine Seite aus einem Dokument in ein JPEG-Bild gerendert wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 2.");
builder.InsertImage(ImageDir + "Logo.jpg");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 3.");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Jpeg);
// Setze das "PageSet" auf "1", um die zweite Seite auszuwählen über
// der nullbasierte Index, ab dem mit der Darstellung des Dokuments begonnen werden soll.
options.PageSet = new PageSet(1);
// Wenn wir das Dokument im JPEG-Format speichern, rendert Aspose.Words nur eine Seite.
// Dieses Bild enthält eine Seite ab Seite zwei,
// Dies ist lediglich die zweite Seite des Originaldokuments.
doc.Save(ArtifactsDir + "ImageSaveOptions.OnePage.jpg", options);
Zeigt, wie die Komprimierung beim Speichern eines Dokuments als JPEG konfiguriert wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// Erstellen Sie ein "ImageSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um die Art und Weise zu ändern, in der diese Methode das Dokument in ein Bild umwandelt.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Setzen Sie die Eigenschaft „JpegQuality“ auf „10“, um beim Rendern des Dokuments eine stärkere Komprimierung zu verwenden.
// Dadurch wird die Dateigröße des Dokuments reduziert, das Bild weist jedoch deutlichere Komprimierungsartefakte auf.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
// Setzen Sie die Eigenschaft „JpegQuality“ auf „100“, um beim Rendern des Dokuments eine schwächere Komprimierung zu verwenden.
// Dadurch wird die Bildqualität verbessert, allerdings erhöht sich die Dateigröße.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Zeigt, wie ein ganzes Dokument mit drei Ebenen in der Dokumentgliederung in PDF konvertiert wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Überschriften der Ebenen 1 bis 5 einfügen.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
Assert.True(builder.ParagraphFormat.IsHeading);
builder.Writeln("Heading 1");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;
builder.Writeln("Heading 1.2.1");
builder.Writeln("Heading 1.2.2");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;
builder.Writeln("Heading 1.2.2.1");
builder.Writeln("Heading 1.2.2.2");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading5;
builder.Writeln("Heading 1.2.2.2.1");
builder.Writeln("Heading 1.2.2.2.2");
// Erstellen Sie ein "PdfSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um zu ändern, wie diese Methode das Dokument in .PDF konvertiert.
PdfSaveOptions options = new PdfSaveOptions();
// Das ausgegebene PDF-Dokument enthält eine Gliederung, d. h. ein Inhaltsverzeichnis, das die Überschriften im Dokumenttext auflistet.
// Durch Klicken auf einen Eintrag in dieser Gliederung gelangen wir zur Position der entsprechenden Überschrift.
// Setzen Sie die Eigenschaft „HeadingsOutlineLevels“ auf „4“, um alle Überschriften, deren Ebenen über 4 liegen, aus der Gliederung auszuschließen.
options.OutlineOptions.HeadingsOutlineLevels = 4;
// Wenn ein Gliederungseintrag nachfolgende Einträge einer höheren Ebene zwischen sich selbst und dem nächsten Eintrag der gleichen oder niedrigeren Ebene hat,
// links neben dem Eintrag erscheint ein Pfeil. Dieser Eintrag ist der „Eigentümer“ mehrerer solcher „Untereinträge“.
// In unserem Dokument sind die Gliederungseinträge der 5. Überschriftenebene Untereinträge des zweiten Gliederungseintrags der 4. Ebene,
// Die Einträge der 4. und 5. Überschriftenebene sind Untereinträge des zweiten Eintrags der 3. Ebene und so weiter.
// In der Gliederung können wir auf den Pfeil des Eintrags „Eigentümer“ klicken, um alle Untereinträge auszublenden/einzuklappen.
// Setzen Sie die Eigenschaft „ExpandedOutlineLevels“ auf „2“, um alle Gliederungseinträge der Überschriftenebene 2 und darunter automatisch zu erweitern
// und reduzieren Sie alle Einträge der Ebene 3 und höher, wenn wir das Dokument öffnen.
options.OutlineOptions.ExpandedOutlineLevels = 2;
doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);
Siehe auch
- class SaveOutputParameters
- class SaveOptions
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words
Save(Stream, SaveFormat)
Speichert das Dokument im angegebenen Format in einem Stream.
public SaveOutputParameters Save(Stream stream, SaveFormat saveFormat)
Parameter | Typ | Beschreibung |
---|---|---|
stream | Stream | Geben Sie an, wo das Dokument gespeichert werden soll. |
saveFormat | SaveFormat | Das Format, in dem das Dokument gespeichert werden soll. |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Beispiele
Zeigt, wie ein Dokument in einem Stream gespeichert wird.
Document doc = new Document(MyDir + "Document.docx");
using (MemoryStream dstStream = new MemoryStream())
{
doc.Save(dstStream, SaveFormat.Docx);
// Überprüfen Sie, ob der Stream das Dokument enthält.
Assert.AreEqual("Hello World!\r\rHello Word!\r\r\rHello World!", new Document(dstStream).GetText().Trim());
}
Zeigt, wie ein Dokument über einen Stream in einem Bild gespeichert und das Bild dann aus diesem Stream gelesen wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Font.Name = "Times New Roman";
builder.Font.Size = 24;
builder.Writeln("Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.");
builder.InsertImage(ImageDir + "Logo.jpg");
#if NET461_OR_GREATER || JAVA
using (MemoryStream stream = new MemoryStream())
{
doc.Save(stream, SaveFormat.Bmp);
stream.Position = 0;
// Lesen Sie den Stream zurück in ein Bild.
using (Image image = Image.FromStream(stream))
{
Assert.AreEqual(ImageFormat.Bmp, image.RawFormat);
Assert.AreEqual(816, image.Width);
Assert.AreEqual(1056, image.Height);
}
}
#elif NET5_0_OR_GREATER
using (MemoryStream stream = new MemoryStream())
{
doc.Save(stream, SaveFormat.Bmp);
stream.Position = 0;
SKCodec codec = SKCodec.Create(stream);
Assert.AreEqual(SKEncodedImageFormat.Bmp, codec.EncodedFormat);
stream.Position = 0;
using (SKBitmap image = SKBitmap.Decode(stream))
{
Assert.AreEqual(816, image.Width);
Assert.AreEqual(1056, image.Height);
}
}
#endif
Siehe auch
- class SaveOutputParameters
- enum SaveFormat
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words
Save(Stream, SaveOptions)
Speichert das Dokument unter Verwendung der angegebenen Speicheroptionen in einem Stream.
public SaveOutputParameters Save(Stream stream, SaveOptions saveOptions)
Parameter | Typ | Beschreibung |
---|---|---|
stream | Stream | Geben Sie an, wo das Dokument gespeichert werden soll. |
saveOptions | SaveOptions | Gibt die Optionen an, die steuern, wie das Dokument gespeichert wird. Kann seinnull . Wenn diesnull , wird das Dokument im binären DOC-Format gespeichert. |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Beispiele
Zeigt, wie nur einige Seiten eines Dokuments in PDF konvertiert werden.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Page 1.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 2.");
builder.InsertBreak(BreakType.PageBreak);
builder.Writeln("Page 3.");
using (Stream stream = File.Create(ArtifactsDir + "PdfSaveOptions.OnePage.pdf"))
{
// Erstellen Sie ein "PdfSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
// um zu ändern, wie diese Methode das Dokument in .PDF konvertiert.
PdfSaveOptions options = new PdfSaveOptions();
// Setzen Sie den „PageIndex“ auf „1“, um einen Teil des Dokuments ab der zweiten Seite zu rendern.
options.PageSet = new PageSet(1);
// Dieses Dokument enthält eine Seite ab Seite zwei, die wiederum nur die zweite Seite enthält.
doc.Save(stream, options);
}
Siehe auch
- class SaveOutputParameters
- class SaveOptions
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words
Save(HttpResponse, string, ContentDisposition, SaveOptions)
Sendet das Dokument an den Client-Browser.
public SaveOutputParameters Save(HttpResponse response, string fileName,
ContentDisposition contentDisposition, SaveOptions saveOptions)
Parameter | Typ | Beschreibung |
---|---|---|
response | HttpResponse | Antwortobjekt, in dem das Dokument gespeichert werden soll. |
fileName | String | Der Name des Dokuments, das im Client-Browser angezeigt wird. Der Name darf keinen Pfad enthalten. |
contentDisposition | ContentDisposition | AContentDisposition Der Wert that gibt an, wie das Dokument im Client-Browser dargestellt wird. |
saveOptions | SaveOptions | Gibt die Optionen an, die steuern, wie das Dokument gespeichert wird. Kann seinnull . |
Rückgabewert
Zusätzliche Informationen, die Sie optional verwenden können.
Bemerkungen
Intern speichert diese Methode zuerst in einem Speicherstream und kopiert dann in den Antwortstream , da der Antwortstream keine Suche unterstützt.
Beispiele
Zeigt, wie Sie einen Serienbrief erstellen und das Dokument anschließend im Client-Browser speichern.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(" MERGEFIELD FullName ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD Company ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD Address ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD City ");
doc.MailMerge.Execute(new string[] { "FullName", "Company", "Address", "City" },
new object[] { "James Bond", "MI5 Headquarters", "Milbank", "London" });
// Senden Sie das Dokument an den Client-Browser.
//Ausgelöst, weil HttpResponse im Test null ist.
Assert.Throws<ArgumentNullException>(() => doc.Save(response, "Artifacts/MailMerge.ExecuteArray.docx", ContentDisposition.Inline, null));
// Wir müssen diese Antwort manuell schließen, um sicherzustellen, dass wir dem Dokument nach dem Speichern keinen überflüssigen Inhalt hinzufügen.
Assert.Throws<NullReferenceException>(() => response.End());
Siehe auch
- class SaveOutputParameters
- enum ContentDisposition
- class SaveOptions
- class Document
- namensraum Aspose.Words
- Montage Aspose.Words