XpsDocumentWriter.Write 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
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)
参数
- printTicket
- PrintTicket
一个 PrintTicket 表示文档的默认打印首选项。
注解
若要批处理写入, Visual请使用 VisualsToXpsDocument。
此方法不会验证或修改为特定printTicket指定的PrintQueue值。 如有必要,请使用 MergeAndValidatePrintTicket 该方法创建 PrintTicket 特定于 PrintQueue 指定的打印机且对指定的打印机有效。
适用于
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 表示页面的默认打印首选项。
注解
此方法不会验证或修改为特定printTicket指定的PrintQueue值。 如有必要,请使用 MergeAndValidatePrintTicket 该方法创建 PrintTicket 特定于 PrintQueue 指定的打印机且对指定的打印机有效。
适用于
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 元素添加到现有集。
此方法不会验证或修改为特定printTicket指定的PrintQueue值。 如有必要,请使用 MergeAndValidatePrintTicket 该方法创建 PrintTicket 特定于 PrintQueue 指定的打印机且对指定的打印机有效。
适用于
Write(FixedDocument, PrintTicket)
将同步写入 FixedDocument 目标 PrintTicketXpsDocumentPrintQueue或 .
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 。
此方法不会验证或修改为特定printTicket指定的PrintQueue值。 如有必要,请使用 MergeAndValidatePrintTicket 该方法创建 PrintTicket 特定于 PrintQueue 指定的打印机且对指定的打印机有效。
适用于
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源中的元素添加到目标FixedDocumentXpsDocument或元素序列PrintQueue中。
如果 notificationLevel 指定为 ReceiveNotificationEnabled,则仅在序列化文档时生成通知,而不是打印。 若要接收通知,必须重新序列化文档。 重新序列化文档时,将删除 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 表示材料的默认打印首选项。
注解
此方法不会验证或修改为特定printTicket指定的PrintQueue值。 如有必要,请使用 MergeAndValidatePrintTicket 该方法创建 PrintTicket 特定于 PrintQueue 指定的打印机且对指定的打印机有效。
适用于
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
注解
尽管该 XpsDocument 类具有单一名称, XpsDocument 但可以是一 FixedDocument 个或多个文档。 此方法将一 FixedDocument 组或一组 FixedDocument 元素添加到现有集。
适用于
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源中的元素添加到FixedDocument目标XpsDocumentWriterPrintQueue或 .
此方法 Write 重新序列化指定的 XPS 文档,该文档从 PackageXML 纸张规范不需要保留的所有内容中删除。
重新序列化还会从 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)
参数
示例
以下示例演示如何使用 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。