Leggere in inglese

Condividi tramite

IDataObject Interfaccia

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornisce un meccanismo indipendente dal formato per il trasferimento dei dati.

C# 
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
C# 
public interface IDataObject
Derivato
Attributi
ComVisibleAttribute

Commenti

L'interfaccia IDataObjectClipboard viene usata dalla classe e nelle operazioni di trascinamento.

Quando implementato in una classe, i metodi consentono all'utente di archiviare i IDataObject dati in più formati in un'istanza della classe. L'archiviazione dei dati in più di un formato aumenta la possibilità che un'applicazione di destinazione, i cui requisiti di formato potrebbero non essere noti, può recuperare i dati archiviati. Per archiviare i dati in un'istanza di IDataObject, chiamare il metodo e specificare il SetData formato dei dati nel format parametro. Impostare il autoConvert parametro su false se non si desidera convertire i dati archiviati in un altro formato quando viene recuperato. Richiamare SetData più volte in un'istanza di IDataObject per archiviare i dati in più formati.

I dati archiviati vengono recuperati da un oggetto IDataObject chiamando il metodo e specificando il GetData formato dei dati nel format parametro. Impostare il autoConvert parametro su per false recuperare solo i dati archiviati nel formato specificato. Per convertire i dati archiviati nel formato specificato, impostare autoConvert su trueo non usare autoConvert.

Per determinare i formati dei dati archiviati in un IDataObjectoggetto , usare i metodi seguenti IDataObject .

  • Chiamare il GetFormats metodo per recuperare una matrice di tutti i formati in cui sono disponibili i dati. Impostare il autoConvert parametro su false per ottenere solo i formati in cui vengono archiviati i dati. Per ottenere tutti i formati in cui sono disponibili i dati, impostare autoConvert su trueo non usare questo parametro.

  • Chiamare il metodo per determinare se i GetDataPresent dati archiviati sono disponibili in un determinato formato. Se non si desidera che i dati archiviati vengano convertiti nel formato specificato, impostare il autoConvert parametro su false.

Vedere la DataObject classe per un'implementazione di questa interfaccia. Vedere la DataFormats classe per i formati di dati predefiniti Clipboard .

Metodi

GetData(String)

Recupera i dati associati al formato dati specificato.
GetData(String, Boolean)

Recupera i dati associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.
GetData(Type)

Recupera i dati associati al formato del tipo di classe specificato.
GetDataPresent(String)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.
GetDataPresent(String, Boolean)

Determina se i dati memorizzati nell'istanza sono associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.
GetDataPresent(Type)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.
GetFormats()

Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa istanza o nei quali possono essere convertiti.
GetFormats(Boolean)

Ottiene un elenco di tutti i formati ai quali i dati memorizzati in questa istanza sono associati o nei quali possono essere convertiti, utilizzando un valore Boolean per determinare se recuperare tutti i formati in cui possono essere convertiti i dati o solo i formati nativi dei dati.
SetData(Object)

Memorizza i dati specificati in questa istanza, utilizzando la classe dei dati per il formato.
SetData(String, Boolean, Object)

Memorizza i dati specificati e il formato associato nell'istanza utilizzando un valore Boolean per specificare se i dati possono essere convertiti in un altro formato.
SetData(String, Object)

Memorizza nell'istanza i dati specificati e il formato associato.
SetData(Type, Object)

Memorizza i dati specificati e il tipo di classe associata in questa istanza.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Vedi anche