DataPackageView Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.DataTransfer
Modifica

Versione di sola lettura di un Pacchetto dati. Le app che ricevono contenuto condiviso ottengono questo oggetto durante l'acquisizione di contenuto.

public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
Ereditarietà
Object Platform::Object IInspectable DataPackageView
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

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

Il codice seguente illustra come usare DataPackageView per ottenere il testo condiviso. Per il corretto funzionamento di questo esempio, è necessario aggiungere codice che rileva se l'app è stata avviata in risposta a un'operazione di condivisione. Per altre informazioni, vedere l'argomento Come ricevere testo .

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

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 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 o il metodo Contains per eseguire query per un formato specifico.

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 in situazioni in cui l'app di origine supporta un formato specifico, ma non vuole generare i dati a meno che l'app di destinazione non lo richieda. 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.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1511 10586 SetAcceptedFormatId

Proprietà

AvailableFormats

Restituisce i formati contenuti in DataPackageView .
Properties

Ottiene un oggetto DataPackagePropertySetView che contiene un set di proprietà di sola lettura per i dati nell'oggetto DataPackageView .
RequestedOperation

Ottiene l'operazione richiesta, ad esempio copia o spostamento. Usato principalmente per le azioni degli Appunti.

Metodi

Contains(String)

Verifica se DataPackageView contiene un formato di dati specifico.
GetApplicationLinkAsync()

Ottiene il collegamento dell'applicazione nell'oggetto DataPackageView .
GetBitmapAsync()

Ottiene l'immagine bitmap contenuta in DataPackageView
GetDataAsync(String)

Ottiene i dati contenuti in DataPackageView.
GetHtmlFormatAsync()

Ottiene il codice HTML archiviato nell'oggetto DataPackageView .
GetResourceMapAsync()

Ottiene i dati (ad esempio un'immagine) a cui fa riferimento nel contenuto HTML.
GetRtfAsync()

Ottiene il contenuto rtf formattato (RTF) contenuto in un oggetto DataPackageView.
GetStorageItemsAsync()

Ottiene i file e le cartelle archiviati in un oggetto DataPackageView .
GetTextAsync()

Ottiene il testo nell'oggetto DataPackageView .
GetTextAsync(String)

Ottiene il testo nell'oggetto DataPackageView .
GetUriAsync()

Nota

GetUriAsync può essere modificato o non disponibile per le versioni dopo Windows 8.1. Usare invece GetApplicationLink o GetWebLink.

Ottiene l'URI contenuto in DataPackageView.
GetWebLinkAsync()

Ottiene il collegamento Web nell'oggetto DataPackageView .
ReportOperationCompleted(DataPackageOperation)

Informa il sistema che l'app viene completata usando l'oggetto DataPackageView . Usato principalmente per le operazioni degli Appunti.
RequestAccessAsync()

Richiede l'autorizzazione per sbloccare e accedere a un pacchetto di dati protetto con criteri di protezione.
RequestAccessAsync(String)

Richiede l'autorizzazione per sbloccare e accedere a un pacchetto di dati protetto con criteri di protezione.
SetAcceptedFormatId(String)

Imposta l'ID di formato accettato.
UnlockAndAssumeEnterpriseIdentity()

Sblocca un pacchetto di dati e presuppone un'identità aziendale.

Si applica a

Vedi anche