Save
Save(string)
Sparar dokumentet till en fil. Bestämmer automatiskt sparformatet från tillägget.
public SaveOutputParameters Save(string fileName)
Parameter | Typ | Beskrivning |
---|---|---|
fileName | String | Namnet på dokumentet. Om ett dokument med det angivna filnamnet redan finns, skrivs det befintliga dokumentet över. |
Returvärde
Ytterligare information som du valfritt kan använda.
Exempel
Visar hur man öppnar ett dokument och konverterar det till .PDF.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "Document.ConvertToPdf.pdf");
Visar hur man konverterar en PDF till en .docx.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
// Ladda PDF-dokumentet som vi just sparat och konvertera det till .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.pdf");
pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocx.docx");
Se även
- class SaveOutputParameters
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
Save(string, SaveFormat)
Sparar dokumentet till en fil i angivet format.
public SaveOutputParameters Save(string fileName, SaveFormat saveFormat)
Parameter | Typ | Beskrivning |
---|---|---|
fileName | String | Namnet på dokumentet. Om ett dokument med det angivna filnamnet redan finns, skrivs det befintliga dokumentet över. |
saveFormat | SaveFormat | Formatet för att spara dokumentet. |
Returvärde
Ytterligare information som du valfritt kan använda.
Exempel
Visar hur man konverterar från DOCX till HTML-format.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "Document.ConvertToHtml.html", SaveFormat.Html);
Se även
- class SaveOutputParameters
- enum SaveFormat
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
Save(string, SaveOptions)
Sparar dokumentet till en fil med de angivna sparalternativen.
public SaveOutputParameters Save(string fileName, SaveOptions saveOptions)
Parameter | Typ | Beskrivning |
---|---|---|
fileName | String | Namnet på dokumentet. Om ett dokument med det angivna filnamnet redan finns, skrivs det befintliga dokumentet över. |
saveOptions | SaveOptions | Anger alternativen som styr hur dokumentet sparas. Kan varanull . |
Returvärde
Ytterligare information som du valfritt kan använda.
Exempel
Visar hur man förbättrar kvaliteten på ett renderat dokument med SaveOptions.
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);
Visar hur man konverterar en PDF till en .docx och anpassar sparprocessen med ett SaveOptions-objekt.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello world!");
doc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.pdf");
// Ladda PDF-dokumentet som vi just sparat och konvertera det till .docx.
Document pdfDoc = new Document(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.pdf");
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions(SaveFormat.Docx);
// Ställ in egenskapen "Password" för att kryptera det sparade dokumentet med ett lösenord.
saveOptions.Password = "MyPassword";
pdfDoc.Save(ArtifactsDir + "PDF2Word.ConvertPdfToDocxCustom.docx", saveOptions);
Visar hur man renderar varje sida i ett dokument till en separat TIFF-bild.
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.");
// Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Tiff);
for (int i = 0; i < doc.PageCount; i++)
{
// Ställ in egenskapen "PageSet" till numret på den första sidan från
// som du ska börja rendera dokumentet från.
options.PageSet = new PageSet(i);
// Exportera sida med 2325x5325 pixlar och 600 dpi.
options.Resolution = 600;
options.ImageSize = new Size(2325, 5325);
doc.Save(ArtifactsDir + $"ImageSaveOptions.PageByPage.{i + 1}.tiff", options);
}
Visar hur man renderar en sida från ett dokument till en JPEG-bild.
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.");
// Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
ImageSaveOptions options = new ImageSaveOptions(SaveFormat.Jpeg);
// Ställ in "PageSet" på "1" för att välja den andra sidan via
// det nollbaserade indexet att börja rendera dokumentet från.
options.PageSet = new PageSet(1);
// När vi sparar dokumentet i JPEG-format renderar Aspose.Words bara en sida.
// Den här bilden kommer att innehålla en sida från sida två,
// som bara kommer att vara den andra sidan i originaldokumentet.
doc.Save(ArtifactsDir + "ImageSaveOptions.OnePage.jpg", options);
Visar hur du konfigurerar komprimering medan du sparar ett dokument som en JPEG.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertImage(ImageDir + "Logo.jpg");
// Skapa ett "ImageSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra sättet på vilket den metoden renderar dokumentet till en bild.
ImageSaveOptions imageOptions = new ImageSaveOptions(SaveFormat.Jpeg);
// Ställ in egenskapen "JpegQuality" till "10" för att använda starkare komprimering när du renderar dokumentet.
// Detta kommer att minska filstorleken på dokumentet, men bilden kommer att visa mer framträdande komprimeringsartefakter.
imageOptions.JpegQuality = 10;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg", imageOptions);
Assert.That(20000, Is.AtLeast(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighCompression.jpg").Length));
// Ställ in egenskapen "JpegQuality" till "100" för att använda svagare komprimering när du renderar dokumentet.
// Detta kommer att förbättra kvaliteten på bilden till priset av en ökad filstorlek.
imageOptions.JpegQuality = 100;
doc.Save(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg", imageOptions);
Assert.That(60000, Is.LessThan(new FileInfo(ArtifactsDir + "ImageSaveOptions.JpegQuality.HighQuality.jpg").Length));
Visar hur man konverterar ett helt dokument till PDF med tre nivåer i dokumentöversikten.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Infoga rubriker för nivåerna 1 till 5.
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");
// Skapa ett "PdfSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra hur den metoden konverterar dokumentet till .PDF.
PdfSaveOptions options = new PdfSaveOptions();
// Det utgående PDF-dokumentet kommer att innehålla en disposition, som är en innehållsförteckning som listar rubriker i dokumentets brödtext.
// Genom att klicka på en post i denna disposition kommer vi till platsen för dess respektive rubrik.
// Ställ in egenskapen "HeadingsOutlineLevels" till "4" för att utesluta alla rubriker vars nivåer är över 4 från dispositionen.
options.OutlineOptions.HeadingsOutlineLevels = 4;
// Om en konturpost har efterföljande poster på en högre nivå mellan sig och nästa post på samma eller lägre nivå,
// en pil visas till vänster om posten. Denna post är "ägare" till flera sådana "underposter".
// I vårt dokument är dispositionsposterna från den 5:e rubriknivån underposter till den andra 4:e nivåns dispositionspost,
// posterna på 4:e och 5:e rubriknivån är underposter till den andra 3:e nivåposten, och så vidare.
// I dispositionen kan vi klicka på pilen för "ägare"-posten för att komprimera/expandera alla dess underposter.
// Ställ in egenskapen "ExpandedOutlineLevels" till "2" för att automatiskt utöka alla rubriknivå 2 och lägre dispositionsposter
// och kollapsa alla nivåer och 3 och högre poster när vi öppnar dokumentet.
options.OutlineOptions.ExpandedOutlineLevels = 2;
doc.Save(ArtifactsDir + "PdfSaveOptions.ExpandedOutlineLevels.pdf", options);
Se även
- class SaveOutputParameters
- class SaveOptions
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
Save(Stream, SaveFormat)
Sparar dokumentet i en ström med det angivna formatet.
public SaveOutputParameters Save(Stream stream, SaveFormat saveFormat)
Parameter | Typ | Beskrivning |
---|---|---|
stream | Stream | Streama var du vill spara dokumentet. |
saveFormat | SaveFormat | Formatet för att spara dokumentet. |
Returvärde
Ytterligare information som du valfritt kan använda.
Exempel
Visar hur man sparar ett dokument i en ström.
Document doc = new Document(MyDir + "Document.docx");
using (MemoryStream dstStream = new MemoryStream())
{
doc.Save(dstStream, SaveFormat.Docx);
// Verifiera att strömmen innehåller dokumentet.
Assert.AreEqual("Hello World!\r\rHello Word!\r\r\rHello World!", new Document(dstStream).GetText().Trim());
}
Visar hur man sparar ett dokument till en bild via stream, och sedan läser bilden från den streamen.
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 NET48 || JAVA
using (MemoryStream stream = new MemoryStream())
{
doc.Save(stream, SaveFormat.Bmp);
stream.Position = 0;
// Läs strömmen tillbaka till en 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 || __MOBILE__
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
Se även
- class SaveOutputParameters
- enum SaveFormat
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
Save(Stream, SaveOptions)
Sparar dokumentet i en ström med de angivna sparalternativen.
public SaveOutputParameters Save(Stream stream, SaveOptions saveOptions)
Parameter | Typ | Beskrivning |
---|---|---|
stream | Stream | Streama var du vill spara dokumentet. |
saveOptions | SaveOptions | Anger alternativen som styr hur dokumentet sparas. Kan varanull . Om detta ärnull , kommer dokumentet att sparas i det binära DOC-formatet. |
Returvärde
Ytterligare information som du valfritt kan använda.
Exempel
Visar hur man endast konverterar några av sidorna i ett dokument till PDF.
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"))
{
// Skapa ett "PdfSaveOptions"-objekt som vi kan skicka till dokumentets "Spara"-metod
// för att ändra hur den metoden konverterar dokumentet till .PDF.
PdfSaveOptions options = new PdfSaveOptions();
// Ställ in "PageIndex" till "1" för att rendera en del av dokumentet från den andra sidan.
options.PageSet = new PageSet(1);
// Detta dokument kommer att innehålla en sida från sida två, som bara kommer att innehålla den andra sidan.
doc.Save(stream, options);
}
Se även
- class SaveOutputParameters
- class SaveOptions
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words
Save(HttpResponse, string, ContentDisposition, SaveOptions)
Skickar dokumentet till klientens webbläsare.
public SaveOutputParameters Save(HttpResponse response, string fileName,
ContentDisposition contentDisposition, SaveOptions saveOptions)
Parameter | Typ | Beskrivning |
---|---|---|
response | HttpResponse | Svarsobjekt där dokumentet ska sparas. |
fileName | String | Namnet på dokumentet som kommer att visas i klientens webbläsare. Namnet ska inte innehålla sökväg. |
contentDisposition | ContentDisposition | AContentDisposition värde that anger hur dokumentet presenteras i klientens webbläsare. |
saveOptions | SaveOptions | Anger alternativen som styr hur dokumentet sparas. Kan varanull . |
Returvärde
Ytterligare information som du valfritt kan använda.
Anmärkningar
Internt sparar den här metoden först i en minnesström och kopieras sedan till svaret stream eftersom svarsströmmen inte stöder sökning.
Exempel
Visar hur man utför en sammanfogning och sedan sparar dokumentet i klientens webbläsare.
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" });
// Skicka dokumentet till klientens webbläsare.
Assert.That(() => doc.Save(response, "Artifacts/MailMerge.ExecuteArray.docx", ContentDisposition.Inline, null),
Throws.TypeOf<ArgumentNullException>()); //Kastad eftersom HttpResponse är null i testet.
// Vi kommer att behöva stänga detta svar manuellt för att säkerställa att vi inte lägger till något överflödigt innehåll i dokumentet efter att ha sparats.
Assert.That(() => response.End(), Throws.TypeOf<NullReferenceException>());
Se även
- class SaveOutputParameters
- enum ContentDisposition
- class SaveOptions
- class Document
- namnutrymme Aspose.Words
- hopsättning Aspose.Words