Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataPackage Class

Enthält die Daten, die ein Benutzer mit einer anderen App austauschen möchte.

Syntax


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

Attribute

ActivatableAttribute(NTDDI_WIN8)
DualApiPartitionAttribute()
MarshalingBehaviorAttribute(Agile)
VersionAttribute(NTDDI_WIN8)

Member

Der DataPackageKlasse hat die folgenden Arten von Mitgliedern:

Konstruktoren
Ereignisse
Methoden
Eigenschaften

Konstruktoren

Der DataPackageKlasse hat die folgenden Konstruktoren.

Konstruktor	Beschreibung
DataPackage	Constructor that creates a new DataPackage.

Ereignisse

Der DataPackageKlasse hat die folgenden Ereignisse.

Ereignis	Beschreibung
Destroyed	Occurs when the DataPackage is destroyed.
OperationCompleted	Occurs when a paste operation is completed.

Methoden

The DataPackage Klasse verfügt über die folgenden Methoden. Mit C#, Visual Basic und C++ erbt er außerdem Methoden von Object Klasse.

Methode	Beschreibung
GetView	Returns a DataPackageView object. This object is a read-only copy of the DataPackage object.
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.

Eigenschaften

DataPackageKlasse hat die folgenden Eigenschaften.

Eigenschaft	Zugriffstyp	Beschreibung
Properties	Schreibgeschützt	Allows you to get and set properties like the title of the content being shared.
RequestedOperation	Lese-/Schreibzugriff	Specifies the DataPackageOperation (none, move, copy, or link) for the operation.
ResourceMap	Schreibgeschützt	Maps a URI to a file. Used to ensure that referenced content (such as an image) in HTML content is added to the DataPackage.

Anmerkungen

Während eines Freigabevorgangs stellt die Quell-App die freigegebenen Daten in ein DataPackage-Objekt und sendet dieses Objekt zur Verarbeitung zur Ziel-App. Die DataPackage-Klasse umfasst mehrere Möglichkeiten zur Unterstützung folgender Standardformate: text, Rtf, Html, Bitmap und StorageItems. Vorhanden sind auch Methoden zur Unterstützung benutzereigener Datenformate. Um diese Formate zu verwenden, müssen die Quell-App und die Ziel-App bereits beachten, dass das benutzerdefinierte Format vorhanden ist.

Quell-Apps haben die Möglichkeit,SetDataProvider, zu verwenden, um DataPackage einen Delegaten zuzuweisen, anstatt die Daten sofort bereitzustellen. Dieser Prozess ist nützlich, wenn die Quell-App ein bestimmtes Format unterstützt, aber die Daten nicht generiert werden sollen, bevor die Ziel-App die Daten anfordert. Beispielsweise kann eine Quell-App eine Vielzahl von Bildformaten zum Freigeben von Fotos unterstützen. Statt mehrere Kopien jedes Bilds mit diesen Formaten zu erstellen, kann die Quell-App einen Delegaten verwenden, der aufgerufen wird, wenn die Ziel-App einen bestimmten Formattyp anfordert.

Ziel-Apps können das DataPackageView-Objekt zum Abrufen der freigegebenen Daten verwenden. Zudem können diese Apps die Eigenschaft AvailableFormats verwenden, um festzustellen, welche Formate von DataPackageView unterstützt werden, oder mit der Methode Contains ein bestimmtes Format abfragen.

Beispiele

JavaScript


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

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [Windows Store-Apps, Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Windows Store-Apps, Desktop-Apps]
Unterstützte Mindestversion (Telefon)	Windows Phone 8
Namespace	Windows.ApplicationModel.DataTransfer Windows::ApplicationModel::DataTransfer [C++]
Metadaten	Windows.winmd