DataRequest.Data Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta o ottiene un oggetto DataPackage che contiene il contenuto che un utente desidera condividere.
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
Valore della proprietà
Contiene il contenuto che un utente vuole condividere.
Esempio
Il codice seguente illustra come ottenere un oggetto DataPackage dalla proprietà Data 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
La proprietà Data consente all'app di fornire dati a un'app di destinazione. L'app deve fornire questi dati usando un oggetto DataPackage .
Usa questa proprietà quando l'app ha il contenuto immediatamente disponibile che l'utente vuole condividere. Se è necessario chiamare una funzione per generare il DataPackage, utilizzare il metodo GetDeferral .
Quando l'app non può fornire un oggetto DataPackage , usa il metodo FailWithDisplayText per annullare la condivisione e fornire un messaggio che l'app di destinazione può visualizzare all'utente.