ClipboardObject.IDataObject.GetData-Methode

Artikel
05/16/2015

Ruft Daten aus einem Quelldatenobjekt ab. Diese Methode wird von einem Datenconsumer aufgerufen. Sie macht die Daten beschrieben in der angegebenen FORMATETC-Struktur und überträgt sie von der angegebenen STGMEDIUM-Struktur. Der Aufrufer ist dann für das Freigeben der STGMEDIUM-Struktur verantwortlich.

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

Syntax

'Declaration
Private Sub GetData ( _
    pformatetcIn As FORMATETC(), _
    pRemoteMedium As STGMEDIUM() _
) Implements IDataObject.GetData

void IDataObject.GetData(
    FORMATETC[] pformatetcIn,
    STGMEDIUM[] pRemoteMedium
)

private:
virtual void GetData(
    array<FORMATETC>^ pformatetcIn, 
    array<STGMEDIUM>^ pRemoteMedium
) sealed = IDataObject::GetData

private abstract GetData : 
        pformatetcIn:FORMATETC[] * 
        pRemoteMedium:STGMEDIUM[] -> unit  
private override GetData : 
        pformatetcIn:FORMATETC[] * 
        pRemoteMedium:STGMEDIUM[] -> unit

JScript unterstützt keine expliziten Schnittstellenimplementierungen

Parameter

pformatetcIn
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. Es ist möglich, mehr als einem mittleren anzugeben, indem der Boolean und der Operator OR verwendet wird Methode ermöglicht, um den optimalen Mittel unter denen angegebenen auszuwählen.

pRemoteMedium
Typ: array<STGMEDIUM[]

Wenn diese Methode beendet wird, enthält einen Verweis auf die STGMEDIUM-Struktur, die dem Speichermedium angibt, welches die zurückgegebenen Daten von den tymed-Member enthält, und die Verantwortung für das Freigeben des Mediums durch den Wert seines pUnkForRelease-Members. Wenn pUnkForReleasenullein Nullverweis (Nothing in Visual Basic) 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. Der Mittel muss zugeordnet werden und so ausgefüllt werden. Dieser Parameter wird nicht initialisiert übergeben.

Implementiert

IDataObject.GetData(FORMATETC, STGMEDIUM)

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Das Zwischenablageobjekt ist nicht eingebundenes Microsoft.VisualStudio.OLE.Interop.IDataObject und die pformatetcIn 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 pformatetcIn 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 GetData dieser Namespace. Andernfalls versucht es, den Aufruf von GetData vom System.Runtime.InteropServices.ComTypes-Namespace zu übersetzen, falls das Zwischenablageobjekt vorhandenes IDataObject umschließen konnte.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ClipboardObject Klasse

Microsoft.VisualStudio.Data.Framework-Namespace

Freigeben über