DataRequest Classe

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Permite que seu aplicativo forneça o conteúdo que o usuário deseja compartilhar ou especifique uma mensagem, se ocorrer um erro.

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

Herança

Object Platform::Object IInspectable DataRequest

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O código a seguir mostra como usar o objeto DataRequest 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

Seu aplicativo recebe um objeto DataRequest quando ocorre um evento datarequested . Com esse objeto, seu aplicativo pode fornecer dados para um aplicativo de destino usando um objeto DataPackage , usar um objeto de adiamento para chamar uma função ou informar ao aplicativo de destino que ocorreu um erro.

Propriedades

Data	Define ou obtém um objeto DataPackage que contém o conteúdo que um usuário deseja compartilhar.
Deadline	Obtém o prazo para concluir uma operação de renderização atrasada. Se a execução ultrapassar esse prazo, os resultados da renderização atrasada serão ignorados.

Métodos

FailWithDisplayText(String)	Cancela a operação de compartilhamento e fornece uma cadeia de caracteres de erro para exibir ao usuário.
GetDeferral()	Dá suporte a operações de compartilhamento assíncronas criando e retornando um objeto DataRequestDeferral .