DataObject DataObject DataObject DataObject Class

Définition

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.Provides a basic implementation of the IDataObject interface, which defines a format-independent mechanism for transferring data.

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
DataObjectDataObjectDataObjectDataObject
Implémente

Exemples

L'exemple suivant montre comment utiliser cette classe.The following example shows how to use this class.

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é.Calling methods from this class with untrusted data is a security risk. Appelez les méthodes de cette classe avec des données approuvées uniquement.Call the methods from this class only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Constructeurs

DataObject() DataObject() DataObject() DataObject()

Initialise une nouvelle instance de la classe DataObject.Initializes a new instance of the DataObject class.

DataObject(Object) DataObject(Object) DataObject(Object) DataObject(Object)

Initialise une nouvelle instance de la classe DataObject qui contient les données spécifiées.Initializes a new instance of the DataObject class that contains the specified data.

DataObject(String, Object) DataObject(String, Object) DataObject(String, Object) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.

DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. 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.This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.

DataObject(Type, Object) DataObject(Type, Object) DataObject(Type, Object) 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.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.

Champs

CopyingEvent CopyingEvent CopyingEvent CopyingEvent

Identifie l’événement attaché Copying.Identifies the Copying attached event.

PastingEvent PastingEvent PastingEvent PastingEvent

Identifie l’événement attaché Pasting.Identifies the Pasting attached event.

SettingDataEvent SettingDataEvent SettingDataEvent SettingDataEvent

Identifie l’événement attaché SettingData.Identifies the SettingData attached event.

Méthodes

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Ajoute un gestionnaire d’événements Copying à un objet de dépendance spécifié.Adds a Copying event handler to a specified dependency object.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Ajoute un gestionnaire d’événements Pasting à un objet de dépendance spécifié.Adds a Pasting event handler to a specified dependency object.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Ajoute un gestionnaire d’événements SettingData à un objet de dépendance spécifié.Adds a SettingData event handler to a specified dependency object.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

Interroge un objet de données sur la présence de données au format WaveAudio.Queries a data object for the presence of data in the WaveAudio data format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

Interroge un objet de données sur la présence de données au format FileDrop.Queries a data object for the presence of data in the FileDrop data format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Interroge un objet de données sur la présence de données au format Bitmap.Queries a data object for the presence of data in the Bitmap data format.

ContainsText() ContainsText() ContainsText() ContainsText()

Interroge un objet de données sur la présence de données au format UnicodeText.Queries a data object for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

Interroge un objet de données sur la présence de données au format de données texte.Queries a data object for the presence of data in a text data format.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

Renvoie un flux qui contient des données au format de données WaveAudio.Returns a stream that contains data in the WaveAudio data format.

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

Retourne des données dans un format spécifié par une chaîne.Returns data in a format specified by a string.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) 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é.Returns a data object in a specified format, optionally converting the data to the specified format.

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

Retourne un objet de données dans un format spécifié par un objet Type.Returns a data object in a format specified by a Type object.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) 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.Determines whether the data is available in, or can be converted to, a format specified by a string.

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) 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é.Determines whether the data is available in, or can be converted to, a specified format. 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.A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) 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.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

Retourne un ensemble de chaînes qui contient une liste de fichiers effacés.Returns a string collection that contains a list of dropped files.

GetFormats() GetFormats() GetFormats() 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.Returns a list of formats in which the data in this data object is stored, or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean)

Retourne une liste de formats dans laquelle les données dans cet objet de données sont stockées.Returns a list of formats in which the data in this data object is stored. Un indicateur Boolean indique s'il faut inclure également des formats auxquels les données peuvent être converties automatiquement.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetImage() GetImage() GetImage() GetImage()

Retourne un objet BitmapSource qui contient des données au format Bitmap.Returns a BitmapSource object that contains data in the Bitmap format.

GetText() GetText() GetText() GetText()

Retourne une chaîne qui contient les données UnicodeText dans cet objet de données.Returns a string that contains the UnicodeText data in this data object.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

Retourne une chaîne qui contient des données texte du format spécifié dans cet objet de données.Returns a string that contains text data of the specified format in this data object.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Supprime un gestionnaire d’événements Copying d’un objet de dépendance spécifié.Removes a Copying event handler from a specified dependency object.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Supprime un gestionnaire d’événements Pasting d’un objet de dépendance spécifié.Removes a Pasting event handler from a specified dependency object.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Supprime un gestionnaire d’événements SettingData d’un objet de dépendance spécifié.Removes a SettingData event handler from a specified dependency object.

SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

Stocke les données audio (format de données WaveAudio) dans cet objet de données.Stores audio data (WaveAudio data format) in this data object. Les données audio sont spécifiées en tant que tableau d'octets.The audio data is specified as a byte array.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

Stocke les données audio (format de données WaveAudio) dans cet objet de données.Stores audio data (WaveAudio data format) in this data object. Les données audio sont spécifiées en tant que flux de données.The audio data is specified as a stream.

SetData(Object) SetData(Object) SetData(Object) 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.Stores the specified data in this data object, automatically determining the data format from the source object type.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, 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 une chaîne.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a string.

SetData(String, Object, Boolean) SetData(String, Object, Boolean) SetData(String, Object, Boolean) 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.Stores the specified data in this data object, along with one or more specified data formats. 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.This overload includes a Boolean flag to indicate whether the data can be converted to another format on retrieval.

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) 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.Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a Type object.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

Stocke des données FileDrop dans cet objet de données.Stores FileDrop data in this data object. La liste des fichiers effacés est spécifiée comme un ensemble de chaînes.The dropped file list is specified as a string collection.

SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource)

Stocke des données Bitmap dans cet objet de données.Stores Bitmap data in this data object. La donnée image est spécifiée en tant que BitmapSource.The image data is specified as a BitmapSource.

SetText(String) SetText(String) SetText(String) SetText(String)

Stocke des données UnicodeText, spécifiées en tant que chaîne, dans cet objet de données.Stores UnicodeText data, specified as a string, in this data object.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

Stocke des données texte dans cet objet de données.Stores text data in this data object. Le format des données texte à stocker est spécifié avec un membre de TextDataFormat.The format of the text data to store is specified with a member of TextDataFormat.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements attachés

Copying Copying Copying 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.Occurs when the associated dependency object has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard or begin a drag-and-drop operation.

Pasting Pasting Pasting Pasting

Se produit lorsque l'objet de dépendance associé est prêt à coller des données.Occurs when the associated dependency object is ready to paste data.

SettingData SettingData SettingData SettingData

Se produit lorsque l'objet de dépendance associé essaie d'ajouter un nouveau format de données à un DataObject.Occurs when the associated dependency object attempts to add a new data format to a DataObject.

Implémentations d’interfaces explicites

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Crée une connexion entre un objet de données et un récepteur de notifications.Creates a connection between a data object and an advisory sink. 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.This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32)

Détruit une connexion de notifications qui avait été établie précédemment.Destroys a notification connection that had been previously established.

IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA)

Crée un objet qui peut être utilisé pour énumérer les connexions de notifications actuelles.Creates an object that can be used to enumerate the current advisory connections.

IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR)

Crée un objet pour l'énumération des structures FORMATETC d'un objet de données.Creates an object for enumerating the FORMATETC structures for a data object. Ces structures sont utilisées dans les appels à GetData(FORMATETC, STGMEDIUM) ou à SetData(FORMATETC, STGMEDIUM, Boolean).These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Fournit une structure FORMATETC standard qui équivaut logiquement à une structure plus complexe.Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. 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.Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.

IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM)

Obtient des données à partir d'un objet de données source.Obtains data from a source data object. 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.The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. L'appelant est ensuite chargé de libérer la structure STGMEDIUM.The caller then assumes responsibility for releasing the STGMEDIUM structure.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Obtient des données à partir d'un objet de données source.Obtains data from a source data object. 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é.This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.

IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC)

Détermine si l'objet de données est capable de rendre les données décrites dans la structure FORMATETC.Determines whether the data object is capable of rendering the data described in the FORMATETC structure. 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.Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Transfère des données vers l'objet qui implémente cette méthode.Transfers data to the object that implements this method. Cette méthode est appelée par un objet qui contient une source de données.This method is called by an object that contains a data source.

S’applique à

Voir aussi