IDataObject Schnittstelle
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 einen formatunabhängigen Mechanismus zum Übertragen von Daten bereit.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObjectpublic interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacetype IDataObject = interfacePublic Interface IDataObject- Abgeleitet
- Attribute
Hinweise
Die IDataObject Schnittstelle wird von der Clipboard Klasse und in Drag-and-Drop-Vorgängen verwendet.
Bei der Implementierung in einer Klasse ermöglichen die IDataObject Methoden dem Benutzer das Speichern von Daten in mehreren Formaten in einer Instanz der Klasse. Das Speichern von Daten in mehr als einem Format erhöht die Wahrscheinlichsten, dass eine Zielanwendung, deren Formatanforderungen Sie möglicherweise nicht kennen, die gespeicherten Daten abrufen kann. Rufen Sie zum Speichern von IDataObjectDaten in einer Instanz die SetData Methode auf, und geben Sie das Datenformat im format Parameter an. Legen Sie den autoConvert Parameter fest, false wenn gespeicherte Daten beim Abrufen nicht in ein anderes Format konvertiert werden sollen. Rufen Sie SetData mehrmals auf einer Instanz des Speicherns von IDataObject Daten in mehr als einem Format auf.
Sie rufen gespeicherte Daten von einer IDataObject methode ab, indem Sie die GetData Methode aufrufen und das Datenformat im format Parameter angeben. Legen Sie den autoConvert Parameter fest, um false nur Daten abzurufen, die im angegebenen Format gespeichert wurden. Um die gespeicherten Daten in das angegebene Format zu konvertieren, legen Sie diese autoConvert fest trueoder verwenden autoConvertsie nicht.
Verwenden Sie die folgenden IDataObject Methoden, um die Formate der in einer IDataObjectDatei gespeicherten Daten zu ermitteln.
Rufen Sie die GetFormats Methode auf, um ein Array aller Formate abzurufen, in denen die Daten verfügbar sind. Legen Sie den
autoConvertParameter fest, umfalsenur die Formate abzurufen, in denen die Daten gespeichert werden. Um alle Formate abzurufen, in denen die Daten verfügbar sind, legen Sie diesenautoConvertParameter festtrue, oder verwenden Sie diesen Parameter nicht.Rufen Sie die GetDataPresent Methode auf, um zu ermitteln, ob gespeicherte Daten in einem bestimmten Format verfügbar sind. Wenn gespeicherte Daten nicht in das angegebene Format konvertiert werden sollen, legen Sie den
autoConvertParameter auffalse.
Eine Implementierung dieser Schnittstelle finden Sie in der DataObject Klasse. Die Klasse finden Sie in den DataFormats vordefinierten Clipboard Datenformaten.
Methoden
| Name | Beschreibung |
|---|---|
| GetData(String, Boolean) |
Ruft die mit dem angegebenen Datenformat verknüpften Daten ab, wobei ein boolescher Wert verwendet wird, um zu bestimmen, ob die Daten in das Format konvertiert werden sollen. |
| GetData(String) |
Ruft die mit dem angegebenen Datenformat verknüpften Daten ab. |
| GetData(Type) |
Ruft die Daten ab, die dem angegebenen Klassentypformat zugeordnet sind. |
| GetDataPresent(String, Boolean) |
Bestimmt, ob daten, die in dieser Instanz gespeichert sind, mit einem booleschen Wert verknüpft sind, um zu bestimmen, ob die Daten in das Format konvertiert werden sollen. |
| GetDataPresent(String) |
Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können. |
| GetDataPresent(Type) |
Bestimmt, ob in dieser Instanz gespeicherte Daten dem angegebenen Format zugeordnet oder in das angegebene Format konvertiert werden können. |
| GetFormats() |
Gibt eine Liste aller Formate zurück, die in dieser Instanz gespeicherte Daten zugeordnet sind oder in die konvertiert werden können. |
| GetFormats(Boolean) |
Ruft eine Liste aller Formate ab, die in dieser Instanz gespeicherte Daten zugeordnet sind oder in die konvertiert werden können, mithilfe eines booleschen Werts, um zu bestimmen, ob alle Formate abgerufen werden, in die die Daten konvertiert werden können, oder nur in systemeigene Datenformate. |
| SetData(Object) |
Speichert die angegebenen Daten in dieser Instanz mithilfe der Klasse der Daten für das Format. |
| SetData(String, Boolean, Object) |
Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz mithilfe eines booleschen Werts, um anzugeben, ob die Daten in ein anderes Format konvertiert werden können. |
| SetData(String, Object) |
Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz. |
| SetData(Type, Object) |
Speichert die angegebenen Daten und den zugehörigen Klassentyp in dieser Instanz. |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| TryGetData<T>(IDataObject, String, Boolean, T) |
Stellt einen formatunabhängigen Mechanismus zum Übertragen von Daten bereit. |
| TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T) |
Stellt einen formatunabhängigen Mechanismus zum Übertragen von Daten bereit. |
| TryGetData<T>(IDataObject, String, T) |
Stellt einen formatunabhängigen Mechanismus zum Übertragen von Daten bereit. |
| TryGetData<T>(IDataObject, T) |
Stellt einen formatunabhängigen Mechanismus zum Übertragen von Daten bereit. |
