ClipboardObject.IDataObject.GetDataHere, méthode

Article
05/16/2015

Obtient des données à partir d'un objet de données source. Cette méthode, qui est appelée par un consommateur de données, diffère de la méthode IDataObject.GetData en ce sens que l'appelant doit allouer et libérer le support de stockage spécifié.

Espace de noms : Microsoft.VisualStudio.Data.Framework
Assembly : Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Déclaration
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 ne prend pas en charge les implémentations d'interfaces explicites.

Paramètres

pFormatetc
Type : array<FORMATETC[]

Une référence à une structure d'FORMATETC, passée par référence, qui définit le format, le média, et le périphérique cible à utiliser en passant les données. Seul un média peut être spécifié dans tymed, et seules les valeurs suivantes pour TYMED sont valides : TYMED_ISTORAGE, TYMED_ISTREAM, TYMED_HGLOBAL, et TYMED_FILE.

pRemoteMedium
Type : array<STGMEDIUM[]

STGMEDIUM, passé par référence, qui définit le support de stockage contenant les données transférées. Le support doit être allouée par l'appelant et être complété par cette méthode. L'appelant doit également libérer le support. L'implémentation de cette méthode doit toujours fournir une valeur nullune référence null (Nothing en Visual Basic) pour le membre pUnkForRelease de la structure STGMEDIUM vers lequel ce paramètre pointe.

Implémentations

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Exceptions

Exception	Condition
ArgumentNullException	L'objet de Presse-papiers n'est pas Microsoft.VisualStudio.OLE.Interop.IDataObject encapsulée et pFormatetc et/ou les paramètres pRemoteMedium sont nullune référence null (Nothing en Visual Basic).
ArgumentException	L'objet de Presse-papiers n'est pas Microsoft.VisualStudio.OLE.Interop.IDataObject encapsulée et la longueur des structures d'pFormatetc et/ou d'pRemoteMedium sont zéro.

Notes

Si l'objet de Presse-papiers encapsule IDataObject existant (de l'espace de noms Microsoft.VisualStudio.OLE.Interop ), les délégués de cette méthode l'appel à l'GetDataHere correspondant de cet espace de noms. Sinon, il essaie de traduire l'appel à l'GetDataHere correspondant de l'espace de noms System.Runtime.InteropServices.ComTypes, si l'objet de Presse-papiers peut encapsuler IDataObjectexistant.

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ClipboardObject Classe

Microsoft.VisualStudio.Data.Framework, espace de noms

Partager via