Windows Dev Center

DataPackage Class

Contient les données qu'un utilisateur souhaite échanger avec une autre application.

Syntaxe


var dataPackage = new Windows.ApplicationModel.DataTransfer.DataPackage();

Attributs

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

Membres

DataPackageClasse possède ces types de membres :

Constructeurs

DataPackageClasse possède ces constructeurs.

ConstructeurDescription
DataPackage Constructor that creates a new DataPackage.

 

Événements

DataPackageClasse possède ces événements.

ÉvénementDescription
Destroyed Occurs when the DataPackage is destroyed.
OperationCompleted Occurs when a paste operation is completed.

 

Méthodes

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

MéthodeDescription
GetView Returns a DataPackageView object. This object is a read-only copy of the DataPackage object.
SetApplicationLink Sets the application link that a DataPackage contains.
SetBitmap Sets the bitmap image contained in the DataPackage.
SetData Sets the data contained in the DataPackage in a RandomAccessStream format.
SetDataProvider Sets a delegate to handle requests from the target app.
SetHtmlFormat Adds HTML content to the DataPackage.
SetRtf Sets the Rich Text Format (RTF) content that is contained in a DataPackage.
SetStorageItems(IIterable(IStorageItem)) Sets the files and folders contained in a DataPackage.
SetStorageItems(IIterable(IStorageItem), Boolean) Adds files and folders to a DataPackage.
SetText Sets the text that a DataPackage contains.
SetUri Sets the Uniform Resource Identifier (URI) that is contained in the DataPackage.
SetWebLink Sets the web link that a DataPackage contains.

 

Propriétés

Le DataPackageClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

Properties

En lecture seuleAllows you to get and set properties like the title of the content being shared.

RequestedOperation

Lecture/écritureSpecifies the DataPackageOperation (none, move, copy, or link) for the operation.

ResourceMap

En lecture seuleMaps a URI to a file. Used to ensure that referenced content (such as an image) in HTML content is added to the DataPackage.

 

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à être informé que le format personnalisé existe.

Les applications sources peuvent utiliser SetDataProvider pour assigner un délégué à un DataPackage, au lieu de fournir les données immédiatement. Ce processus est utile lorsque l'application source prend en charge un format donné mais ne souhaite pas générer les données à moins que l'application cible les 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.

Les applications cibles peuvent utiliser l'objet DataPackageView pour acquérir les données partagées. 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 lancer une requête à la recherche d'un format spécifique.

Windows Phone 8

Cette API est prise en charge dans les applications natives uniquement.

Exemples


function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareTextHandler);
}

function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "A demonstration that shows how to share.";
    request.data.setText("Hello World!");
}


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

Espace de noms

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

Métadonnées

Windows.winmd

 

 

Afficher:
© 2015 Microsoft