DataPackageView Class

Version en lecture seule d'un objet DataPackage. Applications qui reçoivent le contenu partagé obtiennent cet objet par acquisition du contenu.

Syntaxe


var dataPackageView = shareOperation.data;

Attributs

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Version(0x06020000)]

Membres

DataPackageViewClasse possède ces types de membres :

Méthodes

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

MéthodeDescription
Contains Checks to see if the DataPackageView contains a specific data format.
GetApplicationLinkAsync Gets the application link in the DataPackageView object.
GetBitmapAsync Gets the bitmap image contained in the DataPackageView
GetDataAsync Gets the data contained in the DataPackageView.
GetHtmlFormatAsync Gets the HTML stored in the DataPackageView object.
GetResourceMapAsync Gets the data (such as an image) referenced in HTML content.
GetRtfAsync Gets the rich text formatted (RTF) content contained in a DataPackageView.
GetStorageItemsAsync Gets the files and folders stored in a DataPackageView object.
GetTextAsync() Gets the text in the DataPackageView object.
GetTextAsync(String) Gets the text in the DataPackageView object.
GetUriAsync Gets the URI contained in the DataPackageView.
GetWebLinkAsync Gets the web link in the DataPackageView object.
ReportOperationCompleted Informs the system that your app is finished using the DataPackageView object. Primarily used for Clipboard operations.

 

Propriétés

Le DataPackageViewClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

AvailableFormats

En lecture seuleReturns the formats the DataPackageView contains.

Properties

En lecture seuleGets a DataPackagePropertySetView object, which contains a read-only set of properties for the data in the DataPackageView object.

RequestedOperation

En lecture seuleGets the requested operation (such as copy or move). Primarily used for Clipboard actions.

 

Remarques

Pendant une opération de partage, l'application source place les données qui sont partagées dans un objet DataPackage et envoie cet objet à l'application cible pour qu'il soit traité. La classe DataPackage inclut un certain nombre de méthodes pour prendre en charge les formats par défaut suivants : text, Rtf, Html, Bitmap et StorageItems. Elle contient également des méthodes pour prendre en charge les formats de données personnalisés. Pour utiliser ces formats, l'application source et l'application cible doivent déjà savoir que le format personnalisé existe.

Les applications cibles peuvent utiliser l'objet DataPackageView pour acquérir les données en cours de partage. En outre, ces applications peuvent utiliser la propriété AvailableFormats pour identifier les formats pris en charge par DataPackageView ou utiliser la méthode Contains pour rechercher un format spécifique.

Les applications source peuvent utiliser le SetDataProvider pour assigner un délégué à un DataPackage au lieu de fournir les données immédiatement. Ce processus est utile dans les situations où l'application source prend en charge un format donné mais ne souhaite pas générer les données sauf si l'application cible le demande. Par exemple, une application de source peut prendre en charge divers formats d'image pour le partage de photos. Au lieu de créer plusieurs copies de chaque image à l'aide de ces formats, l'application source peut utiliser un délégué qui est appelé lorsque l'application cible demande un type de format spécifique.

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Exemples

Le code suivant montre comment utiliser le DataPackageView pour obtenir le texte partagé. Pour que cet exemple fonctionne correctement, vous devez ajouter le code qui permet de détecter si votre application est lancée en réponse à une opération de partage. Pour en savoir plus, consultez notre rubrique Procédure de réception du texte.


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, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store, applications de bureau]

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, consultez la section Notes]

Espace de noms

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

Métadonnées

Windows.winmd

Voir aussi

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

 

 

Afficher:
© 2014 Microsoft