DataRequest.Data Свойство

Определение

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

Windows.ApplicationModel.DataTransfer

Задает или получает объект DataPackage , содержащий содержимое, которым пользователь хочет поделиться.

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

Значение свойства

DataPackage

Содержит содержимое, которым пользователь хочет поделиться.

Примеры

В следующем коде показано, как получить объект DataPackage из свойства Data в рамках настройки данных в 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!");
}

Комментарии

Свойство Data позволяет приложению предоставлять данные в целевое приложение. Приложение должно предоставлять эти данные с помощью объекта DataPackage .

Используйте это свойство, если в приложении сразу же будет доступно содержимое, которым пользователь хочет поделиться. Если необходимо вызвать функцию для создания DataPackage, используйте метод GetDeferral .

Если приложение не может предоставить объект DataPackage , используйте метод FailWithDisplayText , чтобы отменить общий ресурс и предоставить пользователю сообщение, которое целевое приложение может отобразить.