DataObject Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Fournit une implémentation de base de l'interface IDataObject qui définit un mécanisme indépendant du format pour transférer des données.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject

public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject

Public NotInheritable Class DataObject
Implements IDataObject, IDataObject

Héritage

Object

DataObject

Implémente

IDataObject IDataObject

Exemples

L'exemple suivant montre comment utiliser cette classe.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

Remarques

Important

L’appel de méthodes de cette classe avec des données non approuvées est un risque de sécurité. Appelez les méthodes de cette classe avec des données approuvées uniquement. Pour plus d’informations, consultez Valider toutes les entrées.

Constructeurs

DataObject()	Initialise une nouvelle instance de la classe DataObject.
DataObject(Object)	Initialise une nouvelle instance de la classe DataObject qui contient les données spécifiées.
DataObject(String, Object)	Initialise une nouvelle instance de la classe DataObject qui contient les données spécifiées et leur format associé ; le format est spécifié par une chaîne.
DataObject(String, Object, Boolean)	Initialise une nouvelle instance de la classe DataObject qui contient les données spécifiées et leur format associé ; le format est spécifié par une chaîne. Cette surcharge inclut un indicateur Boolean pour indiquer si les données peuvent être converties dans un autre format lors de la récupération.
DataObject(Type, Object)	Initialise une nouvelle instance de la classe DataObject qui contient les données spécifiées et leur format associé ; le format de données est spécifié par un objet Type.

Champs

CopyingEvent	Identifie l’événement attaché Copying.
PastingEvent	Identifie l’événement attaché Pasting.
SettingDataEvent	Identifie l’événement attaché SettingData.

Méthodes

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Ajoute un gestionnaire d’événements Copying à un objet de dépendance spécifié.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Ajoute un gestionnaire d’événements Pasting à un objet de dépendance spécifié.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Ajoute un gestionnaire d’événements SettingData à un objet de dépendance spécifié.
ContainsAudio()	Interroge un objet de données sur la présence de données au format WaveAudio.
ContainsFileDropList()	Interroge un objet de données sur la présence de données au format FileDrop.
ContainsImage()	Interroge un objet de données sur la présence de données au format Bitmap.
ContainsText()	Interroge un objet de données sur la présence de données au format UnicodeText.
ContainsText(TextDataFormat)	Interroge un objet de données sur la présence de données au format de données texte.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetAudioStream()	Renvoie un flux qui contient des données au format de données WaveAudio.
GetData(String)	Retourne des données dans un format spécifié par une chaîne.
GetData(String, Boolean)	Retourne un objet de données dans un format spécifié, en convertissant de façon facultative les données en format spécifié.
GetData(Type)	Retourne un objet de données dans un format spécifié par un objet Type.
GetDataPresent(String)	Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par une chaîne.
GetDataPresent(String, Boolean)	Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié. Un indicateur Boolean indique s'il faut vérifier si les données peuvent être converties au format spécifié si elles ne sont pas disponibles dans ce format.
GetDataPresent(Type)	Détermine si les données sont disponibles dans un format spécifié ou peuvent être converties en un format spécifié par un objet Type.
GetFileDropList()	Retourne un ensemble de chaînes qui contient une liste de fichiers effacés.
GetFormats()	Retourne une liste de formats dans laquelle les données de cet objet de données sont stockées ou vers laquelle elles peuvent être converties.
GetFormats(Boolean)	Retourne une liste de formats dans laquelle les données dans cet objet de données sont stockées. Un indicateur Boolean indique s'il faut inclure également des formats auxquels les données peuvent être converties automatiquement.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetImage()	Retourne un objet BitmapSource qui contient des données au format Bitmap.
GetText()	Retourne une chaîne qui contient les données UnicodeText dans cet objet de données.
GetText(TextDataFormat)	Retourne une chaîne qui contient des données texte du format spécifié dans cet objet de données.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Supprime un gestionnaire d’événements Copying d’un objet de dépendance spécifié.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Supprime un gestionnaire d’événements Pasting d’un objet de dépendance spécifié.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Supprime un gestionnaire d’événements SettingData d’un objet de dépendance spécifié.
SetAudio(Byte[])	Stocke les données audio (format de données WaveAudio) dans cet objet de données. Les données audio sont spécifiées en tant que tableau d'octets.
SetAudio(Stream)	Stocke les données audio (format de données WaveAudio) dans cet objet de données. Les données audio sont spécifiées en tant que flux de données.
SetData(Object)	Stocke les données spécifiées dans cet objet de données, en déterminant automatiquement le format de données du type d'objet source.
SetData(String, Object)	Stocke les données spécifiées dans cet objet de données, ainsi qu’un ou plusieurs formats de données spécifiés ; le format de données est spécifié par une chaîne.
SetData(String, Object, Boolean)	Stocke les données spécifiées dans cet objet de données, avec un ou plusieurs formats de données spécifiés. Cette surcharge inclut un indicateur Boolean pour indiquer si les données peuvent être converties en un autre format lors de la récupération.
SetData(Type, Object)	Stocke les données spécifiées dans cet objet de données, avec un ou plusieurs formats de données spécifiés ; le format de données est spécifié par un objet Type.
SetFileDropList(StringCollection)	Stocke des données FileDrop dans cet objet de données. La liste des fichiers effacés est spécifiée comme un ensemble de chaînes.
SetImage(BitmapSource)	Stocke des données Bitmap dans cet objet de données. La donnée image est spécifiée en tant que BitmapSource.
SetText(String)	Stocke des données UnicodeText, spécifiées en tant que chaîne, dans cet objet de données.
SetText(String, TextDataFormat)	Stocke des données texte dans cet objet de données. Le format des données texte à stocker est spécifié avec un membre de TextDataFormat.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements attachés

Copying	Se produit quand l’objet de dépendance associé a préparé des formats de données appropriés qui représentent la sélection de copie, a ajouté des formats de sélection de copie à un DataObject, et est prêt à placer DataObject sur Clipboard ou à commencer une opération de glisser-déplacer.
Pasting	Se produit quand l’objet de dépendance associé est prêt à coller des données.
SettingData	Se produit quand l’objet de dépendance associé tente d’ajouter un nouveau format de données à DataObject.

Implémentations d’interfaces explicites

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Crée une connexion entre un objet de données et un récepteur de notifications. Cette méthode est appelée par un objet qui prend en charge un récepteur de notifications et elle lui permet d'être averti des modifications apportées aux données de l'objet.
IDataObject.DUnadvise(Int32)	Détruit une connexion de notifications qui avait été établie précédemment.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Crée un objet qui peut être utilisé pour énumérer les connexions de notifications actuelles.
IDataObject.EnumFormatEtc(DATADIR)	Crée un objet pour l'énumération des structures FORMATETC d'un objet de données. Ces structures sont utilisées dans les appels à GetData(FORMATETC, STGMEDIUM) ou à SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Fournit une structure FORMATETC standard qui équivaut logiquement à une structure plus complexe. Utilisez cette méthode pour déterminer si deux structures FORMATETC différentes retourneraient les mêmes données, rendant ainsi superflu le rendu en double.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Obtient des données à partir d'un objet de données source. La méthode GetData(FORMATETC, STGMEDIUM) qui est appelée par un consommateur de données rend les données décrites dans la structure FORMATETC spécifiée et les transfère par l'intermédiaire de la structure STGMEDIUM spécifiée. L'appelant est ensuite chargé de libérer la structure STGMEDIUM.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Obtient des données à partir d'un objet de données source. Cette méthode, qui est appelée par un consommateur de données, diffère de la méthode GetData(FORMATETC, STGMEDIUM) en ce sens que l'appelant doit allouer et libérer le support de stockage spécifié.
IDataObject.QueryGetData(FORMATETC)	Détermine si l'objet de données est capable de rendre les données décrites dans la structure FORMATETC. Les objets qui tentent une opération de collage ou de déplacement peuvent appeler cette méthode avant d'appeler GetData(FORMATETC, STGMEDIUM) pour obtenir savoir si l'opération a des chances de réussir.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Transfère des données vers l'objet qui implémente cette méthode. Cette méthode est appelée par un objet qui contient une source de données.

Voir aussi

• Charger un exemple de fichier supprimé