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 ein formatunabhängiges Verfahren zur Übertragung 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, Daten in mehreren Formaten in einer Instanz der Klasse zu speichern. Das Speichern von Daten in mehr als einem Format erhöht die Chance, dass eine Zielanwendung, deren Formatanforderungen Sie möglicherweise nicht kennen, die gespeicherten Daten abrufen können. Um Daten in einer Instanz von IDataObject, rufen Sie die SetData Methode auf, und geben Sie das Datenformat im format Parameter an. Legen Sie den autoConvert Parameter false fest, wenn keine gespeicherten Daten in ein anderes Format konvertiert werden sollen, wenn sie abgerufen wird. Rufen Sie SetData mehrere Male auf einer Instanz von IDataObject Daten auf, um Daten in mehr als einem Format zu speichern.
Sie rufen gespeicherte Daten aus einer IDataObject Methode ab, indem Sie die GetData Methode aufrufen und das Datenformat im format Parameter angeben. Legen Sie den Parameter fest, false um nur Daten abzurufen, die autoConvert im angegebenen Format gespeichert wurden. Wenn Sie die gespeicherten Daten in das angegebene Format konvertieren möchten, legen Sie es fest autoConvert true, oder verwenden autoConvertSie diese nicht.
Um die Formate der in einer IDataObjectDatei gespeicherten Daten zu bestimmen, verwenden Sie die folgenden IDataObject Methoden.
Rufen Sie die Methode auf, um ein Array aller Formate abzurufen, in denen die GetFormats Daten verfügbar sind. Legen Sie den
autoConvertParameter fest,falseum nur die Formate abzurufen, in denen die Daten gespeichert werden. Um alle Formate abzurufen, in denen die Daten verfügbar sind, legenautoConverttrueSie fest, 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.
Sehen Sie sich die DataObject Klasse für eine Implementierung dieser Schnittstelle an. Sehen Sie sich die Klasse für die DataFormats vordefinierten Clipboard Datenformate an.
Methoden
| GetData(String) |
Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind. |
| GetData(String, Boolean) |
Ruft die dem angegebenen Format zugeordneten Daten ab. Mit einem booleschen Wert wird dabei festgelegt, ob die Daten in das Format konvertiert werden sollen. |
| GetData(Type) |
Ruft die Daten ab, die dem angegebenen Format für den Klassentyp zugeordnet sind. |
| GetDataPresent(String) |
Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können. |
| GetDataPresent(String, Boolean) |
Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist. Ein boolescher Wert legt dabei fest, ob die Daten in das Format konvertiert werden sollen. |
| GetDataPresent(Type) |
Bestimmt, ob den in dieser Instanz gespeicherten Daten das angegebene Format zugewiesen ist bzw. sie in das Format konvertiert werden können. |
| GetFormats() |
Gibt eine Liste aller Formate zurück, die den in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können. |
| GetFormats(Boolean) |
Ruft eine Liste aller Formate ab, denen die in dieser Instanz gespeicherten Daten zugeordnet sind oder in die diese Daten konvertiert werden können. Dabei wird über einen booleschen Wert angegeben, ob auch Formate, in die die Daten konvertiert werden können, oder nur systemeigene Datenformate abgerufen werden sollen. |
| SetData(Object) |
Speichert die angegebenen Daten in dieser Instanz, wobei die Klasse der Daten für das Format verwendet wird. |
| SetData(String, Boolean, Object) |
Speichert die angegebenen Daten in dieser Instanz, wobei die Klasse der Daten für das Format verwendet wird. Dabei gibt ein boolescher Wert an, ob die Daten in ein anderes Format konvertiert werden können. |
| SetData(String, Object) |
Speichert die angegebenen Daten und das ihnen zugeordnete Format in dieser Instanz. |
| SetData(Type, Object) |
Speichert die angegebenen Daten und den zugeordneten Klassentyp in dieser Instanz. |