ClipboardObject.IDataObject.GetData, méthode
Obtient des données à partir d'un objet de données source.Cette méthode est appelée par un consommateur de données.Elle affiche les données décrites dans la structure spécifiée d' FORMATETC et les transfère dans la structure spécifiée d' STGMEDIUM .L'appelant est ensuite chargé de libérer la structure STGMEDIUM.
Espace de noms : Microsoft.VisualStudio.Data.Framework
Assembly : Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)
Syntaxe
'Déclaration
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 ne prend pas en charge les implémentations d'interfaces explicites.
Paramètres
- pformatetcIn
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.Il est possible de spécifier plusieurs charge à l'aide de l'opérateur OR d' Boolean , ce qui permet à la méthode de choisir le mieux en charge parmi ceux spécifiés.
- pRemoteMedium
Type : array<Microsoft.VisualStudio.OLE.Interop.STGMEDIUM[]
Lorsque cette méthode retourne, contient une référence à la structure d' STGMEDIUM qui indique le support de stockage contenant les données retournées via son membre d' tymed , et la responsabilité de libérer la prise en charge par la valeur de son membre d' pUnkForRelease .Si pUnkForRelease est nullune référence null (Nothing en Visual Basic), le récepteur du support est chargé de le libérer ; sinon, pUnkForRelease pointe vers l'interface IUnknown sur l'objet approprié afin que sa méthode Release puisse être appelée.La prise en charge doit être allouée et rempli par cette méthode.Ce paramètre est passé sans être initialisé.
Implémentations
IDataObject.GetData(array<FORMATETC[], array<STGMEDIUM[])
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | L'objet de presse-papiers n'est pas Microsoft.VisualStudio.OLE.Interop.IDataObject encapsulé et d' pformatetcIn 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' pformatetcIn 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' GetData correspondant de cet espace de noms.Sinon, il tente de convertir l'appel à l' GetData 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.