XpsDocumentWriter.WriteAsync Метод

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedPage * obj -> unit

Public Overrides Sub WriteAsync (fixedPage As FixedPage, userSuppliedState As Object)

Параметры

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket);

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket);

override this.WriteAsync : System.Windows.Documents.FixedPage * System.Printing.PrintTicket -> unit

Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket)

Параметры

Комментарии

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedPage, PrintTicket).

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Media.Visual visual, object userSuppliedState);

override this.WriteAsync : System.Windows.Media.Visual * obj -> unit

Public Overrides Sub WriteAsync (visual As Visual, userSuppliedState As Object)

Параметры

Комментарии

Для пакетной записи используйте Visual.VisualsToXpsDocument

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket);

public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket);

override this.WriteAsync : System.Windows.Media.Visual * System.Printing.PrintTicket -> unit

Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket)

Параметры

Комментарии

Для пакетной записи используйте Visual.VisualsToXpsDocument

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(Visual, PrintTicket).

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket * obj -> unit

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket, userSuppliedState As Object)

Параметры

Комментарии

WriteAsync асинхронно записывает набор документов в XpsDocument или PrintQueue , создавший XpsDocumentWriter. Записанные данные включают PrintTicket и дополнительные сведения, которые вызывающий объект хочет передать обработчику событий.

Хотя класс имеет единственное XpsDocument имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет или FixedDocument набор FixedDocument элементов в существующую последовательность.

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket * obj -> unit

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket, userSuppliedState As Object)

Параметры

Комментарии

Хотя класс имеет единственное XpsDocument имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет в FixedDocument набор .

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage, System.Printing.PrintTicket printTicket, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedPage * System.Printing.PrintTicket * obj -> unit

Public Overrides Sub WriteAsync (fixedPage As FixedPage, printTicket As PrintTicket, userSuppliedState As Object)

Параметры

Комментарии

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Media.Visual visual, System.Printing.PrintTicket printTicket, object userSuppliedState);

override this.WriteAsync : System.Windows.Media.Visual * System.Printing.PrintTicket * obj -> unit

Public Overrides Sub WriteAsync (visual As Visual, printTicket As PrintTicket, userSuppliedState As Object)

Параметры

Комментарии

Для записи нескольких Visual элементов используйте .VisualsToXpsDocument

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , специфичный для PrintQueue и допустимый для указанного принтера.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Printing::PrintTicket ^ printTicket);

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, System.Printing.PrintTicket printTicket);

override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * System.Printing.PrintTicket -> unit

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, printTicket As PrintTicket)

Параметры

Комментарии

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет или FixedDocument набор FixedDocument элементов к существующему набору.

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , специфичный для PrintQueue и допустимый для указанного принтера.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedDocumentSequence, PrintTicket).

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket * obj -> unit

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket, userSuppliedState As Object)

Параметры

Комментарии

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , специфичный для PrintQueue и допустимый для указанного принтера.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence * obj -> unit

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence, userSuppliedState As Object)

Параметры

Комментарии

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет или FixedDocument набор FixedDocument элементов к существующему набору.

public:
 override void WriteAsync(System::Windows::Documents::FixedDocumentSequence ^ fixedDocumentSequence);

public override void WriteAsync (System.Windows.Documents.FixedDocumentSequence fixedDocumentSequence);

override this.WriteAsync : System.Windows.Documents.FixedDocumentSequence -> unit

Public Overrides Sub WriteAsync (fixedDocumentSequence As FixedDocumentSequence)

Параметры

Примеры

В следующем примере показано, как использовать этот метод для записи в документ XPS.

private void SaveMultipleFixedContentDocumentsAsync(
             XpsDocumentWriter xpsdw, FixedDocumentSequence fds)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WritingProgressChanged +=
        new WritingProgressChangedEventHandler(AsyncSavingProgress);

    // Write the FixedDocumentSequence as a
    // collection of documents asynchronously.
    xpsdw.WriteAsync(fds);
}

Private Sub SaveMultipleFixedContentDocumentsAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fds As FixedDocumentSequence)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    AddHandler xpsdw.WritingProgressChanged, AddressOf AsyncSavingProgress

    ' Write the FixedDocumentSequence as a
    ' collection of documents asynchronously.
    xpsdw.WriteAsync(fds)
End Sub

Комментарии

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет или FixedDocument набор FixedDocument элементов к существующему набору.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedDocumentSequence).

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.FixedDocument * obj -> unit

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, userSuppliedState As Object)

Параметры

Комментарии

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет в FixedDocument набор .

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Printing::PrintTicket ^ printTicket);

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, System.Printing.PrintTicket printTicket);

override this.WriteAsync : System.Windows.Documents.DocumentPaginator * System.Printing.PrintTicket -> unit

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, printTicket As PrintTicket)

Параметры

Комментарии

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , специфичный для PrintQueue и допустимый для указанного принтера.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(DocumentPaginator, PrintTicket).

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator, System::Object ^ userSuppliedState);

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator, object userSuppliedState);

override this.WriteAsync : System.Windows.Documents.DocumentPaginator * obj -> unit

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator, userSuppliedState As Object)

Параметры

public:
 void WriteAsync(System::String ^ documentPath, System::Windows::Xps::XpsDocumentNotificationLevel notificationLevel);

public void WriteAsync (string documentPath, System.Windows.Xps.XpsDocumentNotificationLevel notificationLevel);

override this.WriteAsync : string * System.Windows.Xps.XpsDocumentNotificationLevel -> unit

Public Sub WriteAsync (documentPath As String, notificationLevel As XpsDocumentNotificationLevel)

Параметры

Комментарии

Если notificationLevel параметр отключен, XpsDocumentWriter компонент копирует сериализованный документ XPS в целевой XpsDocument объект или PrintQueue созданный XpsDocumentWriter. Если notificationLevel параметр включен, XpsDocumentWriter первый десериализует документ, затем повторно инициализирует его, а затем записывает в целевой объект с уведомлениями о ходе выполнения по мере вывода каждой страницы.

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет FixedDocument элементы в источнике в последовательность FixedDocument элементов в целевом XpsDocument объекте или PrintQueue.

Если notificationLevel параметр указан как ReceiveNotificationEnabled, уведомления создаются только при сериализации документа, а не печати. Чтобы получать уведомления, документ необходимо повторно инициализировать. При повторной инициализации документа удаляется все содержимое Package из , которое не требуется сохранять в спецификации XML-бумаги . Повторная инициализация также удаляет все расширения из разметки FixedPage , включая все расширенное содержимое XPS.

Если notificationLevel параметр указан как ReceiveNotificationDisabled , документ не будет повторно инициализирован, и все расширенное содержимое будет сохранено даже при печати.

По умолчанию этот WriteAsync метод не вызывает WritingPrintTicketRequired событие .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(String, XpsDocumentNotificationLevel).

public:
 override void WriteAsync(System::Windows::Media::Visual ^ visual);

public override void WriteAsync (System.Windows.Media.Visual visual);

override this.WriteAsync : System.Windows.Media.Visual -> unit

Public Overrides Sub WriteAsync (visual As Visual)

Параметры

Примеры

В следующем примере показано, как использовать этот метод для записи в Visual документ XPS.

private void SaveVisualAsync(XpsDocumentWriter xpsdw, Visual v)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    xpsdw.WriteAsync(v);    // Write visual to single page.
}

Private Sub SaveVisualAsync(ByVal xpsdw As XpsDocumentWriter, ByVal v As Visual)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    xpsdw.WriteAsync(v) ' Write visual to single page.
End Sub

Комментарии

Для пакетной записи используйте Visual.VisualsToXpsDocument

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(Visual).

public:
 override void WriteAsync(System::Windows::Documents::FixedPage ^ fixedPage);

public override void WriteAsync (System.Windows.Documents.FixedPage fixedPage);

override this.WriteAsync : System.Windows.Documents.FixedPage -> unit

Public Overrides Sub WriteAsync (fixedPage As FixedPage)

Параметры

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedPage).

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument);

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument);

override this.WriteAsync : System.Windows.Documents.FixedDocument -> unit

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument)

Параметры

Примеры

В следующем примере показано, как использовать этот метод для записи в документ XPS.

private void SaveSingleFixedContentDocumentAsync(
             XpsDocumentWriter xpsdw, FixedDocument fd)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd);
}

Private Sub SaveSingleFixedContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal fd As FixedDocument)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the FixedDocument as a document.
    xpsdw.WriteAsync(fd)
End Sub

Комментарии

Несмотря на то, XpsDocument что класс имеет единственное имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет в FixedDocument набор .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedDocument).

public:
 override void WriteAsync(System::Windows::Documents::DocumentPaginator ^ documentPaginator);

public override void WriteAsync (System.Windows.Documents.DocumentPaginator documentPaginator);

override this.WriteAsync : System.Windows.Documents.DocumentPaginator -> unit

Public Overrides Sub WriteAsync (documentPaginator As DocumentPaginator)

Параметры

Примеры

В следующем примере показано, как использовать этот метод для записи в документ XPS.

private void SaveSingleFlowContentDocumentAsync(
             XpsDocumentWriter xpsdw, DocumentPaginator idp)
{
    _xpsdwActive = xpsdw;

    xpsdw.WritingCompleted +=
        new WritingCompletedEventHandler(AsyncSaveCompleted);

    // Write the IDP as a document.
    xpsdw.WriteAsync(idp);
}

Private Sub SaveSingleFlowContentDocumentAsync(ByVal xpsdw As XpsDocumentWriter, ByVal idp As DocumentPaginator)
    _xpsdwActive = xpsdw

    AddHandler xpsdw.WritingCompleted, AddressOf AsyncSaveCompleted

    ' Write the IDP as a document.
    xpsdw.WriteAsync(idp)
End Sub

Комментарии

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(DocumentPaginator).

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

public void WriteAsync (string documentPath);

override this.WriteAsync : string -> unit

Public Sub WriteAsync (documentPath As String)

Параметры

Комментарии

Хотя класс имеет единственное XpsDocument имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет FixedDocument элементы в источнике в набор FixedDocument элементов в целевом объекте XpsDocument или PrintQueue.

Этот WriteAsync метод повторно инициализирует указанный документ XPS, который удаляет все содержимое Package из , которое не требуется сохранять в спецификации xml paper. При повторной инициализации также удаляются все расширения из разметки FixedPage , включая все расширенное содержимое XPS.

По умолчанию этот WriteAsync метод не вызывает WritingPrintTicketRequired событие .

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(String).

public:
 override void WriteAsync(System::Windows::Documents::FixedDocument ^ fixedDocument, System::Printing::PrintTicket ^ printTicket);

public override void WriteAsync (System.Windows.Documents.FixedDocument fixedDocument, System.Printing.PrintTicket printTicket);

override this.WriteAsync : System.Windows.Documents.FixedDocument * System.Printing.PrintTicket -> unit

Public Overrides Sub WriteAsync (fixedDocument As FixedDocument, printTicket As PrintTicket)

Параметры

Комментарии

Хотя класс имеет единственное XpsDocument имя, XpsDocument может быть одним FixedDocument или набором из нескольких документов. Этот метод добавляет в FixedDocument набор .

Этот метод не проверяет или не изменяет указанный printTicket для конкретного PrintQueueобъекта . При необходимости используйте MergeAndValidatePrintTicket метод , чтобы создать PrintTicket объект , относящееся к PrintQueue и допустимое для указанного принтера.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(FixedDocument, PrintTicket).