DataObject Klasse

Referenz

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine grundlegende Implementierung der IDataObject-Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert.

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: Object
DataObject

Implementiert: IDataObject IDataObject

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Klasse veranschaulicht.

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. Rufen Sie die Methoden aus dieser Klasse nur mit vertrauenswürdigen Daten auf. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Konstruktoren

DataObject()	Initialisiert eine neue Instanz der DataObject-Klasse.
DataObject(Object)	Initialisiert eine neue Instanz der DataObject-Klasse, die die angegebenen Daten enthält.
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.
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. Diese Überladung umfasst ein `Boolean`-Flag, mit dem angegeben wird, ob die Daten beim Abrufen in ein anderes Format konvertiert werden können.
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.

Felder

CopyingEvent	Bezeichnet das angefügte Copying-Ereignis.
PastingEvent	Bezeichnet das angefügte Pasting-Ereignis.
SettingDataEvent	Bezeichnet das angefügte SettingData-Ereignis.

Methoden

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Fügt einem angegebenen Abhängigkeitsobjekt einen Copying-Ereignishandler hinzu.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Fügt einem angegebenen Abhängigkeitsobjekt einen Pasting-Ereignishandler hinzu.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Fügt einem angegebenen Abhängigkeitsobjekt einen SettingData-Ereignishandler hinzu.
ContainsAudio()	Fragt ein Datenobjekt auf das Vorhandensein von Daten im WaveAudio-Datenformat ab.
ContainsFileDropList()	Fragt ein Datenobjekt auf das Vorhandensein von Daten im FileDrop-Datenformat ab.
ContainsImage()	Fragt ein Datenobjekt auf das Vorhandensein von Daten im Bitmap-Datenformat ab.
ContainsText()	Fragt ein Datenobjekt auf das Vorhandensein von Daten im UnicodeText-Format ab.
ContainsText(TextDataFormat)	Fragt ein Datenobjekt auf das Vorhandensein von Daten in einem Textdatenformat ab.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetAudioStream()	Gibt einen Stream zurück, der Daten im WaveAudio-Datenformat enthält.
GetData(String)	Gibt Daten in einem durch eine Zeichenfolge angegebenen Format zurück.
GetData(String, Boolean)	Gibt ein Datenobjekt in einem angegebenen Format zurück und konvertiert die Daten optional in das angegebene Format.
GetData(Type)	Gibt ein Datenobjekt in einem von einem Type-Objekt angegebenen Format zurück.
GetDataPresent(String)	Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob die Daten in einem angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können. 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.
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.
GetFileDropList()	Gibt eine Zeichenfolgenauflistung zurück, die eine Liste abgelegter Dateien enthält.
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.
GetFormats(Boolean)	Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind. Ein `Boolean`-Flag gibt an, ob auch Formate eingeschlossen werden sollen, in die die Daten automatisch konvertiert werden können.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetImage()	Gibt ein BitmapSource-Objekt zurück, das Daten im Bitmap-Format enthält.
GetText()	Gibt eine Zeichenfolge zurück, die die UnicodeText-Daten in diesem Datenobjekt enthält.
GetText(TextDataFormat)	Gibt eine Zeichenfolge zurück, die Textdaten vom angegebenen Format in diesem Datenobjekt enthält.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Entfernt einen Copying-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Entfernt einen Pasting-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Entfernt einen SettingData-Ereignishandler aus einem angegebenen Abhängigkeitsobjekt.
SetAudio(Byte[])	Speichert Audiodaten (WaveAudio-Datenformat) in diesem Datenobjekt. Die Audiodaten werden als Bytearray angegeben.
SetAudio(Stream)	Speichert Audiodaten (WaveAudio-Datenformat) in diesem Datenobjekt. Die Audiodaten werden als Stream angegeben.
SetData(Object)	Speichert die angegebenen Daten in diesem Datenobjekt. Dabei wird das Datenformat automatisch anhand des Quellobjekttyps bestimmt.
SetData(String, Object)	Speichert die angegebenen Daten in diesem Datenobjekt zusammen mit einem oder mehreren angegebenen Datenformaten. Das Datenformat wird durch eine Zeichenfolge angegeben.
SetData(String, Object, Boolean)	Speichert die angegebenen Daten in diesem Datenobjekt, zusammen mit einem oder mehreren angegebenen Datenformaten. Diese Überladung umfasst ein `Boolean`-Flag, mit dem angegeben wird, ob die Daten beim Abrufen in ein anderes Format konvertiert werden können.
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.
SetFileDropList(StringCollection)	Speichert FileDrop-Daten in diesem Datenobjekt. Die Liste der abgelegten Dateien wird als Zeichenfolgenauflistung angegeben.
SetImage(BitmapSource)	Speichert Bitmap-Daten in diesem Datenobjekt. Die Bilddaten werden als BitmapSource angegeben.
SetText(String)	Speichert als Zeichenfolge angegebene UnicodeText-Daten in diesem Datenobjekt.
SetText(String, TextDataFormat)	Speichert Textdaten in diesem Datenobjekt. Das Format der zu speichernden Textdaten wird mit einem Member von TextDataFormat angegeben.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Angefügte Ereignisse

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.
Pasting	Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt bereit ist, Daten einzufügen.
SettingData	Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt versucht, ein neues Format zu einem DataObject hinzuzufügen.

Explizite Schnittstellenimplementierungen

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Erstellt eine Verbindung zwischen einem Datenobjekt und einer Advise-Senke. 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.
IDataObject.DUnadvise(Int32)	Zerstört eine Benachrichtigungsverbindung, die zuvor hergestellt wurde.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Erstellt ein Objekt, mit dem die aktuellen Advise-Verbindungen aufgelistet werden können.
IDataObject.EnumFormatEtc(DATADIR)	Erstellt ein Objekt für das Auflisten der FORMATETC-Strukturen für ein Datenobjekt. Diese Strukturen werden in Aufrufen von GetData(FORMATETC, STGMEDIUM) oder SetData(FORMATETC, STGMEDIUM, Boolean) verwendet.
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Stellt eine Standard-FORMATETC-Struktur bereit, die einer komplexeren Struktur logisch entspricht. 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.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Ruft Daten aus einem Quelldatenobjekt ab. 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. Der Aufrufer ist dann für das Freigeben der STGMEDIUM-Struktur verantwortlich.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Ruft Daten aus einem Quelldatenobjekt ab. 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.
IDataObject.QueryGetData(FORMATETC)	Bestimmt, ob das Datenobjekt die in der FORMATETC-Struktur beschriebenen Daten rendern kann. 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.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Überträgt Daten an das Objekt, das diese Methode implementiert. Diese Methode wird von einem Objekt aufgerufen, das eine Datenquelle enthält.

Gilt für:

Weitere Informationen

Laden eines Beispiels für gelöschte Dateien