Partilhar via


DataTransferManager Classe

Definição

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)]
class DataTransferManager final
/// [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)]
public sealed class DataTransferManager
[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

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.

Aplica-se a

Confira também