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<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
Une référence à une structure d' FORMATETC , passée par référence, qui définit le format, la prise en charge, 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<Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[]
STGMEDIUM , passé par référence, qui définit le support de stockage contenant les données transférées.La prise en charge doit être allouée par l'appelant et être rempli 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(array<FORMATETC[], array<STGMEDIUM[])
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | L'objet de presse-papiers n'est pas Microsoft.VisualStudio.OLE.Interop.IDataObject encapsulé et d' pFormatetc et/ou d' 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é et la longueur des structures d' pFormatetc et/ou d' pRemoteMedium sont zéro. |
Notes
Si l'objet du presse-papiers encapsule IDataObject existant (de l'espace de noms d' 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 tente de convertir l'appel à l' GetDataHere correspondant de l'espace de noms d' System.Runtime.InteropServices.ComTypes , si l'objet du 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.