DataPackage Class

Contiene i dati che un utente desidera scambiare con un'altra applicazione.

Sintassi


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

Attributi

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

Membri

DataPackageClasse include questi tipi di membri:

Costruttori

DataPackageClasse include questi costruttori.

CostruttoreDescrizione
DataPackage Constructor that creates a new DataPackage.

 

Eventi

DataPackageClasse include questi eventi.

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

 

Metodi

The DataPackage Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

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

 

Proprietà

Classe dispone di tali proprietà. di DataPackage

ProprietàTipo di accessoDescrizione

Properties

Sola letturaAllows you to get and set properties like the title of the content being shared.

RequestedOperation

Lettura/scritturaSpecifies the DataPackageOperation (none, move, copy, or link) for the operation.

ResourceMap

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

 

Note

Durante un'operazione di condivisione, l'app di origine inserisce i dati condivisi in un oggetto DataPackage e invia tale oggetto all'app di destinazione per l'elaborazione. La classe DataPackage include diversi metodi per supportare i seguenti formati predefiniti: text, Rtf, Html, Bitmap e StorageItems. Dispone inoltre di metodi per il supporto dei formati di dati personalizzati. Per utilizzare questi formati, sia l'applicazione di origine che di destinazione devono essere già consapevoli dell'esistenza del formato personalizzato.

Le applicazioni di origine hanno la possibilità di utilizzare SetDataProvider per assegnare un delegato a DataPackage, anziché fornire i dati immediatamente. Questo processo è utile quando l'applicazione di origine supporta un formato specifico ma non desidera generare dati a meno che l'applicazione di destinazione non li richieda. Ad esempio, un'app di origine può supportare una varietà di formati di immagine per condividere foto. Anziché creare più copie di ogni immagine utilizzando questi formati, l'applicazione di origine può utilizzare un delegato che viene chiamato quando l'applicazione di destinazione richiede un tipo specifico di formato.

Le app di destinazione possono utilizzare l'oggetto di DataPackageView per acquisire i dati da condividere. Queste applicazioni possono inoltre utilizzare la proprietà AvailableFormats per identificare i formati supportati da DataPackageView o dal metodo Contains per eseguire la query di un formato specifico.

Windows Phone 8

Questa API è supportata solo nelle applicazioni native.

Esempi


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


Requisiti

Client supportato minimo

Windows 8 [Applicazioni Windows Store, applicazioni desktop]

Server supportato minimo

Windows Server 2012 [Applicazioni Windows Store, applicazioni desktop]

Telefono supportato minimo

Windows Phone 8

Spazio dei nomi

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

Metadati

Windows.winmd

 

 

Mostra:
© 2014 Microsoft