Applications Windows
Réduire la table des matières
Développer la table des matières

ShareOperation Class

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;

Attributs

[MarshalingBehavior(Standard)]
[Version(0x06020000)]

Membres

ShareOperationClasse possède ces types de membres :

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éthodeDescription
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èsDescription

Data

En lecture seuleContains a DataPackage object with the data that the user wants to share.

QuickLinkId

En lecture seuleA 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

Voir aussi

Exemple d'application source de contenu de partage
Exemple d'application cible de contenu de partage
Démarrage rapide : partage du contenu (applications Windows Store utilisant JavaScript et HTML)
Démarrage rapide : partage du contenu (applications Windows Store utilisant C#/VB/C++ et XAML)
Démarrage rapide : réception du contenu partagé (applications Windows Store utilisant JavaScript et HTML)
Démarrage rapide : réception du contenu partagé (applications Windows Store utilisant C#/VB/C++ et XAML)

 

 

Afficher:
© 2016 Microsoft