Freigeben über


ClipboardObject.IDataObject.GetDataHere-Methode

Ruft Daten aus einem Quelldatenobjekt ab. Diese Methode, die von einem Datennutzer aufgerufen wird, unterscheidet sich von der IDataObject.GetData-Methode dadurch, dass der Aufrufer das angegebene Speichermedium zuordnen und freigeben muss.

Namespace:  Microsoft.VisualStudio.Data.Framework
Assembly:  Microsoft.VisualStudio.Data.Framework (in Microsoft.VisualStudio.Data.Framework.dll)

Syntax

'Declaration
Private Sub GetDataHere ( _
    pFormatetc As FORMATETC(), _
    pRemoteMedium As STGMEDIUM() _
) Implements IDataObject.GetDataHere
void IDataObject.GetDataHere(
    FORMATETC[] pFormatetc,
    STGMEDIUM[] pRemoteMedium
)
private:
virtual void GetDataHere(
    array<FORMATETC>^ pFormatetc, 
    array<STGMEDIUM>^ pRemoteMedium
) sealed = IDataObject::GetDataHere
private abstract GetDataHere : 
        pFormatetc:FORMATETC[] * 
        pRemoteMedium:STGMEDIUM[] -> unit  
private override GetDataHere : 
        pFormatetc:FORMATETC[] * 
        pRemoteMedium:STGMEDIUM[] -> unit
JScript unterstützt keine expliziten Schnittstellenimplementierungen

Parameter

  • pFormatetc
    Typ: array<FORMATETC[]

    Ein Verweis auf eine FORMATETC übergeben, Struktur durch einen Verweis, der das Format, den mittleren und das Zielgerät definiert, um zu verwenden, wenn er Daten übergibt. Nur ein Medium kann in tymed angegeben sind, und nur die folgenden TYMED-Werte sind gültig: TYMED_ISTORAGE, TYMED_ISTREAM, TYMED_HGLOBAL und TYMED_FILE.

  • pRemoteMedium
    Typ: array<STGMEDIUM[]

    Ein STGMEDIUM, das als Verweis übergeben wird und das Speichermedium definiert, das die übertragenen Daten enthält. Der Mittel muss vom Aufrufer zugeordnet werden und so ausgefüllt werden. Der Aufrufer muss das Medium auch freigeben. Die Implementierung dieser Methode muss immer den Wert nullein Nullverweis (Nothing in Visual Basic) für den pUnkForRelease-Member der STGMEDIUM-Struktur aufweisen, auf die dieser Parameter verweist.

Implementiert

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Das Zwischenablageobjekt ist nicht eingebundenes Microsoft.VisualStudio.OLE.Interop.IDataObject und die pFormatetc und/oder pRemoteMedium-Parameter sind nullein Nullverweis (Nothing in Visual Basic).

ArgumentException

Das Zwischenablageobjekt ist nicht eingebundenes Microsoft.VisualStudio.OLE.Interop.IDataObject und die Länge der pFormatetc oder pRemoteMedium-Strukturen sind null.

Hinweise

Wenn das Zwischenablageobjekt vorhandenes IDataObject ( Microsoft.VisualStudio.OLE.Interop ) vom Namespace umschließt, Delegaten Methode den Aufruf an den entsprechenden GetDataHere dieser Namespace. Andernfalls versucht es, den Aufruf des entsprechenden GetDataHere vom System.Runtime.InteropServices.ComTypes-Namespace zu übersetzen, falls das Zwischenablageobjekt vorhandenes IDataObject umschließen konnte.

.NET Framework-Sicherheit

Siehe auch

Referenz

ClipboardObject Klasse

Microsoft.VisualStudio.Data.Framework-Namespace