DataPackage.RequestedOperation Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die DataPackageOperation (none, move, copy oder link) für den Vorgang an.
public:
property DataPackageOperation RequestedOperation { DataPackageOperation get(); void set(DataPackageOperation value); };DataPackageOperation RequestedOperation();
void RequestedOperation(DataPackageOperation value);public DataPackageOperation RequestedOperation { get; set; }var dataPackageOperation = dataPackage.requestedOperation;
dataPackage.requestedOperation = dataPackageOperation;Public Property RequestedOperation As DataPackageOperationEigenschaftswert
Der von der Quell-App angeforderte Vorgang.
Beispiele
// Request a copy operation
datapackage.RequestedOperation = DataPackageOperation.Copy;
// find what the requested operation is
DataPackageOperation operation = dataPackageView.RequestedOperation;
Hinweise
Diese Eigenschaft gibt den Vorgang an, den der Consumer eines Datenpakets in Zwischenablage- oder Drag-and-Drop-Szenarien ausführen soll. Die unterstützten Optionen werden in der DataPackageOperation-Enumeration angegeben.
Beim Implementieren der Zwischenablagefunktion entspricht DataPackageOperation.Move dem Befehl "Cut" und dem Befehl DataPackageOperation.Copy to "Copy". Es ist das Ziel der Verantwortung des Vorgangs, diesen Wert zu respektieren und zu melden, dass er einen Ausschnitt oder eine Kopie ausgeführt hat, indem DataPackageView.ReportOperationComplete mit dem entsprechenden Wert aufgerufen wird.
In Drag-and-Drop-Szenarien sollte CoreDragOperation.AllowedOperations den vollständigen Satz von Vorgängen angeben, die die Quelle zulässt, und DataPackage.RequestedOperation sollte den gewünschten Standardwert der Quelle angeben. Benutzer können diese Optionen überschreiben, indem sie UMSCHALT- und STRG-TASTEN verwenden. Ziel-Apps müssen den Schlüsselzustand überprüfen, um den vom Benutzer ausgewählten Vorgang zu ermitteln.
Hinweis
CoreDragOperation.AllowedOperations wird in XAML nicht unterstützt. Um mehrere zulässige Vorgänge in XAML anzugeben, übergeben Sie stattdessen mehrere Flags an die DataPackage.RequestedOperation-Eigenschaft. Wenn Sie dies tun, sollten Sie CoreDragOperation.AllowedOperations nicht an anderer Stelle festlegen. Dadurch wird eine Ausnahme ausgelöst und die angegebenen Flags von DataPackage.RequestedOperation auf eins zurückgesetzt.
Normalerweise sollte die DataPackage.RequestedOperation-Eigenschaft nur einen einzelnen Vorgang angeben. In einigen Interop-Szenarien (z. B. beim Kopieren zwischen einer Universelle Windows-Plattform-App (UWP) und Explorer) kann es jedoch mehr enthalten. In diesem Fall sollte die Ziel-App den besten Vorgang auswählen (vorausgesetzt, die Tastaturmodifizierer haben diese Wahl nicht überschrieben).
Sie benötigen diese Eigenschaft nicht für Freigabevorgänge.