ShareOperation Class

Article
11/25/2013

Gère l'essentiel du travail pendant une opération de partage. Cela inclut les données que l'utilisateur souhaite partager, la définition ou la suppression des QuickLinks, et la transmission de l'état de l'opération au système.

Syntaxe

var shareOperation = promise.operation;

public sealed class ShareOperation

Public NotInheritable Class ShareOperation

public ref class ShareOperation sealed

Attributs

[MarshalingBehavior(Standard)]

[Version(0x06020000)]

Membres

ShareOperationClasse possède ces types de membres :

Méthodes
Propriétés

Méthodes

The ShareOperation Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

Méthode	Description
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.

Propriétés

Le ShareOperationClasse a les propriétés suivantes.

Propriété	Type d'accès	Description
Data	En lecture seule	Contains a DataPackage object with the data that the user wants to share.
QuickLinkId	En lecture seule	A string that contains the ID of a QuickLink.

Remarques

Lorsqu'un utilisateur sélectionne votre application comme cible d'une action de partage, un événement activated se déclenche. L'objet que cet événement envoie à votre application contient l'instance de la classe ShareOperation.

Remarque : cette classe n'est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d'informations, consultez les rubriques Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Exemples

L'exemple suivant montre comment utiliser l'objet 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);
        }
    });
}

Conditions requises

Client minimal pris en charge	Windows 8 [Applications Windows Store uniquement]
Serveur minimal pris en charge	Windows Server 2012 [Applications Windows Store uniquement]
Espace de noms	Windows.ApplicationModel.DataTransfer.ShareTarget Windows::ApplicationModel::DataTransfer::ShareTarget [C++]
Métadonnées	Windows.winmd