DataRequest.Data Eigenschaft

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Legt ein DataPackage-Objekt fest, das den Inhalt enthält, den ein Benutzer freigeben möchte, oder ruft es ab.

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

Eigenschaftswert

DataPackage

Enthält den Inhalt, den ein Benutzer freigeben möchte.

Beispiele

Der folgende Code zeigt, wie Sie ein DataPackage-Objekt aus der Data-Eigenschaft abrufen, indem Sie die Daten in einem DataPackage festlegen, um sie für eine andere App zu freigeben.

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

Hinweise

Mit der Data-Eigenschaft kann Ihre App Daten an eine Ziel-App bereitstellen. Ihre App muss diese Daten mithilfe eines DataPackage-Objekts bereitstellen.

Verwenden Sie diese Eigenschaft, wenn Ihre App den Inhalt sofort verfügbar hat, den der Benutzer freigeben möchte. Wenn Sie eine Funktion zum Generieren des DataPackage aufrufen müssen, verwenden Sie die GetDeferral-Methode .

Wenn Ihre App kein DataPackage-Objekt bereitstellen kann, verwenden Sie die FailWithDisplayText-Methode , um die Freigabe abzubrechen und eine Nachricht bereitzustellen, die die Ziel-App dem Benutzer anzeigen kann.