IDataObject IDataObject IDataObject IDataObject Interface

Definizione

Fornisce un meccanismo indipendente dal formato per il trasferimento dei dati.Provides a format-independent mechanism for transferring data.

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
Derivato
Attributi

Commenti

L' IDataObject interfaccia viene utilizzata Clipboard dalla classe e nelle operazioni di trascinamento della selezione.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

Una volta implementato in una classe, IDataObject i metodi consentono all'utente di archiviare i dati in più formati in un'istanza della classe.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. L'archiviazione dei dati in più formati aumenta la probabilità che un'applicazione di destinazione, i cui requisiti di formato non si conoscano, possano recuperare i dati archiviati.Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. Per archiviare i dati in un'istanza IDataObjectdi, chiamare SetData il metodo e specificare format il formato dei dati nel parametro.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Impostare il autoConvert parametro su false se non si desidera che i dati archiviati vengano convertiti in un altro formato quando vengono recuperati.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. Richiamare SetData più volte in un'istanza di IDataObject per archiviare i dati in più di un formato.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

Recuperare i dati archiviati da un IDataObject oggetto chiamando il GetData metodo e specificando format il formato dati nel parametro.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Impostare il autoConvert parametro su false per recuperare solo i dati archiviati nel formato specificato.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. Per convertire i dati archiviati nel formato specificato, impostare autoConvert su trueo non utilizzare autoConvert.To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

Per determinare i formati dei dati archiviati in un oggetto IDataObject, utilizzare i metodi IDataObject seguenti.To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Chiamare il GetFormats metodo per recuperare una matrice di tutti i formati in cui sono disponibili i dati.Call the GetFormats method to retrieve an array of all the formats in which the data is available. Impostare il autoConvert parametro su false per ottenere solo i formati in cui sono archiviati i dati.Set the autoConvert parameter to false to get only the formats in which the data is stored. Per ottenere tutti i formati in cui sono disponibili i dati, impostare autoConvert su trueo non utilizzare questo parametro.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • Chiamare il GetDataPresent metodo per determinare se i dati archiviati sono disponibili in un determinato formato.Call the GetDataPresent method to determine whether stored data is available in a certain format. Se non si desidera che i dati archiviati vengano convertiti nel formato specificato, impostare il autoConvert parametro su false.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

Vedere la DataObject classe per un'implementazione di questa interfaccia.See the DataObject class for an implementation of this interface. Vedere la DataFormats classe per i formati di Clipboard dati predefiniti.See the DataFormats class for the predefined Clipboard data formats.

Metodi

GetData(String) GetData(String) GetData(String) GetData(String)

Recupera i dati associati al formato dati specificato.Retrieves the data associated with the specified data format.

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

Recupera i dati associati al formato del tipo di classe specificato.Retrieves the data associated with the specified class type format.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

Recupera i dati associati al formato dati specificato, utilizzando un valore Boolean per determinare se convertire i dati in tale formato.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type)

Determina se i dati memorizzati in questa istanza sono associati al formato specificato o vi possono essere convertiti.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) 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.Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetFormats() GetFormats() GetFormats() GetFormats()

Restituisce un elenco di tutti i formati ai quali sono associati i dati memorizzati in questa istanza o nei quali possono essere convertiti.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) 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.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object) SetData(Object) SetData(Object) SetData(Object)

Memorizza i dati specificati in questa istanza, utilizzando la classe dei dati per il formato.Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

Memorizza nell'istanza i dati specificati e il formato associato.Stores the specified data and its associated format in this instance.

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) SetData(Type, Object)

Memorizza i dati specificati e il tipo di classe associata in questa istanza.Stores the specified data and its associated class type in this instance.

SetData(String, Boolean, Object) SetData(String, Boolean, Object) SetData(String, Boolean, Object) 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.Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

Si applica a

Vedi anche