Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

IDataObject, interface

.NET Framework 4.5

Autres versions

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

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans System.Windows.Forms.dll)

Syntaxe

C++

[ComVisibleAttribute(true)]
public interface IDataObject

Méthodes

	Nom	Description
	GetData(String)	Récupère les données associées au format de données spécifié.
	GetData(Type)	Récupère les données associées au format du type classe 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é.
	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(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é.
	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é.
	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, 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.
	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.

Début

Notes

L'interface IDataObject est utilisée par la classe Clipboard et au cours d'opérations glisser-déplacer.

Une fois implémentées dans une classe, les méthodes IDataObject permettent à l'utilisateur de stocker des données dans plusieurs formats dans une instance de cette classe. Le stockage de données dans plusieurs formats augmente les chances de récupération des données stockées par une application cible dont vous ignoreriez les exigences de format. Pour stocker des données dans une instance de IDataObject, appelez la méthode SetData et spécifiez le format des données dans format. Affectez la valeur false au paramètre autoConvert 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 reprises dans une instance de IDataObject pour pouvoir stocker des données dans plusieurs formats.

Pour récupérer les données stockées de IDataObject, vous devez appeler la méthode GetData et spécifier le format de données dans le paramètre format. Affectez false au paramètre autoConvert pour ne récupérer que les données ayant été stockées dans le format spécifié. Pour convertir les données stockées au format spécifié, affectez true à autoConvert ou n'utilisez pas autoConvert.

Pour déterminer les formats des données stockées dans une classe IDataObject, utilisez les méthodes IDataObject suivantes :

Appelez la méthode GetFormats pour récupérer le tableau de tous les formats dans lesquels les données sont disponibles. Affectez false au paramètre autoConvert pour n'obtenir que les formats dans lesquels les données sont stockées. Pour obtenir tous les formats dans lesquels les données sont disponibles, affectez la valeur true au paramètre autoConvert ou n'utilisez pas ce paramètre.
Appelez la méthode GetDataPresent pour déterminer si les données stockées sont disponibles dans un format donné. Affectez false au paramètre autoConvert si vous ne souhaitez pas que les données stockées soient converties dans le format spécifié.

Pour une implémentation de cette interface, consultez la classe DataObject. Pour obtenir les formats de données Clipboard prédéfinis, consultez la classe DataFormats.

Informations de version

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi

Référence

System.Windows.Forms, espace de noms

DataObject

DataFormats

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER