Compartilhar via


DataRequest Classe

Definição

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

Requisitos do Windows

Requisitos Description
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

Nome Description
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

Nome Description
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 .

Aplica-se a