ShareOperation Class

Artículo
11/25/2013

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

Sintaxis

var shareOperation = promise.operation;

public sealed class ShareOperation

Public NotInheritable Class ShareOperation

public ref class ShareOperation sealed

Atributos

[MarshalingBehavior(Standard)]

[Version(0x06020000)]

Members

A continuación se indican los tipos de miembros de ShareOperation (Clase):

Métodos
Propiedades

Métodos

The ShareOperation Clase tiene estos métodos. Con C#, Visual Basic y C++, también hereda métodos de Object Clase.

Método	Descripción
DismissUI	Closes the share pane.
RemoveThisQuickLink	Removes the QuickLink from the list of QuickLinks that are available to the user.
ReportCompleted()	Specifies that the sharing operation is complete.
ReportCompleted(QuickLink)	Specifies that the sharing operation is complete. A QuickLink that the system can save as a shortcut for future sharing operations is included.
ReportDataRetrieved	Specifies that the app has acquired the content that the user wants to share.
ReportError	Specifies that an error occurred during the sharing operation.
ReportStarted	Specifies that the app has started to acquire the content that the user wants to share.
ReportSubmittedBackgroundTask	Specifies that the app has requested that the system allow the sharing operation to run as a background task.

Propiedades

ShareOperationClase tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
Data	De sólo lectura	Contains a DataPackage object with the data that the user wants to share.
QuickLinkId	De sólo lectura	A string that contains the ID of a QuickLink.

Comentarios

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

Nota : esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento del cálculo de referencias. Para obtener más información, vea Subprocesos y cálculo de referencias (C++/CX) y Usar objetos de Windows en tiempo de ejecución en un entorno multiproceso (.NET).

Ejemplos

En el ejemplo siguiente se muestra cómo ejecutar 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);
        }
    });
}

Requisitos

Cliente mínimo admitido	Windows 8 [Solo aplicaciones de la Tienda Windows]
Servidor mínimo admitido	Windows Server 2012 [Solo aplicaciones de la Tienda Windows]
Espacio de nombres	Windows.ApplicationModel.DataTransfer.ShareTarget Windows::ApplicationModel::DataTransfer::ShareTarget [C++]
Metadatos	Windows.winmd