DataPackage.RequestedOperation Propriedade

Definição

Namespace:

Windows.ApplicationModel.DataTransfer

Especifica o DataPackageOperation (nenhum, movimento, cópia ou link) para a operação.

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

Valor da propriedade

DataPackageOperation

A operação solicitada pelo aplicativo de origem.

Exemplos

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

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

Comentários

Essa propriedade especifica a operação que o consumidor de um pacote de dados deve executar na área de transferência ou em cenários de arrastar e soltar. As opções com suporte são especificadas na enumeração DataPackageOperation .

Ao implementar a funcionalidade da área de transferência, DataPackageOperation.Move corresponde ao comando "Cut" e ao comando DataPackageOperation.Copy para "Copy". É o destino da responsabilidade da operação respeitar esse valor e relatar que eles executaram um corte ou cópia chamando DataPackageView.ReportOperationComplete com o valor apropriado.

Em cenários de arrastar e soltar, CoreDragOperation.AllowedOperations deve especificar o conjunto completo de operações que a origem permite e DataPackage.RequestedOperation deve especificar o padrão desejado da fonte. Os usuários podem substituir essas opções usando as chaves SHIFT e CTRL . Os aplicativos de destino devem inspecionar o estado da chave para determinar a operação selecionada pelo usuário.

Observação

CoreDragOperation.AllowedOperations não tem suporte no XAML. Para especificar mais de uma operação permitida em XAML, passe vários sinalizadores para a propriedade DataPackage.RequestedOperation. Se você fizer isso, não deverá definir CoreDragOperation.AllowedOperations em outro lugar. Isso gerará uma exceção e redefinirá os sinalizadores especificados de DataPackage.RequestedOperation para um.

Normalmente, a propriedade DataPackage.RequestedOperation deve especificar apenas uma única operação. No entanto, em alguns cenários de interoperabilidade (como copiar entre um aplicativo UWP (Plataforma Universal do Windows) e Explorador de Arquivos), ele pode conter mais. Nesse caso, o aplicativo de destino deve selecionar a melhor operação (supondo que os modificadores de teclado não tenham substituído essa escolha).

Você não precisa dessa propriedade para compartilhar operações.

Confira também

• DataPackageOperation