DataObject DataObject DataObject DataObject Class

Definition

Bietet eine grundlegende Implementierung der IDataObject -Schnittstelle, 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 dem 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 dem 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 dem 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 zur Angabe, ob die Daten in ein anderes Format abrufen 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 dem DataObject Klasse, die die angegebenen Daten und das zugeordnete Format enthält; das Datenformat wird angegeben, durch eine Type Objekt.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 in die WaveAudio Datenformat.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 in die FileDrop Datenformat.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 in die Bitmap Datenformat.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 in die UnicodeText Format.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, der Daten in enthält die WaveAudio Datenformat.Returns a stream that contains data in the WaveAudio data format.

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

Gibt die 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, konvertiert die Daten optional in das angegebene Format zurück.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 Format gemäß einem Type Objekt.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 verfügbar ist, oder einem durch eine Zeichenfolge angegebene 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 verfügbar ist, oder eine angegebene 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 Sie überprüfen, ob die Daten in das angegebene Format konvertiert werden können, wenn sie nicht in diesem Format verfügbar ist.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 verfügbar ist, oder auf eine vom angegebenen Format konvertiert werden können eine Type Objekt.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 Auflistung von Zeichenfolgen, die eine Liste der abgelegten Dateien enthält.Returns a string collection that contains a list of dropped files.

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

Gibt eine Liste der Formate, in denen die Daten in diesem Datenobjekt gespeichert oder 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 der Formate, in denen die Daten in diesem Datenobjekt gespeichert werden.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, 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 eine BitmapSource Objekt mit Daten in die Bitmap Format.Returns a BitmapSource object that contains data in the Bitmap format.

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

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

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

Gibt eine Zeichenfolge, die Textdaten im 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, das Datenformat aus dem Objekttyp der Datenquelle automatisch ermittelt.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 zur Angabe, ob die Daten in ein anderes Format abrufen 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 Format der Daten gemäß einem Type Objekt.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. 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 Image-Daten angegeben ist, als eine BitmapSource.The image data is specified as a BitmapSource.

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

Speichert UnicodeText Daten als Zeichenfolge, 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 angegeben, mit einem Member mit TextDataFormat.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 auf, wenn das zugeordnete Abhängigkeitsobjekt bereit ist, Daten einzufügen.Occurs when the associated dependency object is ready to paste data.

SettingData SettingData SettingData SettingData

Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt versucht, ein neues Format zu einem DataObject 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 wurde.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 verwendet, in Aufrufen von GetData(FORMATETC, STGMEDIUM) oder 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)

Ist ein Standard FORMATETC -Struktur, 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 müssen Sie nicht doppelt Rendern zurückgeben würden.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 GetData(FORMATETC, STGMEDIUM) -Methode, die von einem Datennutzer aufgerufen wird, rendert die Daten, die in der angegebenen beschrieben FORMATETC Struktur und überträgt diese über den angegebenen 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 verantwortlich für die Freigabe der STGMEDIUM Struktur.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, der Aufrufer zuordnen und das angegebene Speichermedium 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, das beschriebenen Daten rendern kann die FORMATETC Struktur.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, kann diese Methode vor dem Aufruf aufrufen GetData(FORMATETC, STGMEDIUM) 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