DataRequest Klasse

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Ermöglicht es Ihrer App, den Inhalt anzugeben, den der Benutzer freigeben möchte, oder eine Nachricht angeben, wenn ein Fehler auftritt.

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

Vererbung

Object Platform::Object IInspectable DataRequest

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 das DataRequest-Objekt beim Festlegen der Daten in einem DataPackage für die Freigabe für eine andere App verwenden.

//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

Ihre App empfängt ein DataRequest-Objekt , wenn ein datarequested-Ereignis auftritt. Mit diesem Objekt kann Ihre App Daten an eine Ziel-App mithilfe eines DataPackage-Objekts bereitstellen, ein Zurückstellungsobjekt zum Aufrufen einer Funktion verwenden oder die Ziel-App darüber informieren, dass ein Fehler aufgetreten ist.

Eigenschaften

Data	Legt ein DataPackage-Objekt fest, das den Inhalt enthält, den ein Benutzer freigeben möchte, oder ruft es ab.
Deadline	Ruft den Stichtag für den Abschluss eines verzögerten Renderingvorgangs ab. Wenn die Ausführung über diesen Termin hinausgeht, werden die Ergebnisse des verzögerten Renderings ignoriert.

Methoden

FailWithDisplayText(String)	Bricht den Freigabevorgang ab und stellt eine Fehlerzeichenfolge bereit, die dem Benutzer angezeigt werden soll.
GetDeferral()	Unterstützt asynchrone Freigabevorgänge, indem ein DataRequestDeferral-Objekt erstellt und zurückgegeben wird.