DataRequest.Data Propiedad

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

Establece u obtiene un objeto DataPackage que contiene el contenido que un usuario quiere compartir.

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 de propiedad

DataPackage

Contiene el contenido que un usuario quiere compartir.

Ejemplos

En el código siguiente se muestra cómo obtener un objeto DataPackage de la propiedad Data como parte de establecer los datos en un DataPackage para compartirlos con otra aplicación.

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

Comentarios

La propiedad Data permite que la aplicación proporcione datos a una aplicación de destino. La aplicación debe proporcionar estos datos mediante un objeto DataPackage .

Use esta propiedad cuando la aplicación tenga el contenido disponible inmediatamente que el usuario quiere compartir. Si necesita llamar a una función para generar el DataPackage, use el método GetDeferral .

Cuando la aplicación no puede proporcionar un objeto DataPackage , use el método FailWithDisplayText para cancelar el recurso compartido y proporcione un mensaje que la aplicación de destino pueda mostrar al usuario.