DataRequest Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

Permite que la aplicación proporcione el contenido que el usuario quiere compartir o especificar un mensaje, si se produce un error.

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

Herencia

Object Platform::Object IInspectable DataRequest

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el código siguiente se muestra cómo usar el objeto DataRequest como parte del establecimiento de 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 aplicación recibe un objeto DataRequest cuando se produce un evento datarequested . Con este objeto, la aplicación puede proporcionar datos a una aplicación de destino mediante un objeto DataPackage , usar un objeto de aplazamiento para llamar a una función o informar a la aplicación de destino de que se produjo un error.

Propiedades

Data	Establece u obtiene un objeto DataPackage que contiene el contenido que un usuario quiere compartir.
Deadline	Obtiene la fecha límite para finalizar una operación de representación retrasada. Si la ejecución va más allá de esa fecha límite, se omiten los resultados de la representación retrasada.

Métodos

FailWithDisplayText(String)	Cancela la operación de uso compartido y proporciona una cadena de error para mostrar al usuario.
GetDeferral()	Admite operaciones de uso compartido asincrónico mediante la creación y devolución de un objeto DataRequestDeferral .