DataPackage-Klasse

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

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

Member

DataPackageKlasse hat diese Membertypen:

Konstruktoren

DataPackageKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
DataPackage Constructor that creates a new DataPackage.

 

Ereignisse

DataPackageKlasse hat diese Ereignisse.

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

 

Methoden

The DataPackage Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
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.

 

Eigenschaften

Der DataPackageKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

Properties

SchreibgeschütztAllows you to get and set properties like the title of the content being shared.

RequestedOperation

Lese-/SchreibzugriffSpecifies the DataPackageOperation (none, move, copy, or link) for the operation.

ResourceMap

SchreibgeschütztMaps a URI to a file. Used to ensure that referenced content (such as an image) in HTML content is added to the DataPackage.

 

Hinweise

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.

Windows Phone 8

Diese API wird nur in systemeigenen Apps unterstützt.

Beispiele


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

Mindestens unterstützter Client

Windows 8 [Windows Store-Apps, Desktop-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Windows Store-Apps, Desktop-Apps]

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

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

Metadaten

Windows.winmd

 

 

Anzeigen:
© 2016 Microsoft