DataObject DataObject DataObject DataObject Class

Definition

Stellt eine grundlegende Implementierung der IDataObject-Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert.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
Vererbung
DataObjectDataObjectDataObjectDataObject
Implementiert

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Klasse veranschaulicht.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)

Hinweise

Wichtig

Das Aufrufen von Methoden aus dieser Klasse mit nicht vertrauenswürdigen Daten stellt ein Sicherheitsrisiko dar.Calling methods from this class with untrusted data is a security risk. Rufen Sie die Methoden aus dieser Klasse nur mit vertrauenswürdigen Daten auf.Call the methods from this class only with trusted data. Weitere Informationen finden Sie unter Data Validation (Datenüberprüfung).For more information, see Data Validation.

Konstruktoren

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

Initialisiert eine neue Instanz der DataObject-Klasse.Initializes a new instance of the DataObject class.

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

Initialisiert eine neue Instanz der DataObject-Klasse, die die angegebenen Daten enthält.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)

Initialisiert eine neue Instanz der DataObject-Klasse, die die angegebenen Daten und das zugeordnete Format enthält. Das Format wird durch eine Zeichenfolge angegeben.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)

Initialisiert eine neue Instanz der DataObject-Klasse, die die angegebenen Daten und das zugeordnete Format enthält. Das Format wird durch eine Zeichenfolge angegeben.Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. Diese Überladung umfasst ein Boolean-Flag, mit dem angegeben wird, ob die Daten beim Abrufen in ein anderes Format konvertiert werden können.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)

Initialisiert eine neue Instanz der DataObject-Klasse, die die angegebenen Daten und das zugeordnete Format enthält. Das Datenformat wird durch ein Type-Objekt angegeben.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.

Felder

CopyingEvent CopyingEvent CopyingEvent CopyingEvent

Bezeichnet das angefügte Copying-Ereignis.Identifies the Copying attached event.

PastingEvent PastingEvent PastingEvent PastingEvent

Bezeichnet das angefügte Pasting-Ereignis.Identifies the Pasting attached event.

SettingDataEvent SettingDataEvent SettingDataEvent SettingDataEvent

Bezeichnet das angefügte SettingData-Ereignis.Identifies the SettingData attached event.

Methoden

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

Fügt einem angegebenen Abhängigkeitsobjekt einen Copying-Ereignishandler hinzu.Adds a Copying event handler to a specified dependency object.

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

Fügt einem angegebenen Abhängigkeitsobjekt einen Pasting-Ereignishandler hinzu.Adds a Pasting event handler to a specified dependency object.

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

Fügt einem angegebenen Abhängigkeitsobjekt einen SettingData-Ereignishandler hinzu.Adds a SettingData event handler to a specified dependency object.

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

Fragt ein Datenobjekt auf das Vorhandensein von Daten im WaveAudio-Datenformat ab.Queries a data object for the presence of data in the WaveAudio data format.

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

Fragt ein Datenobjekt auf das Vorhandensein von Daten im FileDrop-Datenformat ab.Queries a data object for the presence of data in the FileDrop data format.

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

Fragt ein Datenobjekt auf das Vorhandensein von Daten im Bitmap-Datenformat ab.Queries a data object for the presence of data in the Bitmap data format.

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

Fragt ein Datenobjekt auf das Vorhandensein von Daten im UnicodeText-Format ab.Queries a data object for the presence of data in the UnicodeText format.

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

Fragt ein Datenobjekt auf das Vorhandensein von Daten in einem Textdatenformat ab.Queries a data object for the presence of data in a text data format.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einen Stream zurück, der Daten im WaveAudio-Datenformat enthält.Returns a stream that contains data in the WaveAudio data format.

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

Gibt Daten in einem durch eine Zeichenfolge angegebenen Format zurück.Returns data in a format specified by a string.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

Gibt ein Datenobjekt in einem angegebenen Format zurück und konvertiert die Daten optional in das angegebene Format.Returns a data object in a specified format, optionally converting the data to the specified format.

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

Gibt ein Datenobjekt in einem von einem Type-Objekt angegebenen Format zurück.Returns a data object in a format specified by a Type object.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.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)

Bestimmt, ob die Daten in einem angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.Determines whether the data is available in, or can be converted to, a specified format. Ein Boolean-Flag gibt an, ob überprüft werden soll, ob die Daten in das angegebene Format konvertiert werden können, wenn Sie in diesem Format nicht verfügbar sind.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)

Bestimmt, ob die Daten in einem durch ein Type-Objekt angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.Determines whether the data is available in, or can be converted to, a format specified by a Type object.

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

Gibt eine Zeichenfolgenauflistung zurück, die eine Liste abgelegter Dateien enthält.Returns a string collection that contains a list of dropped files.

GetFormats() GetFormats() GetFormats() GetFormats()

Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind oder in die sie konvertiert werden können.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)

Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind.Returns a list of formats in which the data in this data object is stored. Ein Boolean-Flag gibt an, ob auch Formate eingeschlossen werden sollen, in die die Daten automatisch konvertiert werden können.A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Gibt ein BitmapSource-Objekt zurück, das Daten im Bitmap-Format enthält.Returns a BitmapSource object that contains data in the Bitmap format.

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

Gibt eine Zeichenfolge zurück, die die UnicodeText-Daten in diesem Datenobjekt enthält.Returns a string that contains the UnicodeText data in this data object.

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

Gibt eine Zeichenfolge zurück, die Textdaten vom angegebenen Format in diesem Datenobjekt enthält.Returns a string that contains text data of the specified format in this data object.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Entfernt einen Copying-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.Removes a Copying event handler from a specified dependency object.

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

Entfernt einen Pasting-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.Removes a Pasting event handler from a specified dependency object.

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

Entfernt einen SettingData-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.Removes a SettingData event handler from a specified dependency object.

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

Speichert Audiodaten (WaveAudio-Datenformat) in diesem Datenobjekt.Stores audio data (WaveAudio data format) in this data object. Die Audiodaten werden als Bytearray angegeben.The audio data is specified as a byte array.

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

Speichert Audiodaten (WaveAudio-Datenformat) in diesem Datenobjekt.Stores audio data (WaveAudio data format) in this data object. Die Audiodaten werden als Stream angegeben.The audio data is specified as a stream.

SetData(Object) SetData(Object) SetData(Object) SetData(Object)

Speichert die angegebenen Daten in diesem Datenobjekt. Dabei wird das Datenformat automatisch anhand des Quellobjekttyps bestimmt.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)

Speichert die angegebenen Daten in diesem Datenobjekt, zusammen mit einem oder mehreren angegebenen Datenformaten. Das Datenformat wird durch eine Zeichenfolge angegeben.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)

Speichert die angegebenen Daten in diesem Datenobjekt, zusammen mit einem oder mehreren angegebenen Datenformaten.Stores the specified data in this data object, along with one or more specified data formats. Diese Überladung umfasst ein Boolean-Flag, mit dem angegeben wird, ob die Daten beim Abrufen in ein anderes Format konvertiert werden können.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)

Speichert die angegebenen Daten in diesem Datenobjekt, zusammen mit einem oder mehreren angegebenen Datenformaten. Das Datenformat wird durch ein Type-Objekt angegeben.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)

Speichert FileDrop-Daten in diesem Datenobjekt.Stores FileDrop data in this data object. Die Liste der abgelegten Dateien wird als Zeichenfolgenauflistung angegeben.The dropped file list is specified as a string collection.

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

Speichert Bitmap-Daten in diesem Datenobjekt.Stores Bitmap data in this data object. Die Bilddaten werden als BitmapSource angegeben.The image data is specified as a BitmapSource.

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

Speichert als Zeichenfolge angegebene UnicodeText-Daten in diesem Datenobjekt.Stores UnicodeText data, specified as a string, in this data object.

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

Speichert Textdaten in diesem Datenobjekt.Stores text data in this data object. Das Format der zu speichernden Textdaten wird mit einem Member von TextDataFormat angegeben.The format of the text data to store is specified with a member of TextDataFormat.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Angefügte Ereignisse

Copying Copying Copying Copying

Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt entsprechende Datenformate vorbereitet hat, die die Kopierauswahl darstellen, die Kopierauswahlformate zu einem DataObject hinzugefügt hat und bereit ist, das DataObject in die Clipboard zu stellen oder einen Drag & Drop-Vorgang zu beginnen.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

Tritt ein, wenn das zugeordnete Abhängigkeitsobjekt bereit zum Einfügen von Daten ist.Occurs when the associated dependency object is ready to paste data.

SettingData SettingData SettingData SettingData

Tritt ein, wenn das zugeordnete Abhängigkeitsobjekt versucht, einem DataObject ein neues Datenformat hinzuzufügen.Occurs when the associated dependency object attempts to add a new data format to a DataObject.

Explizite Schnittstellenimplementierungen

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

Erstellt eine Verbindung zwischen einem Datenobjekt und einer Advise-Senke.Creates a connection between a data object and an advisory sink. Diese Methode wird von einem Objekt aufgerufen, das eine Advise-Senke unterstützt, und aktiviert die Advise-Senke für den Empfang von Änderungsbenachrichtigungen für Daten des Objekts.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)

Zerstört eine Benachrichtigungsverbindung, die zuvor hergestellt wurden.Destroys a notification connection that had been previously established.

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

Erstellt ein Objekt, mit dem die aktuellen Advise-Verbindungen aufgelistet werden können.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)

Erstellt ein Objekt für das Auflisten der FORMATETC-Strukturen für ein Datenobjekt.Creates an object for enumerating the FORMATETC structures for a data object. Diese Strukturen werden in Aufrufen von GetData(FORMATETC, STGMEDIUM) oder SetData(FORMATETC, STGMEDIUM, Boolean) verwendet.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)

Stellt eine Standard-FORMATETC-Struktur bereit, die einer komplexeren Struktur logisch entspricht.Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. Mit dieser Methode können Sie bestimmen, ob zwei unterschiedliche FORMATETC-Strukturen dieselben Daten zurückgeben würden. Dadurch müssen Sie nicht doppelt rendern.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)

Ruft Daten aus einem Quelldatenobjekt ab.Obtains data from a source data object. Die von einem Datennutzer aufgerufene GetData(FORMATETC, STGMEDIUM)-Methode rendert die in der angegebenen FORMATETC-Struktur beschriebenen Daten und überträgt diese über die angegebene STGMEDIUM-Struktur.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. Der Aufrufer ist dann für das Freigeben der STGMEDIUM-Struktur verantwortlich.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)

Ruft Daten aus einem Quelldatenobjekt ab.Obtains data from a source data object. Diese Methode, die von einem Datennutzer aufgerufen wird, unterscheidet sich von der GetData(FORMATETC, STGMEDIUM)-Methode dadurch, dass der Aufrufer das angegebene Speichermedium zuordnen und freigeben muss.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)

Bestimmt, ob das Datenobjekt die in der FORMATETC-Struktur beschriebenen Daten rendern kann.Determines whether the data object is capable of rendering the data described in the FORMATETC structure. Objekte, die einen Einfüge oder Ablagevorgang ausführen möchten, können diese Methode aufrufen, bevor sie GetData(FORMATETC, STGMEDIUM) aufrufen, um zu bestimmen, ob der Vorgang erfolgreich durchgeführt werden kann.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)

Überträgt Daten an das Objekt, das diese Methode implementiert.Transfers data to the object that implements this method. Diese Methode wird von einem Objekt aufgerufen, das eine Datenquelle enthält.This method is called by an object that contains a data source.

Gilt für:

Siehe auch