IDataObject IDataObject IDataObject IDataObject Interface

Définition

Fournit un mécanisme indépendant du format destiné au transfert de données.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
Dérivé
Attributs

Remarques

L' IDataObject interface est utilisée par la Clipboard classe et les opérations de glisser-déplacer.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

En cas d’implémentation dans une classe IDataObject , les méthodes permettent à l’utilisateur de stocker des données dans plusieurs formats dans une instance de la classe.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. Le stockage de données dans plus d’un format augmente le risque qu’une application cible, dont les exigences de format ne soient pas connues, puisse récupérer les données stockées.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. Pour stocker des données dans une instance IDataObjectde, appelez SetData la méthode et spécifiez le format de format données dans le paramètre.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Affectez autoConvert au false paramètre la valeur si vous ne souhaitez pas que les données stockées soient converties dans un autre format lorsqu’elles sont récupérées.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. Appelez SetData plusieurs fois sur une instance de IDataObject pour stocker les données dans plus d’un format.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

Vous récupérez les données stockées IDataObject à partir d' GetData un en appelant la méthode et en spécifiant le format de données dans le format paramètre.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Affectez autoConvert au false paramètre la valeur pour récupérer uniquement les données qui ont été stockées dans le format spécifié.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. Pour convertir les données stockées dans le format spécifié, définissez autoConvert sur trueou n’utilisez autoConvertpas.To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

Pour déterminer les formats des données stockées dans un IDataObject, utilisez les méthodes suivantes. IDataObjectTo determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Appelez la GetFormats méthode pour récupérer un tableau de tous les formats dans lesquels les données sont disponibles.Call the GetFormats method to retrieve an array of all the formats in which the data is available. Affectez autoConvert au false paramètre la valeur pour n’afficher que les formats dans lesquels les données sont stockées.Set the autoConvert parameter to false to get only the formats in which the data is stored. Pour récupérer tous les formats dans lesquels les données sont disponibles, affectez truela valeur autoConvert à, ou n’utilisez pas ce paramètre.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • Appelez la GetDataPresent méthode pour déterminer si les données stockées sont disponibles dans un format spécifique.Call the GetDataPresent method to determine whether stored data is available in a certain format. Si vous ne souhaitez pas que les données stockées soient converties au format spécifié, autoConvert affectez falseau paramètre la valeur.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

Consultez la DataObject classe pour une implémentation de cette interface.See the DataObject class for an implementation of this interface. Consultez la DataFormats classe pour les formats de Clipboard données prédéfinis.See the DataFormats class for the predefined Clipboard data formats.

Méthodes

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

Récupère les données associées au format de données spécifié.Retrieves the data associated with the specified data format.

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

Récupère les données associées au format du type classe spécifié.Retrieves the data associated with the specified class type format.

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

Récupère les données associées au format de données spécifié, grâce à une valeur booléenne permettant de déterminer si les données doivent être converties dans le format spécifié.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)

Détermine si les données stockées dans cette instance sont associées au format spécifié ou si elles peuvent être converties dans le format spécifié.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)

Détermine si les données stockées dans cette instance sont associées au format spécifié ou si elles peuvent être converties dans le format spécifié.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)

Détermine si les données stockées dans cette instance sont associées au format spécifié, grâce à une valeur booléenne permettant de déterminer si les données doivent être converties dans le format spécifié.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()

Retourne la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties.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)

Obtient la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties, grâce à une valeur booléenne permettant de déterminer si seuls les formats natifs ou si l'ensemble des formats dans lesquels les données peuvent être converties doivent être récupérés.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)

Stocke les données spécifiées dans cette instance à l'aide de la classe des données correspondant au format.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)

Stocke les données spécifiées et le format associé dans cette instance.Stores the specified data and its associated format in this instance.

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

Stocke les données spécifiées et le type classe associé dans cette instance.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)

Stocke dans cette instance les données spécifiées et les formats associés, à l'aide d'une valeur booléenne permettant d'indiquer si les données peuvent être converties dans un autre format.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.

S’applique à

Voir aussi