DataRequest.GetDeferral Método

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Dá suporte a operações de compartilhamento assíncronas criando e retornando um objeto DataRequestDeferral .

public:
 virtual DataRequestDeferral ^ GetDeferral() = GetDeferral;

DataRequestDeferral GetDeferral();

public DataRequestDeferral GetDeferral();

function getDeferral()

Public Function GetDeferral () As DataRequestDeferral

Retornos

DataRequestDeferral

Um objeto que permite compartilhar ou enviar conteúdo de forma assíncrona.

Exemplos

O exemplo a seguir mostra como obter um objeto DataRequestDeferral usando o método GetDeferral .

void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequestDeferral deferral = e.Request.GetDeferral();
    e.Request.Data.Properties.Title = "Hello World!";
    e.Request.Data.Properties.Description = "This example shows how to share files and images.";
    if (this.dataPackageThumbnail != null)
    {
        e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
    }
    e.Request.Data.SetBitmap(imageStreamRef);
    deferral.Complete();
}

Comentários

O método GetDeferral permite que seu aplicativo chame uma função durante uma operação de compartilhamento, para que seu aplicativo possa gerar de forma assíncrona o objeto DataPackage para o aplicativo de destino.

Use esse método quando quiser usar uma chamada de função assíncrona para gerar o DataPackage durante uma operação de compartilhamento. Essa função deve retornar um objeto DataPackage dentro de 200ms para impedir que a operação atinja o tempo limite. Se seu aplicativo compartilhar conteúdo que leva mais tempo para empacotar, como uma coleção de arquivos ou fotos, não use esse método. Em vez disso, use o método SetDataProvider para atribuir um delegado a um DataPackage e retornar esse DataPackage ao aplicativo de destino.