DocumentSave(HttpResponse, String, ContentDisposition, SaveOptions) Method

Sends the document to the client browser.

Namespace:  Aspose.Words
Assembly:  Aspose.Words (in Aspose.Words.dll) Version: 21.2.0

ExpandedSyntax

public SaveOutputParameters Save(
	HttpResponse response,
	string fileName,
	ContentDisposition contentDisposition,
	SaveOptions saveOptions
)

Parameters

response
Type: System.WebHttpResponse
Response object where to save the document.
fileName
Type: SystemString
The name for the document that will appear at the client browser. The name should not contain path.
contentDisposition
Type: Aspose.WordsContentDisposition
A ContentDisposition value that specifies how the document is presented at the client browser.
saveOptions
Type: Aspose.Words.SavingSaveOptions
Specifies the options that control how the document is saved. Can be null.

Return Value

Type: SaveOutputParameters
Additional information that you can optionally use.

ExpandedRemarks

Internally, this method saves to a memory stream first and then copies to the response stream because the response stream does not support seek.

ExpandedExamples

Shows how to perform a mail merge, and then save the document to the client browser.
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" });

// Send the document to the client browser.
Assert.That(() => doc.Save(response, "Artifacts/MailMerge.ExecuteArray.docx", ContentDisposition.Inline, null),
    Throws.TypeOf<ArgumentNullException>()); //Thrown because HttpResponse is null in the test.

// We will need to close this response manually to ensure that we do not add any superfluous content to the document after saving.
Assert.That(() => response.End(), Throws.TypeOf<NullReferenceException>());

ExpandedSee Also