XpsDocumentWriter.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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)
Параметры
- 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 вместе с 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 набор .
Этот метод не проверяет или не изменяет указанный 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 элементы в источнике в последовательность FixedDocument элементов в целевом XpsDocument объекте или PrintQueue.
Если notificationLevel
параметр указан как ReceiveNotificationEnabled, уведомления создаются только при сериализации документа, а не печати. Чтобы получать уведомления, документ необходимо повторно инициализировать. При повторной инициализации документа удаляется все содержимое Package из , которое не требуется сохранять в спецификации XML-бумаги (XPS). Повторная инициализация также удалит все расширения из разметки 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 элементов в целевом XpsDocumentWriter объекте или PrintQueue.
Этот 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)
Параметры
Примеры
В следующем примере показано, как использовать 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