DataRequest Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Consente all'app di fornire il contenuto che l'utente vuole condividere o specificare un messaggio, se si verifica un errore.

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

Ereditarietà

Object Platform::Object IInspectable DataRequest

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 l'oggetto DataRequest come parte dell'impostazione dei dati in un DataPackage da condividere con un'altra app.

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

Commenti

L'app riceve un oggetto DataRequest quando si verifica un evento datarequested . Con questo oggetto, l'app può fornire dati a un'app di destinazione usando un oggetto DataPackage , usare un oggetto differitore per chiamare una funzione o informare l'app di destinazione che si è verificato un errore.

Proprietà

Data	Imposta o ottiene un oggetto DataPackage che contiene il contenuto che un utente desidera condividere.
Deadline	Ottiene la scadenza per completare un'operazione di rendering ritardata. Se l'esecuzione supera tale scadenza, i risultati del rendering ritardato vengono ignorati.

Metodi

FailWithDisplayText(String)	Annulla l'operazione di condivisione e fornisce una stringa di errore da visualizzare all'utente.
GetDeferral()	Supporta operazioni di condivisione asincrone creando e restituendo un oggetto DataRequestDeferral .