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
public interface IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
Dérivé
Attributs

Remarques

L’interface IDataObject est utilisée par la classe Clipboard 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, les méthodes IDataObject 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 de IDataObject, appelez la méthode SetData et spécifiez le format de données dans le paramètre format.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Définissez le paramètre autoConvert sur false 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 des données dans plusieurs formats.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 à partir d’un IDataObject en appelant la méthode GetData et en spécifiant le format de données dans le paramètre format.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Définissez le paramètre autoConvert sur false 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 pas autoConvert.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 IDataObject suivantes.To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Appelez la méthode GetFormats 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. Définissez le paramètre autoConvert sur false pour récupérer uniquement 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, définissez autoConvert sur trueou 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 méthode GetDataPresent 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é, définissez le paramètre autoConvert sur false.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

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

Méthodes

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(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.

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.

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(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.

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.

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)

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)

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, 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.

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)

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.

S’applique à

Voir aussi