DataPackage.RequestedOperation Proprietà

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Specifica l'oggetto DataPackageOperation (nessuno, spostare, copiare o collegare) per l'operazione.

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

Valore della proprietà

DataPackageOperation

Operazione richiesta dall'app di origine.

Esempio

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

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

Commenti

Questa proprietà specifica l'operazione che il consumer di un pacchetto di dati deve eseguire negli Appunti o negli scenari di trascinamento della selezione. Le opzioni supportate sono specificate nell'enumerazione DataPackageOperation .

Quando si implementa la funzionalità degli Appunti, DataPackageOperation.Move corrisponde al comando "Cut" e al comando DataPackageOperation.Copy in "Copy". È l'obiettivo dell'operazione rispettare questo valore e segnalare che hanno eseguito un taglio o una copia chiamando DataPackageView.ReportOperationComplete con il valore appropriato.

Negli scenari di trascinamento della selezione CoreDragOperation.AllowedOperations deve specificare il set completo di operazioni consentite dall'origine e DataPackage.RequestedOperation deve specificare il valore predefinito desiderato per l'origine. Gli utenti possono eseguire l'override di queste scelte usando MAIUSC e CTRL . Le app di destinazione devono controllare lo stato della chiave per determinare l'operazione selezionata dall'utente.

Nota

CoreDragOperation.AllowedOperations non è supportato in XAML. Per specificare più operazioni consentite in XAML, passare più flag alla proprietà DataPackage.RequestedOperation. In caso contrario, non è consigliabile impostare CoreDragOperation.AllowedOperations altrove. In questo modo verrà generata un'eccezione e verranno reimpostati i flag specificati di DataPackage.RequestedOperation su uno.

In genere, la proprietà DataPackage.RequestedOperation deve specificare solo una singola operazione. In alcuni scenari di interoperabilità, ad esempio la copia tra un'app piattaforma UWP (Universal Windows Platform) (UWP) e Esplora file, può contenere altro. In questo caso, l'app di destinazione deve selezionare l'operazione migliore (presupponendo che i modificatori della tastiera non abbiano eseguito l'override di tale scelta).

Questa proprietà non è necessaria per le operazioni di condivisione.

Vedi anche

• DataPackageOperation