Teilen über

DataPackageView Klasse

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.DataTransfer
Bearbeiten

Eine schreibgeschützte Version eines DataPackage. Apps, die freigegebene Inhalte empfangen, erhalten dieses Objekt beim Abrufen von Inhalten.

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
Vererbung
Object Platform::Object IInspectable DataPackageView
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Der folgende Code zeigt, wie Sie dataPackageView verwenden können, um den freigegebenen Text abzurufen. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie Code hinzufügen, der erkennt, ob Ihre App als Reaktion auf einen Freigabevorgang gestartet wurde. Weitere Informationen finden Sie in unserem Thema Empfangen von Text .

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

Hinweise

Während eines Freigabevorgangs platziert die Quell-App die freigegebenen Daten in einem DataPackage-Objekt und sendet dieses Objekt zur Verarbeitung an die Ziel-App. Die DataPackage-Klasse enthält eine Reihe von Methoden zur Unterstützung der folgenden Standardformate: text, Rtf, Html, Bitmap und StorageItems. Es verfügt auch über Methoden zur Unterstützung benutzerdefinierter Datenformate. Um diese Formate verwenden zu können, müssen sowohl die Quell-App als auch die Ziel-App bereits wissen, dass das benutzerdefinierte Format vorhanden ist.

Ziel-Apps können das DataPackageView-Objekt verwenden, um die freigegebenen Daten zu erfassen. Darüber hinaus können diese Apps die AvailableFormats-Eigenschaft verwenden, um zu ermitteln, welche Formate von DataPackageView unterstützt werden, oder die Contains-Methode , um ein bestimmtes Format abzufragen.

Quell-Apps haben die Möglichkeit, den SetDataProvider zu verwenden, um einem DataPackage einen Delegaten zuzuweisen, anstatt die Daten sofort bereitzustellen. Dieser Prozess ist nützlich in Situationen, in denen die Quell-App ein bestimmtes Format unterstützt, die Daten jedoch nicht generieren möchte, es sei denn, die Ziel-App fordert sie an. Beispielsweise kann eine Quell-App eine Vielzahl von Bildformaten zum Freigeben von Fotos unterstützen. Anstatt 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.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1511 10586 SetAcceptedFormatId

Eigenschaften

AvailableFormats

Gibt die Formate zurück, die das DataPackageView enthält.
Properties

Ruft ein DataPackagePropertySetView-Objekt ab, das einen schreibgeschützten Satz von Eigenschaften für die Daten im DataPackageView-Objekt enthält.
RequestedOperation

Ruft den angeforderten Vorgang ab (z. B. Kopieren oder Verschieben). Wird hauptsächlich für Zwischenablageaktionen verwendet.

Methoden

Contains(String)

Überprüft, ob dataPackageView ein bestimmtes Datenformat enthält.
GetApplicationLinkAsync()

Ruft den Anwendungslink im DataPackageView-Objekt ab.
GetBitmapAsync()

Ruft das Bitmapbild ab, das im DataPackageView enthalten ist
GetDataAsync(String)

Ruft die im DataPackageView enthaltenen Daten ab.
GetHtmlFormatAsync()

Ruft den HTML-Code ab, der im DataPackageView-Objekt gespeichert ist.
GetResourceMapAsync()

Ruft die Daten (z. B. ein Bild) ab, auf die im HTML-Inhalt verwiesen wird.
GetRtfAsync()

Ruft den RICH-Text-formatierten Inhalt (RTF) ab, der in einer DataPackageView enthalten ist.
GetStorageItemsAsync()

Ruft die Dateien und Ordner ab, die in einem DataPackageView-Objekt gespeichert sind.
GetTextAsync()

Ruft den Text im DataPackageView-Objekt ab.
GetTextAsync(String)

Ruft den Text im DataPackageView-Objekt ab.
GetUriAsync()

Hinweis

GetUriAsync kann für Releases nach Windows 8.1 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen GetApplicationLink oder GetWebLink.

Ruft den im DataPackageView enthaltenen URI ab.
GetWebLinkAsync()

Ruft den Weblink im DataPackageView-Objekt ab.
ReportOperationCompleted(DataPackageOperation)

Informiert das System darüber, dass Ihre App mit dem DataPackageView-Objekt abgeschlossen ist. Wird hauptsächlich für Zwischenablagevorgänge verwendet.
RequestAccessAsync()

Fordert die Berechtigung zum Entsperren und Zugreifen auf ein Datenpaket an, das mit einer Schutzrichtlinie geschützt ist.
RequestAccessAsync(String)

Fordert die Berechtigung zum Entsperren und Zugreifen auf ein Datenpaket an, das mit einer Schutzrichtlinie geschützt ist.
SetAcceptedFormatId(String)

Legt die akzeptierte Format-ID fest.
UnlockAndAssumeEnterpriseIdentity()

Entsperrt ein Datenpaket und setzt eine Unternehmensidentität für das Paket voraus.

Gilt für:

Weitere Informationen