DataObject Klasse
Definition
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::IDataObjectpublic sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObjecttype DataObject = class
interface IDataObject
interface IDataObjectPublic NotInheritable Class DataObject
Implements IDataObject, IDataObject- Vererbung
-
DataObject
- Implementiert
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 |
| 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 |
| 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 |
| 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 |
| 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. |
