DataPackage Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Contiene i dati che un utente vuole scambiare con un'altra app.

public ref class DataPackage sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataPackage final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataPackage

function DataPackage()

Public NotInheritable Class DataPackage

Ereditarietà

Object Platform::Object IInspectable DataPackage

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

Commenti

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 formati predefiniti seguenti: testo, Rtf, Html, Bitmap e StorageItems. Include anche metodi per supportare formati di dati personalizzati. Per usare questi formati, sia l'app di origine che l'app di destinazione devono essere già consapevoli che il formato personalizzato esiste.

Le app di origine hanno la possibilità di usare SetDataProvider per assegnare un delegato a un DataPackage, anziché fornire immediatamente i dati. Questo processo è utile quando l'app di origine supporta un formato specificato, ma non vuole generare i dati a meno che l'app di destinazione non richieda i dati. Ad esempio, un'app di origine può supportare un'ampia gamma di formati di immagine per la condivisione di foto. Anziché creare più copie di ogni immagine usando questi formati, l'app di origine può usare un delegato chiamato quando l'app di destinazione richiede un tipo di formato specifico.

Le app di destinazione possono usare l'oggetto DataPackageView per acquisire i dati condivisi. Inoltre, queste app possono usare la proprietà AvailableFormats per identificare i formati supportati da DataPackageView oppure usare il metodo Contains per eseguire una query per un formato specifico.

Windows Phone 8

Questa API è supportata solo nelle app native.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1703	15063	ShareCompleted
2004	19041	ShareCanceled

Costruttori

DataPackage()

Costruttore che crea un nuovo Pacchetto dati.

Proprietà

Properties	Consente di ottenere e impostare proprietà come il titolo del contenuto condiviso.
RequestedOperation	Specifica dataPackageOperation (nessuno, spostare, copiare o collegare) per l'operazione.
ResourceMap	Esegue il mapping di un URI a un file. Usato per assicurarsi che il contenuto a cui si fa riferimento (ad esempio un'immagine) nel contenuto HTML venga aggiunto al Pacchetto dati.

Metodi

GetView()	Restituisce un oggetto DataPackageView . Questo oggetto è una copia di sola lettura dell'oggetto DataPackage .
SetApplicationLink(Uri)	Imposta il collegamento dell'applicazione contenente un Pacchetto dati .
SetBitmap(RandomAccessStreamReference)	Imposta l'immagine bitmap contenuta in DataPackage.
SetData(String, Object)	Imposta i dati contenuti nel Pacchetto dati in formato RandomAccessStream .
SetDataProvider(String, DataProviderHandler)	Imposta un delegato per gestire le richieste dall'app di destinazione.
SetHtmlFormat(String)	Aggiunge contenuto HTML al Pacchetto dati.
SetRtf(String)	Imposta il contenuto RTF (Rich Text Format) contenuto in un Pacchetto dati.
SetStorageItems(IIterable<IStorageItem>)	Imposta i file e le cartelle contenuti in un Pacchetto dati.
SetStorageItems(IIterable<IStorageItem>, Boolean)	Aggiunge file e cartelle a un Pacchetto dati.
SetText(String)	Imposta il testo che contiene un Pacchetto dati .
SetUri(Uri)	Nota SetUri può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece ApplicationLink o WebLink. Imposta l'URI (Uniform Resource Identifier) contenuto in DataPackage.
SetWebLink(Uri)	Imposta il collegamento Web contenente un Pacchetto dati .

Eventi

Destroyed	Si verifica quando il Pacchetto dati viene eliminato.
OperationCompleted	Si verifica quando viene completata un'operazione di incolla.
ShareCanceled	Generato quando viene annullata una condivisione.
ShareCompleted	Evento attivato al termine di una condivisione. Le condivisioni possono essere inviate a un'app, a un provider o a un contatto.

Vedi anche

• Esempio di Appunti (Windows 10)
• Esempio di app di origine contenuto (Windows 10)