ShareOperation Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.DataTransfer.ShareTarget
Modifica

Gestisce la maggior parte del lavoro durante un'operazione di condivisione. Sono inclusi i dati che l'utente vuole condividere, impostare o rimuovere i collegamenti rapidi e informare il sistema sullo stato dell'operazione.

public ref class ShareOperation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class ShareOperation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class ShareOperation
Public NotInheritable Class ShareOperation
Ereditarietà
Object Platform::Object IInspectable ShareOperation
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato come usare l'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);
        }
    });
}

Commenti

Quando un utente seleziona l'app come destinazione di un'azione di condivisione, viene generato un evento attivato . L'oggetto inviato all'app contiene l'istanza della classe ShareOperation .

Un'app attualmente aperta come destinazione di condivisione non può avviare un'operazione di ShareOperation aggiuntiva o avviare un FileOpenPicker o FileSavePicker.

Tutte le API ShareOperation devono essere chiamate solo dopo l'attivazione della destinazione CoreWindow per la condivisione. La piattaforma Share crea una voce per l'operazione di condivisione solo dopo l'attivazione della finestra.

Nota

Questa classe non è agile, il che significa che è necessario considerare il relativo modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) eUso di oggetti Windows Runtime in un ambiente multithreaded (.NET).

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1709 16299 Contatti

Proprietà

Contacts

Ottiene i contatti per l'operazione di condivisione.
Data

Contiene un oggetto DataPackage con i dati che l'utente vuole condividere.
QuickLinkId

Stringa contenente l'ID di un collegamento rapido.

Metodi

DismissUI()

Chiude il riquadro di condivisione.
RemoveThisQuickLink()

Rimuove il collegamento rapido dall'elenco di Collegamenti rapidi disponibili per l'utente.
ReportCompleted()

Specifica che l'operazione di condivisione è stata completata.
ReportCompleted(QuickLink)

Specifica che l'operazione di condivisione è stata completata. Un collegamento rapido che il sistema può salvare come collegamento per le operazioni di condivisione future è incluso.
ReportDataRetrieved()

Specifica che l'app ha acquisito il contenuto che l'utente vuole condividere.
ReportError(String)

Specifica che si è verificato un errore durante l'operazione di condivisione.
ReportStarted()

Specifica che l'app ha avviato l'acquisizione del contenuto che l'utente vuole condividere.
ReportSubmittedBackgroundTask()

Specifica che l'app ha richiesto che il sistema consenta l'esecuzione dell'operazione di condivisione come attività in background.

Si applica a

Vedi anche