Поделиться через


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)

Параметры

visual
Visual

Объект Visual, в который осуществляется запись.

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)

Параметры

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

Применяется к