Compartir a través de


DataTransferManager Clase

Definición

Inicia mediante programación un intercambio de contenido con otras aplicaciones.

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
Herencia
Object Platform::Object IInspectable DataTransferManager
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra una forma típica de usar el 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!");
    });
}

Comentarios

La clase DataTransferManager es una clase estática que se usa para iniciar operaciones de uso compartido. Para usar la clase , llame primero al método GetForCurrentView . Este método devuelve el objeto DataTransferManager que es específico de la ventana activa. A continuación, debe agregar un agente de escucha de eventos para el evento datarequested al objeto . Este evento se desencadena cuando se inicia una operación de uso compartido, normalmente cuando el usuario pulsa el acceso Compartir, aunque también se desencadena si la aplicación inicia una operación de uso compartido mediante programación.

La clase DataTransferManager incluye un método ShowShareUI , que puede usar para iniciar mediante programación una operación de recurso compartido.

La clase DataTransferManager también tiene un evento TargetApplicationChosen . Usa este evento cuando quieras capturar qué aplicaciones selecciona un usuario al compartir contenido de la aplicación.

Nota

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, vea Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Windows Phone 8

Esta API solo se admite en aplicaciones nativas.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 IsSupported
1703 15063 ShareProvidersRequested
1709 16299 ShowShareUI(ShareUIOptions)

Métodos

GetForCurrentView()

Devuelve el objeto DataTransferManager asociado a la ventana actual.

IsSupported()

Devuelve true si el dispositivo admite el uso compartido; de lo contrario, false.

ShowShareUI()

Inicia mediante programación la interfaz de usuario para compartir contenido con otra aplicación.

Esta API es para aplicaciones Plataforma universal de Windows (UWP). La API alternativa que se usa para una aplicación de escritorio se describe en Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

ShowShareUI(ShareUIOptions)

Inicia mediante programación la interfaz de usuario para compartir contenido con otra aplicación.

Esta API es para aplicaciones Plataforma universal de Windows (UWP). La API alternativa que se usa para una aplicación de escritorio se describe en Mostrar objetos de interfaz de usuario de WinRT que dependen de CoreWindow.

Eventos

DataRequested

Se produce cuando se inicia una operación de recurso compartido.

ShareProvidersRequested

Evento que se desencadena cuando se solicitan los proveedores de recursos compartidos. Esto se usa como devolución de llamada y los proveedores se agregan mediante la suscripción a este evento y la llamada a ShareProvidersRequestedEventArgs.Providers.Add() en el controlador de eventos.

TargetApplicationChosen

Se produce cuando el usuario elige una aplicación de destino en la interfaz de usuario de Compartir.

Se aplica a

Consulte también