Freigeben über

ShareOperation Klasse

  • Referenz

Definition

Namespace:
Windows.ApplicationModel.DataTransfer.ShareTarget
Bearbeiten

Übernimmt den Großteil der Arbeit während eines Freigabevorgangs. Dies umfasst die Daten, die der Benutzer freigeben, QuickLinks festlegen oder entfernen möchte und das System über die status des Vorgangs informieren möchte.

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
Vererbung
Object Platform::Object IInspectable ShareOperation
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt, wie Sie mit dem ShareOperation-Objekt arbeiten.

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);
        }
    });
}

Hinweise

Wenn ein Benutzer Ihre App als Ziel einer Freigabeaktion auswählt, wird ein aktiviertes Ereignis ausgelöst. Das Objekt, das dieses Ereignis an Ihre App sendet, enthält die instance der ShareOperation-Klasse.

Eine App, die derzeit als Share-Ziel geöffnet wird, kann keine zusätzliche ShareOperation initiieren oder fileOpenPicker oder FileSavePicker starten.

Alle ShareOperation-APIs sollten erst aufgerufen werden, nachdem CoreWindow für das Share-Ziel aktiviert wurde. Die Freigabeplattform erstellt einen Eintrag für den Freigabevorgang erst, nachdem das Fenster aktiviert wurde.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1709 16299 Kontakte

Eigenschaften

Contacts

Ruft die Kontakte für den Freigabevorgang ab.
Data

Enthält ein DataPackage-Objekt mit den Daten, die der Benutzer freigeben möchte.
QuickLinkId

Eine Zeichenfolge, die die ID eines QuickLinks enthält.

Methoden

DismissUI()

Schließt den Freigabebereich.
RemoveThisQuickLink()

Entfernt den QuickLink aus der Liste der QuickLinks, die dem Benutzer zur Verfügung stehen.
ReportCompleted()

Gibt an, dass der Freigabevorgang abgeschlossen ist.
ReportCompleted(QuickLink)

Gibt an, dass der Freigabevorgang abgeschlossen ist. Ein QuickLink, den das System als Verknüpfung für zukünftige Freigabevorgänge speichern kann, ist enthalten.
ReportDataRetrieved()

Gibt an, dass die App den Inhalt erworben hat, den der Benutzer freigeben möchte.
ReportError(String)

Gibt an, dass während des Freigabevorgangs ein Fehler aufgetreten ist.
ReportStarted()

Gibt an, dass die App mit dem Abrufen der Inhalte begonnen hat, die der Benutzer freigeben möchte.
ReportSubmittedBackgroundTask()

Gibt an, dass die App angefordert hat, dass das System die Ausführung des Freigabevorgangs als Hintergrundaufgabe zulässt.

Gilt für:

Weitere Informationen