DataTransferManager Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.DataTransfer

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)]
/// [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

Herencia

Object Platform::Object IInspectable DataTransferManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Consulte también

• Ejemplo de aplicación de origen de contenido compartido (Windows 10)