XpsDocumentWriter.Write 方法

public:
 override void Write(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket);

public override void Write(System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Media.Visual * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (visual As Visual, printTicket As PrintTicket)

參數

備註

批次寫入 Visual時，請使用 VisualsToXpsDocument。

此方法不會驗證或修改特定 printTicket的指定PrintQueue值。 如有必要，使用MergeAndValidatePrintTicket該方法建立PrintTicketPrintQueue特定且適用於指定印表機的方法。

public:
 override void Write(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket);

public override void Write(System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedPage * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (fixedPage As FixedPage, printTicket As PrintTicket)

參數

備註

此方法不會驗證或修改特定 printTicket的指定PrintQueue值。 如有必要，使用MergeAndValidatePrintTicket該方法建立PrintTicketPrintQueue特定且適用於指定印表機的方法。

public:
 override void Write(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket);

public override void Write(System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket)

參數

備註

雖然類別 XpsDocument 名稱單一，但 an XpsDocument 可以是一份 FixedDocument 文件或多份文件集合。 此方法會在現有元素集中加入一 FixedDocument 組或一組 FixedDocument 元素。

此方法不會驗證或修改特定 printTicket的指定PrintQueue值。 如有必要，使用MergeAndValidatePrintTicket該方法建立PrintTicketPrintQueue特定且適用於指定印表機的方法。

public:
 override void Write(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket);

public override void Write(System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (fixedDocument As FixedDocument, printTicket As PrintTicket)

參數

備註

雖然類別 XpsDocument 名稱單一，但 an XpsDocument 可以是一份 FixedDocument 文件或多份文件集合。 此方法將 a FixedDocument 加入集合。

此方法不會驗證或修改特定 printTicket的指定PrintQueue值。 如有必要，使用MergeAndValidatePrintTicket該方法建立PrintTicketPrintQueue特定且適用於指定印表機的方法。

public:
 void Write(System::String ^ documentPath, System::Windows::Xps::XpsDocumentNotificationLevel notificationLevel);

public void Write(string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);

override this.Write : string * System.Windows.Xps.XpsDocumentNotificationLevel -> unit

Public Sub Write (documentPath As String, notificationLevel As XpsDocumentNotificationLevel)

參數

備註

當 notificationLevel 被停用時，會 XpsDocumentWriter 將序列化的 XPS 文件複製到目標 XpsDocument 或 PrintQueue 建立 XpsDocumentWriter的 。 啟用時 notificationLevel ，先將 XpsDocumentWriter 文件反序列化，接著重新序列化，然後在每頁輸出時寫入目標並發送進度通知。

雖然類別 XpsDocument 名稱單一，但 an XpsDocument 可以是一份 FixedDocument 文件或多份文件集合。 此方法將FixedDocument來源中的元素加入目標FixedDocument或 XpsDocument的元素序列PrintQueue中。

若 notificationLevel 指定為 ReceiveNotificationEnabled，則僅在文件序列化時產生通知，而非列印。 要接收通知，文件必須重新序列化。 當文件被重新序列化時，所有 Package 不需要依 XML 紙張規範（XPS ）保留的內容都會被移除。 重新序列化也會移除標記中的所有擴充功能 FixedPage ，包括任何擴充的 XPS 內容。

若 notificationLevel 指定為 ReceiveNotificationDisabled ，文件將不會重新序列化，且任何延伸內容即使列印後也會被保留。

此方法設計Write上不會呼叫事件。WritingPrintTicketRequired

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket);

public override void Write(System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);

override this.Write : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket -> unit

Public Overrides Sub Write (documentPaginator As DocumentPaginator, printTicket As PrintTicket)

參數

備註

此方法不會驗證或修改特定 printTicket的指定PrintQueue值。 如有必要，使用MergeAndValidatePrintTicket該方法建立PrintTicketPrintQueue特定且適用於指定印表機的方法。

public:
 override void Write(System::Windows::Documents::FixedPage ^ fixedPage);

public override void Write(System.Windows.Documents.FixedPage fixedPage);

override this.Write : System.Windows.Documents.FixedPage -> unit

Public Overrides Sub Write (fixedPage As FixedPage)

參數

public:
 override void Write(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence);

public override void Write(System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence);

override this.Write : System.Windows.Documents.FixedDocumentSequence -> unit

Public Overrides Sub Write (fixedDocumentSequence As FixedDocumentSequence)

參數

範例

以下範例展示了如何使用此 Write 方法撰寫一連串 XPS 文件。

private void SaveMultipleFixedContentDocuments(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    // Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(fds);
}

Private Sub SaveMultipleFixedContentDocuments(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    ' Write the FixedDocumentSequence as a collection of documents
    xpsdw.Write(fds)
End Sub

備註

雖然類別 XpsDocument 名稱單一，但 an XpsDocument 可以是一份 FixedDocument 文件或多份文件集合。 此方法會在現有元素集中加入一 FixedDocument 組或一組 FixedDocument 元素。

public:
 override void Write(System::Windows::Documents::FixedDocument ^ fixedDocument);

public override void Write(System.Windows.Documents.FixedDocument fixedDocument);

override this.Write : System.Windows.Documents.FixedDocument -> unit

Public Overrides Sub Write (fixedDocument As FixedDocument)

參數

範例

以下範例說明如何使用此方法寫入 XPS 文件。

private void SaveSingleFixedContentDocument(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    xpsdw.Write(fd);        // Write the FixedDocument as a document.
}

Private Sub SaveSingleFixedContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    xpsdw.Write(fd) ' Write the FixedDocument as a document.
End Sub

備註

雖然類別 XpsDocument 名稱單一，但 an XpsDocument 可以是一份 FixedDocument 文件或多份文件集合。 此方法將 a FixedDocument 加入集合。

public:
 override void Write(System::Windows::Documents::DocumentPaginator ^ documentPaginator);

public override void Write(System.Windows.Documents.DocumentPaginator documentPaginator);

override this.Write : System.Windows.Documents.DocumentPaginator -> unit

Public Overrides Sub Write (documentPaginator As DocumentPaginator)

參數

範例

以下範例說明如何使用此 Write 方法寫入 XPS 文件。

private void SaveSingleFlowContentDocument(
             XpsDocumentWriter xpsdw, DocumentPaginator docPaginator)
{
    xpsdw.Write(docPaginator); // Write the DocPaginator as a document.
}

Private Sub SaveSingleFlowContentDocument(ByVal xpsdw As XpsDocumentWriter, ByVal docPaginator As DocumentPaginator)
    xpsdw.Write(docPaginator) ' Write the DocPaginator as a document.
End Sub

public:
 void Write(System::String ^ documentPath);

public void Write(string documentPath);

override this.Write : string -> unit

Public Sub Write (documentPath As String)

參數

備註

雖然類別 XpsDocumentWriter 名稱單一，但 an XpsDocumentWriter 可以是一份 FixedDocument 文件或多份文件集合。 此方法將FixedDocument來源中的元素加入目標FixedDocument或 XpsDocumentWriter的元素集合PrintQueue。

此Write方法會重新序列化指定的 XPS 文件，移除所有非 Package要求保留的內容。 重新序列化同時移除標記中的所有擴充， FixedPage 包括任何擴充的 XPS 內容。

設計上，此Write方法不會提升事件。WritingPrintTicketRequired

public:
 override void Write(System::Windows::Media::Visual ^ visual);

public override void Write(System.Windows.Media.Visual visual);

override this.Write : System.Windows.Media.Visual -> unit

Public Overrides Sub Write (visual As Visual)

參數

範例

以下範例展示了如何使用 Write 該方法將 a Visual 寫入 XPS 文件。

private void SaveVisual(XpsDocumentWriter xpsdw, Visual v)
{
    xpsdw.Write(v); // Write visual to single page
}

Private Sub SaveVisual(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    xpsdw.Write(v) ' Write visual to single page
End Sub

備註

批次寫入 Visual時，請使用 VisualsToXpsDocument。