DataRequest Класс

Определение

Пространство имен:

Windows.ApplicationModel.DataTransfer

Позволяет приложению предоставлять содержимое, которым пользователь хочет поделиться, или указать сообщение, если возникает ошибка.

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

Наследование

Object Platform::Object IInspectable DataRequest

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем коде показано, как использовать объект DataRequest в рамках настройки данных в DataPackage для совместного использования с другим приложением.

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

Комментарии

Приложение получает объект DataRequest при возникновении события datarequested . С помощью этого объекта ваше приложение может предоставлять данные целевому приложению с помощью объекта DataPackage , использовать объект deferral для вызова функции или информировать целевое приложение о возникновении ошибки.

Свойства

Data	Задает или получает объект DataPackage , содержащий содержимое, которым пользователь хочет поделиться.
Deadline	Возвращает крайний срок завершения отложенной операции отрисовки. Если выполнение выходит за пределы этого крайнего срока, результаты отложенной отрисовки игнорируются.

Методы

FailWithDisplayText(String)	Отменяет операцию совместного использования и предоставляет пользователю строку ошибки для отображения.
GetDeferral()	Поддерживает асинхронные операции совместного использования путем создания и возврата объекта DataRequestDeferral .