Freigeben über


DataRequest Klasse

Definition

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

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.

Gilt für: