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


XpsDocumentWriter.WriteAsync Метод

Определение

Выполняет асинхронную запись в объект XpsDocument или PrintQueue, созданный XpsDocumentWriter.

Перегрузки

WriteAsync(FixedPage, Object)

Асинхронно записывает указанный FixedPage в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedPage, PrintTicket)

Асинхронно записывает заданный объект FixedPage вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(Visual, Object)

Асинхронно записывает указанный Visual в целевой объект XpsDocument или PrintQueue.

WriteAsync(Visual, PrintTicket)

Асинхронно записывает заданный объект Visual вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Асинхронно записывает заданный объект FixedDocumentSequence вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(FixedDocument, PrintTicket, Object)

Асинхронно записывает заданный объект FixedDocument вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(FixedPage, PrintTicket, Object)

Асинхронно записывает заданный объект FixedPage вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(Visual, PrintTicket, Object)

Асинхронно записывает заданный объект Visual вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(FixedDocumentSequence, PrintTicket)

Асинхронно записывает заданный объект FixedDocumentSequence вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket, Object)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator с PrintTicket в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedDocumentSequence, Object)

Асинхронно записывает указанный FixedDocumentSequence в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedDocumentSequence)

Асинхронно записывает указанный FixedDocumentSequence в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedDocument, Object)

Асинхронно записывает указанный FixedDocument в целевой объект XpsDocument или PrintQueue.

WriteAsync(DocumentPaginator, PrintTicket)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator с PrintTicket в целевой объект XpsDocument или PrintQueue.

WriteAsync(DocumentPaginator, Object)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator в целевой объект XpsDocument или PrintQueue.

WriteAsync(String, XpsDocumentNotificationLevel)

Асинхронно записывает указанный документ XPS с параметром уведомления в целевой XpsDocument объект или PrintQueue.

WriteAsync(Visual)

Асинхронно записывает указанный Visual в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedPage)

Асинхронно записывает указанный FixedPage в целевой объект XpsDocument или PrintQueue.

WriteAsync(FixedDocument)

Асинхронно записывает указанный FixedDocument в целевой объект XpsDocument или PrintQueue.

WriteAsync(DocumentPaginator)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator в целевой объект XpsDocument или PrintQueue.

WriteAsync(String)

Асинхронно записывает указанный документ XPS в целевой XpsDocument объект или PrintQueue.

WriteAsync(FixedDocument, PrintTicket)

Асинхронно записывает заданный объект FixedDocument вместе с PrintTicket в целевой XpsDocument или PrintQueue.

WriteAsync(FixedPage, Object)

Асинхронно записывает указанный FixedPage в целевой объект XpsDocument или PrintQueue.

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)

Параметры

fixedPage
FixedPage

Записываемая страница.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

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

WriteAsync(FixedPage, PrintTicket)

Асинхронно записывает заданный объект FixedPage вместе с PrintTicket в целевой XpsDocument или PrintQueue.

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)

Параметры

fixedPage
FixedPage

Записываемая страница.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для страницы.

Комментарии

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

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

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

WriteAsync(Visual, Object)

Асинхронно записывает указанный Visual в целевой объект XpsDocument или PrintQueue.

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
Visual

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

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

WriteAsync(Visual, PrintTicket)

Асинхронно записывает заданный объект Visual вместе с PrintTicket в целевой XpsDocument или PrintQueue.

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
Visual

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

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для документа.

Комментарии

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

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

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

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

WriteAsync(FixedDocumentSequence, PrintTicket, Object)

Асинхронно записывает заданный объект FixedDocumentSequence вместе с PrintTicket в целевой XpsDocument или PrintQueue.

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)

Параметры

fixedDocumentSequence
FixedDocumentSequence

Записываемый набор документов.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для набора документов.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

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

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

WriteAsync(FixedDocument, PrintTicket, Object)

Асинхронно записывает заданный объект FixedDocument вместе с PrintTicket в целевой XpsDocument или 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)

Параметры

fixedDocument
FixedDocument

Записываемый документ.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для документа.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

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

WriteAsync(FixedPage, PrintTicket, Object)

Асинхронно записывает заданный объект FixedPage вместе с PrintTicket в целевой XpsDocument или 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)

Параметры

fixedPage
FixedPage

Записываемая страница.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для страницы.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

WriteAsync(Visual, PrintTicket, Object)

Асинхронно записывает заданный объект Visual вместе с PrintTicket в целевой XpsDocument или 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
Visual

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

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для документа.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

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

WriteAsync(FixedDocumentSequence, PrintTicket)

Асинхронно записывает заданный объект FixedDocumentSequence вместе с PrintTicket в целевой XpsDocument или 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)

Параметры

fixedDocumentSequence
FixedDocumentSequence

Записываемый набор документов.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для набора документов.

Комментарии

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

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

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

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

WriteAsync(DocumentPaginator, PrintTicket, Object)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator с PrintTicket в целевой объект XpsDocument или PrintQueue.

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)

Параметры

documentPaginator
DocumentPaginator

Объект, который содержит указатель на не разбитый на страницы исходный материал; также содержит методы для разбивки материала на страницы.

printTicket
PrintTicket

Объект PrintTicket, который представляет параметры печати по умолчанию для материала.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

WriteAsync(FixedDocumentSequence, Object)

Асинхронно записывает указанный FixedDocumentSequence в целевой объект XpsDocument или 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)

Параметры

fixedDocumentSequence
FixedDocumentSequence

Записываемый набор документов.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

WriteAsync(FixedDocumentSequence)

Асинхронно записывает указанный FixedDocumentSequence в целевой объект XpsDocument или PrintQueue.

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)

Параметры

fixedDocumentSequence
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).

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

WriteAsync(FixedDocument, Object)

Асинхронно записывает указанный FixedDocument в целевой объект XpsDocument или PrintQueue.

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)

Параметры

fixedDocument
FixedDocument

Записываемый документ.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

Комментарии

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

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

WriteAsync(DocumentPaginator, PrintTicket)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator с PrintTicket в целевой объект XpsDocument или PrintQueue.

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)

Параметры

documentPaginator
DocumentPaginator

Объект, который содержит указатель на не разбитый на страницы исходный материал, а также содержит методы для разбивки материала на страницы.

printTicket
PrintTicket

Объект PrintTicket, который представляет параметры печати по умолчанию для материала.

Комментарии

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

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

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

WriteAsync(DocumentPaginator, Object)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator в целевой объект XpsDocument или PrintQueue.

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)

Параметры

documentPaginator
DocumentPaginator

Объект, который содержит указатель на не разбитый на страницы исходный материал; также содержит методы для разбивки материала на страницы.

userSuppliedState
Object

Заданный пользователем объект для идентификации асинхронной операции и связывания с ней.

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

WriteAsync(String, XpsDocumentNotificationLevel)

Асинхронно записывает указанный документ XPS с параметром уведомления в целевой XpsDocument объект или PrintQueue.

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)

Параметры

documentPath
String

Путь к исходному документу.

notificationLevel
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).

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

WriteAsync(Visual)

Асинхронно записывает указанный Visual в целевой объект XpsDocument или PrintQueue.

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
Visual

Объект 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).

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

WriteAsync(FixedPage)

Асинхронно записывает указанный FixedPage в целевой объект XpsDocument или PrintQueue.

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)

Параметры

fixedPage
FixedPage

Записываемая страница.

Комментарии

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

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

WriteAsync(FixedDocument)

Асинхронно записывает указанный FixedDocument в целевой объект XpsDocument или PrintQueue.

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)

Параметры

fixedDocument
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).

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

WriteAsync(DocumentPaginator)

Асинхронно записывает разбитое на страницы содержимое из указанного объекта DocumentPaginator в целевой объект XpsDocument или PrintQueue.

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)

Параметры

documentPaginator
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).

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

WriteAsync(String)

Асинхронно записывает указанный документ XPS в целевой XpsDocument объект или PrintQueue.

public:
 void WriteAsync(System::String ^ documentPath);
public void WriteAsync (string documentPath);
override this.WriteAsync : string -> unit
Public Sub WriteAsync (documentPath As String)

Параметры

documentPath
String

Путь к исходному документу.

Комментарии

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

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

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

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

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

WriteAsync(FixedDocument, PrintTicket)

Асинхронно записывает заданный объект FixedDocument вместе с PrintTicket в целевой XpsDocument или PrintQueue.

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)

Параметры

fixedDocument
FixedDocument

Записываемый документ.

printTicket
PrintTicket

Объект PrintTicket, представляющий параметры печати по умолчанию для документа.

Комментарии

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

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

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

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