DataObject.IDataObject.GetData(FORMATETC, STGMEDIUM) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.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.

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.

 virtual void System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System::Runtime::InteropServices::ComTypes::FORMATETC % formatetc, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium) = System::Runtime::InteropServices::ComTypes::IDataObject::GetData;

void IDataObject.GetData (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatetc, out System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit

Sub GetData (ByRef formatetc As FORMATETC, ByRef medium As STGMEDIUM) Implements IDataObject.GetData

Parameter

formatetc: FORMATETC

Ein Zeiger auf eine FORMATETC-Struktur, der als Verweis übergeben wird und das Format, das Medium und das Zielgerät für das Übergeben der Daten definiert. Mithilfe des booleschen Operators OR können auch mehrere Medien angegeben werden, sodass die Methode das beste Medium aus den angegebenen Medien auswählen kann.

medium: STGMEDIUM

Enthält nach dem Beenden dieser Methode einen Zeiger auf die STGMEDIUM-Struktur, die das Speichermedium angibt, das die zurückgegebenen Daten in ihrem tymed-Member enthält, sowie die Verantwortung für das Freigeben des Mediums in ihrem pUnkForRelease-Member. Wenn pUnkForReleasenull ist, ist der Empfänger des Mediums für dessen Freigabe verantwortlich, andernfalls zeigt pUnkForRelease auf die IUnknown-Schnittstelle im entsprechenden Objekt, sodass dessen Release-Methode aufgerufen werden kann. Das Medium muss zugeordnet und von GetData(FORMATETC, STGMEDIUM) aufgefüllt werden. Dieser Parameter wird nicht initialisiert übergeben.

Implementiert

GetData(FORMATETC, STGMEDIUM)

Ausnahmen

OutOfMemoryException

Es ist nicht genügend Arbeitsspeicher vorhanden, um diesen Vorgang auszuführen.

Hinweise

Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn das DataObject in eine IDataObject-Schnittstelle umgewandelt wird.

Gilt für: