DataTransferManager Classe

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Inicia programaticamente uma troca de conteúdo com outros aplicativos.

public ref class DataTransferManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTransferManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager

Public NotInheritable Class DataTransferManager

Herança

Object Platform::Object IInspectable DataTransferManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo mostra uma maneira típica de usar o objeto DataTransferManager .

function setupShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", function (e) {
        var request = e.request;
        request.data.properties.title = "Share Demonstration";
        request.data.setText("Hello World!");
    });
}

Comentários

A classe DataTransferManager é uma classe estática que você usa para iniciar operações de compartilhamento. Para usar a classe , primeiro chame o método GetForCurrentView . Esse método retorna o objeto DataTransferManager específico da janela ativa. Em seguida, você precisa adicionar um ouvinte de eventos para o evento datarequested ao objeto . Esse evento é acionado quando uma operação de compartilhamento é iniciada, normalmente quando o usuário toca no botão Compartilhar, embora também seja acionado se o aplicativo iniciar uma operação de compartilhamento programaticamente.

A classe DataTransferManager inclui um método ShowShareUI , que você pode usar para iniciar programaticamente uma operação de compartilhamento.

A classe DataTransferManager também tem um evento TargetApplicationChosen . Use esse evento quando quiser capturar quais aplicativos um usuário seleciona ao compartilhar conteúdo de seu aplicativo.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Windows Phone 8

Essa API tem suporte apenas em aplicativos nativos.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	Issupported
1703	15063	ShareProvidersRequested
1.709	16299	ShowShareUI(ShareUIOptions)

Métodos

GetForCurrentView()	Retorna o objeto DataTransferManager associado à janela atual.
IsSupported()	Retornará true se o dispositivo der suporte ao compartilhamento, caso contrário, false.
ShowShareUI()	Inicia programaticamente a interface do usuário para compartilhar conteúdo com outro aplicativo. Essa API é para aplicativos de Plataforma Universal do Windows (UWP). A API alternativa a ser usada para um aplicativo da área de trabalho é descrita em Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.
ShowShareUI(ShareUIOptions)	Inicia programaticamente a interface do usuário para compartilhar conteúdo com outro aplicativo. Essa API é para aplicativos de Plataforma Universal do Windows (UWP). A API alternativa a ser usada para um aplicativo da área de trabalho é descrita em Exibir objetos de interface do usuário do WinRT que dependem do CoreWindow.

Eventos

DataRequested	Ocorre quando uma operação de compartilhamento é iniciada.
ShareProvidersRequested	Um evento que é disparado quando os provedores de compartilhamento são solicitados. Isso é usado como um retorno de chamada e os provedores são adicionados assinando esse evento e chamando ShareProvidersRequestedEventArgs.Providers.Add() no manipulador de eventos.
TargetApplicationChosen	Ocorre quando o usuário escolhe um aplicativo de destino na interface do usuário do compartilhamento.

Confira também

• Exemplo de aplicativo de origem de conteúdo de compartilhamento (Windows 10)