ShareOperation Class

Articolo
11/24/2013

Gestisce la maggior parte del lavoro durante l'operazione di condivisione. Include i dati che l'utente desidera condividere, l'impostazione o la rimozione di QuickLinks e l'informazione per il sistema sullo stato dell'operazione.

Sintassi

var shareOperation = promise.operation;

public sealed class ShareOperation

Public NotInheritable Class ShareOperation

public ref class ShareOperation sealed

Attributi

[MarshalingBehavior(Standard)]

[Version(0x06020000)]

Membri

ShareOperationClasse include questi tipi di membri:

Metodi
Proprietà

Metodi

The ShareOperation Classe dispone di tali metodi. In C#, Visual Basic e C++, eredita inoltre i metodi da Object Classe.

Metodo	Descrizione
DismissUI	Closes the share pane.
RemoveThisQuickLink	Removes the QuickLink from the list of QuickLinks that are available to the user.
ReportCompleted()	Specifies that the sharing operation is complete.
ReportCompleted(QuickLink)	Specifies that the sharing operation is complete. A QuickLink that the system can save as a shortcut for future sharing operations is included.
ReportDataRetrieved	Specifies that the app has acquired the content that the user wants to share.
ReportError	Specifies that an error occurred during the sharing operation.
ReportStarted	Specifies that the app has started to acquire the content that the user wants to share.
ReportSubmittedBackgroundTask	Specifies that the app has requested that the system allow the sharing operation to run as a background task.

Proprietà

Classe dispone di tali proprietà. di ShareOperation

Proprietà	Tipo di accesso	Descrizione
Data	Sola lettura	Contains a DataPackage object with the data that the user wants to share.
QuickLinkId	Sola lettura	A string that contains the ID of a QuickLink.

Note

Quando un utente seleziona l'applicazione come destinazione di un'azione di condivisione, viene generato un evento activated. L'oggetto che questo evento invia all'applicazione contiene l'istanza della classe ShareOperation.

Nota : Questa classe non è Agile, cioè è necessario considerare il relativo modello di threading e il relativo comportamento di marshalling. Per ulteriori informazioni, vedere Threading e marshaling (C++/CX) e Utilizzo di oggetti Windows Runtime in un ambiente con multithreading (.NET).

Esempi

Nell'esempio riportato di seguito vengono illustrate le modalità di utilizzo dell'oggetto ShareOperation.

var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
    shareOperation.data.getTextAsync().done(function (text) {
            // To output the text using this example, 
            // you need a div tag with an id of "output" in your HTML file.
            document.getElementById("output").innerText = text;
        }, function (e) {
            displayError("Error retrieving Text format: " + e);
        }
    });
}

Requisiti

Client supportato minimo	Windows 8 [Solo applicazioni Windows Store]
Server supportato minimo	Windows Server 2012 [Solo applicazioni Windows Store]
Spazio dei nomi	Windows.ApplicationModel.DataTransfer.ShareTarget Windows::ApplicationModel::DataTransfer::ShareTarget [C++]
Metadati	Windows.winmd