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 ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::ITypedDataObjectpublic sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObjectpublic sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.ITypedDataObjecttype DataObject = class
interface IDataObject
interface IDataObjecttype DataObject = class
interface IDataObject
interface IDataObject
interface ITypedDataObjectPublic NotInheritable Class DataObject
Implements IDataObject, IDataObjectPublic NotInheritable Class DataObject
Implements IDataObject, ITypedDataObject- Vererbung
-
DataObject
- Implementiert
Beispiele
Das folgende Beispiel zeigt, wie Sie diese Klasse verwenden.
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
Important
Das Aufrufen von Methoden aus dieser Klasse mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Rufen Sie die Methoden aus dieser Klasse nur mit vertrauenswürdigen Daten auf. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.
Konstruktoren
| Name | Beschreibung |
|---|---|
| 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, Boolean) |
Initialisiert eine neue Instanz der DataObject Klasse, die die angegebenen Daten und das zugehörige Format enthält. Das Format wird durch eine Zeichenfolge angegeben. Diese Überladung enthält ein |
| DataObject(String, Object) |
Initialisiert eine neue Instanz der DataObject Klasse, die die angegebenen Daten und das zugehörige Format enthält. Das Format wird durch eine Zeichenfolge angegeben. |
| DataObject(Type, Object) |
Initialisiert eine neue Instanz der DataObject Klasse, die die angegebenen Daten und das zugehörige Format enthält. Das Datenformat wird durch ein Type Objekt angegeben. |
Felder
| Name | Beschreibung |
|---|---|
| CopyingEvent |
Identifiziert das Copying angefügte Ereignis. |
| PastingEvent |
Identifiziert das Pasting angefügte Ereignis. |
| SettingDataEvent |
Identifiziert das SettingData angefügte Ereignis. |
Methoden
| Name | Beschreibung |
|---|---|
| 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 für das Vorhandensein von Daten im WaveAudio Datenformat ab. |
| ContainsFileDropList() |
Fragt ein Datenobjekt für das Vorhandensein von Daten im FileDrop Datenformat ab. |
| ContainsImage() |
Fragt ein Datenobjekt für das Vorhandensein von Daten im Bitmap Datenformat ab. |
| ContainsText() |
Fragt ein Datenobjekt für das Vorhandensein von Daten im UnicodeText Format ab. |
| ContainsText(TextDataFormat) |
Fragt ein Datenobjekt für das Vorhandensein von Daten in einem Textdatenformat ab. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetAudioStream() |
Gibt einen Datenstrom zurück, der Daten im WaveAudio Datenformat enthält. |
| GetData(String, Boolean) |
Gibt ein Datenobjekt in einem angegebenen Format zurück, optional werden die Daten in das angegebene Format konvertiert. |
| GetData(String) |
Gibt Daten in einem format zurück, das durch eine Zeichenfolge angegeben wird. |
| GetData(Type) |
Gibt ein Datenobjekt in einem format zurück, das durch ein Type Objekt angegeben wird. |
| GetDataPresent(String, Boolean) |
Bestimmt, ob die Daten in einem angegebenen Format verfügbar oder in ein angegebenes Format konvertiert werden können. Ein |
| GetDataPresent(String) |
Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in das konvertiert werden können. |
| GetDataPresent(Type) |
Bestimmt, ob die Daten in einem durch ein Objekt angegebenen Format verfügbar sind oder in das Type 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 konvertiert werden können. |
| GetFormats(Boolean) |
Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert werden. Ein |
| GetHashCode() |
Dient 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 des angegebenen Formats in diesem Datenobjekt enthält. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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 Datenstrom angegeben. |
| SetData(Object) |
Speichert die angegebenen Daten in diesem Datenobjekt, wobei das Datenformat automatisch vom Quellobjekttyp bestimmt wird. |
| SetData(String, Object, Boolean) |
Speichert die angegebenen Daten in diesem Datenobjekt zusammen mit einem oder mehreren angegebenen Datenformaten. Diese Überladung enthält ein |
| 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(Type, Object) |
Speichert die angegebenen Daten in diesem Datenobjekt zusammen mit einem oder mehreren angegebenen Datenformaten; das Datenformat wird durch ein Type Objekt angegeben. |
| SetDataAsJson<T>(String, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| SetDataAsJson<T>(T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| SetFileDropList(StringCollection) |
Speichert FileDrop Daten in diesem Datenobjekt. Die abgelegte Dateiliste wird als Zeichenfolgensammlung angegeben. |
| SetImage(BitmapSource) |
Speichert Bitmap Daten in diesem Datenobjekt. Die Bilddaten werden als .BitmapSource |
| SetText(String, TextDataFormat) |
Speichert Textdaten in diesem Datenobjekt. Das Format der zu speichernden Textdaten wird mit einem Element von TextDataFormatangegeben. |
| SetText(String) |
Speichert UnicodeText Daten, die als Zeichenfolge angegeben sind, in diesem Datenobjekt. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TryGetData<T>(String, Boolean, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(String, Func<TypeName,Type>, Boolean, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(String, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
Angefügte Ereignisse
| Name | Beschreibung |
|---|---|
| Copying |
Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt geeignete Datenformate vorbereitet hat, die die Kopierauswahl darstellen, die Kopierauswahlformate zu einem DataObjecthinzugefügt haben und bereit ist, entweder den ClipboardDataObject Drag-and-Drop-Vorgang zu platzieren oder zu beginnen. |
| Pasting |
Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt zum Einfügen von Daten bereit ist. |
| SettingData |
Tritt auf, wenn das zugeordnete Abhängigkeitsobjekt versucht, einem ein DataObjectneues Datenformat hinzuzufügen. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) |
Erstellt eine Verbindung zwischen einem Datenobjekt und einer Beratenden Spüle. Diese Methode wird von einem Objekt aufgerufen, das eine Beratende Spüle unterstützt und ermöglicht es der Beratenden Spüle, über Änderungen in den Daten des Objekts benachrichtigt zu werden. |
| IDataObject.DUnadvise(Int32) |
Zerstört eine zuvor hergestellte Benachrichtigungsverbindung. |
| IDataObject.EnumDAdvise(IEnumSTATDATA) |
Erstellt ein Objekt, das zum Aufzählen der aktuellen Empfehlungsverbindungen verwendet werden kann. |
| IDataObject.EnumFormatEtc(DATADIR) |
Erstellt ein Objekt zum Aufzählen der FORMATETC Strukturen für ein Datenobjekt. Diese Strukturen werden in Aufrufen von GetData(FORMATETC, STGMEDIUM) oder SetData(FORMATETC, STGMEDIUM, Boolean). |
| IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) |
Stellt eine Standardstruktur FORMATETC bereit, die logisch einer komplexeren Struktur entspricht. Verwenden Sie diese Methode, um zu bestimmen, ob zwei unterschiedliche FORMATETC Strukturen dieselben Daten zurückgeben würden, wodurch die Notwendigkeit des doppelten Renderings entfernt wird. |
| IDataObject.GetData(FORMATETC, STGMEDIUM) |
Ruft Daten aus einem Quelldatenobjekt ab. Die GetData(FORMATETC, STGMEDIUM) Methode, die von einem Datenverbraucher aufgerufen wird, rendert die in der angegebenen FORMATETC Struktur beschriebenen Daten und überträgt sie über die angegebene STGMEDIUM Struktur. Der Aufrufer übernimmt dann die Verantwortung für die Freigabe der STGMEDIUM Struktur. |
| IDataObject.GetDataHere(FORMATETC, STGMEDIUM) |
Ruft Daten aus einem Quelldatenobjekt ab. Diese Methode, die von einem Datenanwender aufgerufen wird, unterscheidet sich von der GetData(FORMATETC, STGMEDIUM) Methode, in der 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 versuchen, einen Einfüge- oder Drop-Vorgang auszuführen, können diese Methode aufrufen, um GetData(FORMATETC, STGMEDIUM) einen Hinweis darauf zu erhalten, ob der Vorgang erfolgreich sein 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. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| TryGetData<T>(IDataObject, String, Boolean, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(IDataObject, String, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
| TryGetData<T>(IDataObject, T) |
Stellt eine grundlegende Implementierung der IDataObject Schnittstelle bereit, die einen formatunabhängigen Mechanismus zum Übertragen von Daten definiert. |
