Compartir a través de

ShareOperation Clase

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.DataTransfer.ShareTarget
Editar

Controla la mayor parte del trabajo durante una operación de recurso compartido. Esto incluye los datos que el usuario quiere compartir, establecer o quitar QuickLinks e informar al sistema sobre el estado de la operación.

public ref class ShareOperation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation
Public NotInheritable Class ShareOperation
Herencia
Object Platform::Object IInspectable ShareOperation
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

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 el ejemplo siguiente se muestra cómo trabajar con el objeto ShareOperation.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

Comentarios

Cuando un usuario selecciona la aplicación como destino de una acción de recurso compartido, se desencadena un evento activado . El objeto que este evento envía a la aplicación contiene la instancia de la clase ShareOperation .

Actualmente, una aplicación abierta como destino de recurso compartido no puede iniciar una shareOperation adicional ni iniciar un FileOpenPicker o FileSavePicker.

Todas las API de ShareOperation solo deben llamarse después de activar CoreWindow para el destino de Recurso compartido. La plataforma Compartir crea una entrada para la operación de recurso compartido solo después de activar la ventana.

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, consulte Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1709 16299 Contactos

Propiedades

Contacts

Obtiene los contactos de la operación de recurso compartido.
Data

Contiene un objeto DataPackage con los datos que el usuario quiere compartir.
QuickLinkId

Cadena que contiene el identificador de un QuickLink.

Métodos

DismissUI()

Cierra el panel de recursos compartidos.
RemoveThisQuickLink()

Quita QuickLink de la lista de QuickLinks que están disponibles para el usuario.
ReportCompleted()

Especifica que se ha completado la operación de uso compartido.
ReportCompleted(QuickLink)

Especifica que se ha completado la operación de uso compartido. Se incluye un QuickLink que el sistema puede guardar como acceso directo para futuras operaciones de uso compartido.
ReportDataRetrieved()

Especifica que la aplicación ha adquirido el contenido que el usuario quiere compartir.
ReportError(String)

Especifica que se produjo un error durante la operación de uso compartido.
ReportStarted()

Especifica que la aplicación ha empezado a adquirir el contenido que el usuario quiere compartir.
ReportSubmittedBackgroundTask()

Especifica que la aplicación ha solicitado que el sistema permita que la operación de uso compartido se ejecute como una tarea en segundo plano.

Se aplica a

Consulte también