DataRequest.Data Propriedade

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Define ou obtém um objeto DataPackage que contém o conteúdo que um usuário deseja compartilhar.

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

Valor da propriedade

DataPackage

Contém o conteúdo que um usuário deseja compartilhar.

Exemplos

O código a seguir mostra como obter um objeto DataPackage da propriedade Data como parte da configuração dos dados em um DataPackage para compartilhar com outro aplicativo.

//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!");
}

Comentários

A propriedade Data permite que seu aplicativo forneça dados para um aplicativo de destino. Seu aplicativo deve fornecer esses dados usando um objeto DataPackage .

Use essa propriedade quando seu aplicativo tiver o conteúdo imediatamente disponível que o usuário deseja compartilhar. Se você precisar chamar uma função para gerar o DataPackage, use o método GetDeferral .

Quando o aplicativo não puder fornecer um objeto DataPackage , use o método FailWithDisplayText para cancelar o compartilhamento e fornecer uma mensagem que o aplicativo de destino pode exibir para o usuário.