共用方式為


XpsDocumentWriter.Write 方法

定義

多載

Write(Visual, PrintTicket)

以同步方式將指定的 Visual 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

Write(FixedPage, PrintTicket)

以同步方式將指定的 FixedPage 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

Write(FixedDocumentSequence, PrintTicket)

以同步方式將指定的 FixedDocumentSequence 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

Write(FixedDocument, PrintTicket)

以同步方式將 FixedDocument 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

Write(String, XpsDocumentNotificationLevel)

將指定的 XPS 檔同步寫入目標 XpsDocumentPrintQueue

Write(DocumentPaginator, PrintTicket)

從指定的 DocumentPaginator,將分頁內容連同 PrintTicket 以同步方式寫入目標 XpsDocumentPrintQueue

Write(FixedPage)

以同步方式將指定的 FixedPage 寫入目標 XpsDocumentPrintQueue

Write(FixedDocumentSequence)

以同步方式將指定的 FixedDocumentSequence 寫入目標 XpsDocumentPrintQueue

Write(FixedDocument)

以同步方式將指定的 FixedDocument 寫入目標 XpsDocumentPrintQueue

Write(DocumentPaginator)

從指定的 DocumentPaginator,將分頁內容以同步方式寫入目標 XpsDocumentPrintQueue

Write(String)

將指定的 XPS 文件同步寫入至目標 XpsDocumentPrintQueue

Write(Visual)

以同步方式將指定的 Visual 寫入目標 XpsDocumentPrintQueue

Write(Visual, PrintTicket)

以同步方式將指定的 Visual 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

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 方法來建立 專屬的 PrintQueuePrintTicket 並且對指定的印表機有效。

適用於

Write(FixedPage, PrintTicket)

以同步方式將指定的 FixedPage 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

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,表示頁面的預設列印喜好設定。

備註

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

適用於

Write(FixedDocumentSequence, PrintTicket)

以同步方式將指定的 FixedDocumentSequence 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

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 至現有的集合。

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

適用於

Write(FixedDocument, PrintTicket)

以同步方式將 FixedDocument 連同 PrintTicket 一起寫入目標 XpsDocumentPrintQueue

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 新增至集合。

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

適用於

Write(String, XpsDocumentNotificationLevel)

將指定的 XPS 檔同步寫入目標 XpsDocumentPrintQueue

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 檔案複製到目標 XpsDocumentPrintQueue 建立 的目標 XpsDocumentWriter 。 啟用時 notificationLevel ,第 XpsDocumentWriter 一次還原序列化檔,接著重新序列化檔,然後將它寫入目標,並在每個頁面輸出時,使用進度通知將其寫入目標。

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

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

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

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

適用於

Write(DocumentPaginator, PrintTicket)

從指定的 DocumentPaginator,將分頁內容連同 PrintTicket 以同步方式寫入目標 XpsDocumentPrintQueue

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

備註

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

適用於

Write(FixedPage)

以同步方式將指定的 FixedPage 寫入目標 XpsDocumentPrintQueue

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 寫入目標 XpsDocumentPrintQueue

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

備註

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

適用於

Write(FixedDocument)

以同步方式將指定的 FixedDocument 寫入目標 XpsDocumentPrintQueue

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,將分頁內容以同步方式寫入目標 XpsDocumentPrintQueue

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 文件同步寫入至目標 XpsDocumentPrintQueue

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 中的專案 XpsDocumentWriterFixedDocument

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

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

適用於

Write(Visual)

以同步方式將指定的 Visual 寫入目標 XpsDocumentPrintQueue

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

寫入的 Visual

範例

下列範例示範如何使用 Write 方法將 寫入 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

適用於