ClipboardObject.IDataObject.GetDataHere, méthode
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.