DataPackage.RequestedOperation 屬性

定義

命名空間:

Windows.ApplicationModel.DataTransfer

指定作業的 DataPackageOperation (無、移動、複製或連結) 。

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 DataPackageOperation

屬性值

DataPackageOperation

來源應用程式所要求的作業。

範例

// Request a copy operation 
datapackage.RequestedOperation = DataPackageOperation.Copy;

// find what the requested operation is
DataPackageOperation operation = dataPackageView.RequestedOperation;

備註

這個屬性會指定資料封裝取用者應在剪貼簿或拖放案例中執行的作業。 支援的選項是在 DataPackageOperation 列舉中指定。

實作剪貼簿功能時， DataPackageOperation.Move 會對應至 「Cut」 命令，並將 DataPackageOperation.Copy 對應至 「Copy」 命令。 作業的責任是遵守此值，並報告他們以適當的值呼叫 DataPackageView.ReportOperationComplete 來執行剪下或複製。

在拖放案例中， CoreDragOperation.AllowedOperations 應該指定來源允許的一組完整作業，而 DataPackage.RequestedOperation 應該指定來源所需的預設值。 使用者可以使用 SHIFT 和 CTRL 鍵覆寫此選項。 目標應用程式必須檢查金鑰狀態，以判斷使用者選取的作業。

注意

XAML 不支援CoreDragOperation.AllowedOperations。 若要在 XAML 中指定多個允許的作業，請改為將多個旗標傳遞至 DataPackage.RequestedOperation 屬性。 如果您這麼做，就不應該在其他地方設定 CoreDragOperation.AllowedOperations 。 這麼做會擲回例外狀況，並將 DataPackage.RequestedOperation 的指定旗標重設為一個。

通常，DataPackage.RequestedOperation 屬性應該只指定單一作業。 不過，在某些 Interop 案例中， (例如在通用 Windows 平臺 (UWP) 應用程式和檔案總管) 之間複製，可以包含更多內容。 在此情況下，目標應用程式應該選取最佳作業 (假設鍵盤修飾詞尚未覆寫該選擇) 。

共用作業不需要這個屬性。

另請參閱

• DataPackageOperation