ShareOperation Classe

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.DataTransfer.ShareTarget
Modifier

Gère la majeure partie du travail pendant une opération de partage. Cela inclut les données que l’utilisateur souhaite partager, définir ou supprimer des liens rapides, et informer le système de la status de l’opération.

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
Héritage
Object Platform::Object IInspectable ShareOperation
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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);
        }
    });
}

Remarques

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

Une application actuellement ouverte en tant que cible de partage ne peut pas lancer une opération ShareOperation supplémentaire ou lancer un FichierOpenPicker ou FileSavePicker.

Toutes les API ShareOperation ne doivent être appelées qu’après l’activation de CoreWindow pour la cible de partage. La plateforme de partage crée une entrée pour l’opération de partage uniquement après l’activation de la fenêtre.

Notes

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 Threading and Marshaling (C++/CX) et Utilisation d’objets Windows Runtime dans un environnement multithread (.NET).

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1709 16299 Contacts

Propriétés

Contacts

Obtient les contacts de l’opération de partage.
Data

Contient un objet DataPackage avec les données que l’utilisateur souhaite partager.
QuickLinkId

Chaîne qui contient l’ID d’un QuickLink.

Méthodes

DismissUI()

Ferme le volet de partage.
RemoveThisQuickLink()

Supprime le QuickLink de la liste des QuickLinks disponibles pour l’utilisateur.
ReportCompleted()

Spécifie que l’opération de partage est terminée.
ReportCompleted(QuickLink)

Spécifie que l’opération de partage est terminée. Un QuickLink que le système peut enregistrer en tant que raccourci pour les futures opérations de partage est inclus.
ReportDataRetrieved()

Spécifie que l’application a acquis le contenu que l’utilisateur souhaite partager.
ReportError(String)

Spécifie qu’une erreur s’est produite pendant l’opération de partage.
ReportStarted()

Spécifie que l’application a commencé à acquérir le contenu que l’utilisateur souhaite partager.
ReportSubmittedBackgroundTask()

Spécifie que l’application a demandé au système d’autoriser l’opération de partage à s’exécuter en tant que tâche en arrière-plan.

S’applique à

Voir aussi