XpsDocumentWriter.Write 方法

參考

定義

命名空間:: System.Windows.Xps

組件:: System.Printing.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

Write(Visual, PrintTicket)	以同步方式將指定的 Visual 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。
Write(FixedPage, PrintTicket)	以同步方式將指定的 FixedPage 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。
Write(FixedDocumentSequence, PrintTicket)	以同步方式將指定的 FixedDocumentSequence 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。
Write(FixedDocument, PrintTicket)	以同步方式將 FixedDocument 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。
Write(String, XpsDocumentNotificationLevel)	將指定的 XPS 檔同步寫入目標 XpsDocument 或 PrintQueue 。
Write(DocumentPaginator, PrintTicket)	從指定的 DocumentPaginator，將分頁內容連同 PrintTicket 以同步方式寫入目標 XpsDocument 或 PrintQueue。
Write(FixedPage)	以同步方式將指定的 FixedPage 寫入目標 XpsDocument 或 PrintQueue。
Write(FixedDocumentSequence)	以同步方式將指定的 FixedDocumentSequence 寫入目標 XpsDocument 或 PrintQueue。
Write(FixedDocument)	以同步方式將指定的 FixedDocument 寫入目標 XpsDocument 或 PrintQueue。
Write(DocumentPaginator)	從指定的 DocumentPaginator，將分頁內容以同步方式寫入目標 XpsDocument 或 PrintQueue。
Write(String)	將指定的 XPS 文件同步寫入至目標 XpsDocument 或 PrintQueue。
Write(Visual)	以同步方式將指定的 Visual 寫入目標 XpsDocument 或 PrintQueue。

Write(Visual, PrintTicket)

以同步方式將指定的 Visual 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。

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: Visual

寫入的 Visual。

printTicket: PrintTicket

PrintTicket，代表文件的預設列印喜好設定。

備註

若要批次寫入 Visual ，請使用 VisualsToXpsDocument 。

這個方法不會驗證或修改為特定 PrintQueue 指定的 printTicket 。如有必要，請使用 MergeAndValidatePrintTicket 方法來建立專屬的 PrintQueue ， PrintTicket 並且對指定的印表機有效。

適用於

Write(FixedPage, PrintTicket)

以同步方式將指定的 FixedPage 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedPage: FixedPage

寫入的頁面。

printTicket: PrintTicket

PrintTicket，表示頁面的預設列印喜好設定。

備註

適用於

Write(FixedDocumentSequence, PrintTicket)

以同步方式將指定的 FixedDocumentSequence 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedDocumentSequence: FixedDocumentSequence

寫入的文件集。

printTicket: PrintTicket

PrintTicket，代表文件集的預設列印喜好設定。

備註

雖然類別 XpsDocument 具有單一名稱，但 XpsDocument 可以是一 FixedDocument 或一組多個檔。這個方法會將或一組 FixedDocument 專案加入 FixedDocument 至現有的集合。

適用於

Write(FixedDocument, PrintTicket)

以同步方式將 FixedDocument 連同 PrintTicket 一起寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedDocument: FixedDocument

寫入的文件。

printTicket: PrintTicket

PrintTicket，代表文件的預設列印喜好設定。

備註

雖然類別 XpsDocument 具有單一名稱，但 XpsDocument 可以是一 FixedDocument 或一組多個檔。這個方法會將 FixedDocument 新增至集合。

適用於

Write(String, XpsDocumentNotificationLevel)

將指定的 XPS 檔同步寫入目標 XpsDocument 或 PrintQueue 。

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)

參數

documentPath: String

來源文件的路徑。

notificationLevel: XpsDocumentNotificationLevel

指出是否啟用通知。

備註

停用時 notificationLevel ，會將 XpsDocumentWriter serializedXPS 檔案複製到目標 XpsDocument 或 PrintQueue 建立的目標 XpsDocumentWriter 。啟用時 notificationLevel ，第 XpsDocumentWriter 一次還原序列化檔，接著重新序列化檔，然後將它寫入目標，並在每個頁面輸出時，使用進度通知將其寫入目標。

雖然類別 XpsDocument 具有單一名稱，但 XpsDocument 可以是一 FixedDocument 或一組多個檔。這個方法會將 FixedDocument 來源中的專案新增至目標 XpsDocument 或 PrintQueue 中的專案序列 FixedDocument 。

如果 notificationLevel 指定為 ReceiveNotificationEnabled ，則只有在檔序列化時才會產生通知，而不會列印。若要接收通知，您必須重新序列化檔。重新序列化檔時，XML 紙張規格 (XPS) 不需要保留的所有內容 Package 。重新序列化也會移除 FixedPage 標記中的所有延伸，包括任何擴充的 XPS 內容。

如果 notificationLevel 指定為 ReceiveNotificationDisabled 檔，則不會重新序列化，而且即使列印時也會保留任何擴充內容。

根據設計，此方法 Write 不會呼叫 WritingPrintTicketRequired 事件。

適用於

Write(DocumentPaginator, PrintTicket)

從指定的 DocumentPaginator，將分頁內容連同 PrintTicket 以同步方式寫入目標 XpsDocument 或 PrintQueue。

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)

參數

documentPaginator: DocumentPaginator

包含未分頁來源資料指標，也包含資料分頁方法的物件。

printTicket: PrintTicket

代表材質之預設列印喜好設定的 PrintTicket。

備註

適用於

Write(FixedPage)

以同步方式將指定的 FixedPage 寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedPage: FixedPage

要寫入 XpsDocument 的頁面。

適用於

Write(FixedDocumentSequence)

以同步方式將指定的 FixedDocumentSequence 寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedDocumentSequence: FixedDocumentSequence

寫入 XpsDocument 的文件集。

範例

下列範例示範如何使用 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

備註

適用於

Write(FixedDocument)

以同步方式將指定的 FixedDocument 寫入目標 XpsDocument 或 PrintQueue。

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)

參數

fixedDocument: FixedDocument

要寫入 XpsDocument 的文件。

範例

下列範例示範如何使用這個方法來寫入 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 具有單一名稱，但 XpsDocument 可以是一 FixedDocument 或一組多個檔。這個方法會將 FixedDocument 新增至集合。

適用於

Write(DocumentPaginator)

從指定的 DocumentPaginator，將分頁內容以同步方式寫入目標 XpsDocument 或 PrintQueue。

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)

參數

documentPaginator: 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

適用於

Write(String)

將指定的 XPS 文件同步寫入至目標 XpsDocument 或 PrintQueue。

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

public void Write (string documentPath);

override this.Write : string -> unit

Public Sub Write (documentPath As String)

參數

documentPath: String

來源文件的路徑。

備註

雖然類別 XpsDocumentWriter 具有單一名稱，但 XpsDocumentWriter 可以是一 FixedDocument 或一組多個檔。這個方法會將 FixedDocument 來源中的專案新增至目標或 PrintQueue 中的專案 XpsDocumentWriter 集 FixedDocument 。

這個 Write 方法會重新序列化指定的 XPS 檔，這會移除 Package XML 紙張規格不需要保留之的所有內容。重新序列化也會移除 FixedPage 標記中的所有延伸，包括任何擴充的 XPS 內容。

根據設計，此方法 Write 不會引發 WritingPrintTicketRequired 事件。

適用於

Write(Visual)

以同步方式將指定的 Visual 寫入目標 XpsDocument 或 PrintQueue。

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)

參數

visual: Visual