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 соответствует команде "Вырезать" и Команде DataPackageOperation.Copy в "Копировать". Задача операции заключается в том, чтобы учитывать это значение и сообщать о том, что они выполнили вырезание или копирование, вызвав DataPackageView.ReportOperationComplete с соответствующим значением.

В сценариях перетаскивания CoreDragOperation.AllowedOperations должен указывать полный набор операций, разрешенных источником, а DataPackage.RequestedOperation — требуемое значение по умолчанию источника. Пользователи могут переопределить эти параметры с помощью клавиш SHIFT и CTRL . Целевые приложения должны проверять состояние ключа, чтобы определить операцию, выбранную пользователем.

Примечание

CoreDragOperation.AllowedOperations не поддерживается в XAML. Чтобы указать несколько разрешенных операций в XAML, передайте несколько флагов в свойство DataPackage.RequestedOperation. В этом случае не следует задавать CoreDragOperation.AllowedOperations в другом месте. Это приведет к возникновению исключения и сбросу указанных флагов DataPackage.RequestedOperation до одного.

Обычно свойство DataPackage.RequestedOperation должно указывать только одну операцию. Однако в некоторых сценариях взаимодействия (например, при копировании между приложением универсальная платформа Windows (UWP) и проводник) он может содержать больше. В этом случае целевое приложение должно выбрать оптимальную операцию (при условии, что модификаторы клавиатуры не переопределяют этот вариант).

Это свойство не требуется для операций общего доступа.

См. также раздел

• DataPackageOperation