IDataObject Interface

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fournit un mécanisme indépendant du format destiné au transfert de données.

public interface class IDataObject

public interface IDataObject

type IDataObject = interface

Public Interface IDataObject

Dérivé

System.Windows.Forms.DataObject

Remarques

L’interface IDataObject est utilisée par la Clipboard classe et dans les opérations de glisser-déplacer.

Lorsqu’elles sont implémentées dans une classe, les IDataObject méthodes permettent à l’utilisateur de stocker des données dans plusieurs formats dans une instance de la classe. Le stockage de données dans plusieurs formats augmente le risque qu’une application cible, dont vous ne connaissez pas les exigences de format, puisse récupérer les données stockées. Pour stocker des données dans une instance de IDataObject, appelez la SetData méthode et spécifiez le format des données dans le format paramètre . Définissez le autoConvert paramètre sur false si vous ne souhaitez pas que les données stockées soient converties dans un autre format lors de leur récupération. Appelez SetData plusieurs fois sur une instance de pour stocker des IDataObject données dans plusieurs formats.

Vous récupérez des données stockées à partir d’un IDataObject en appelant la GetData méthode et en spécifiant le format des données dans le format paramètre . Définissez le autoConvert paramètre sur false pour récupérer uniquement les données stockées dans le format spécifié. Pour convertir les données stockées au format spécifié, définissez sur autoConverttrueou n’utilisez autoConvertpas .

Pour déterminer les formats des données stockées dans un IDataObject, utilisez les méthodes suivantes IDataObject .

• Appelez la GetFormats méthode pour récupérer un tableau de tous les formats dans lesquels les données sont disponibles. Définissez le autoConvert paramètre sur false pour obtenir uniquement les formats dans lesquels les données sont stockées. Pour obtenir tous les formats dans lesquels les données sont disponibles, définissez autoConverttruesur , ou n’utilisez pas ce paramètre.

• Appelez la GetDataPresent méthode pour déterminer si les données stockées sont disponibles dans un certain format. Si vous ne souhaitez pas que les données stockées soient converties au format spécifié, définissez le autoConvert paramètre sur false.

Consultez la DataObject classe pour une implémentation de cette interface. Consultez la DataFormats classe pour connaître les formats de données prédéfinis Clipboard .

Méthodes

GetData(String)	Récupère les données associées au format de données spécifié.
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é.
GetData(Type)	Récupère les données associées au format du type classe spécifié.
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é.
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é.
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é.
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.
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.
SetData(Object)	Stocke les données spécifiées dans cette instance à l'aide de la classe des données correspondant au format.
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.
SetData(String, Object)	Stocke les données spécifiées et le format associé dans cette instance.
SetData(Type, Object)	Stocke les données spécifiées et le type classe associé dans cette instance.

Voir aussi

• DataObject
• DataFormats