ClipboardObject.IDataObject.GetDataHere - метод

Статья
05/17/2015

Получает данные из исходного объекта данных. Этот метод, который вызывается объектом-получателем данных, отличается от метода IDataObject.GetData, в котором вызывающий объект должен выделить и освободить заданную среду хранения.

Пространство имен: Microsoft.VisualStudio.Data.Framework
Сборка: Microsoft.VisualStudio.Data.Framework (в Microsoft.VisualStudio.Data.Framework.dll)

Синтаксис

'Декларация
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 не поддерживает явные реализации интерфейса.

Параметры

pFormatetc
Тип: array<FORMATETC[]

Ссылка на структуру FORMATETC, передаваемые по ссылке, которая определяет формат, носитель и целевое устройство для использования при передаче данных. Только один носитель можно указать в tymed и только TYMED допустимы следующие значения: TYMED_ISTORAGE, TYMED_ISTREAM, TYMED_HGLOBAL и TYMED_FILE.

pRemoteMedium
Тип: array<STGMEDIUM[]

Компонент STGMEDIUM, переданный ссылкой, который определяет среду хранения, содержащую передаваемые данные. Носитель должен быть выбран вызывающим и заполнен, с помощью этого метода. Также вызывающий объект должен освободить среду передачи. При реализации этого метода должно всегда предоставляться значение nullссылка NULL (Nothing в Visual Basic) для элемента pUnkForRelease структуры STGMEDIUM, на которую указывает этот параметр.

Реализации

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Исключения

Исключение	Условие
ArgumentNullException	Объект буфера обмена не является обтекаемым объектом Microsoft.VisualStudio.OLE.Interop.IDataObject и параметры pFormatetc и/или pRemoteMediumnullссылка NULL (Nothing в Visual Basic).
ArgumentException	Объект буфера обмена не является обтекаемым объектом Microsoft.VisualStudio.OLE.Interop.IDataObject и длина структур pFormatetc и/или pRemoteMedium ноль.

Заметки

Если объект буфера обмена существующего экземпляра IDataObject (из пространства имен Microsoft.VisualStudio.OLE.Interop ), делегатов данного метода вызов соответствующего GetDataHere из этого пространства имен. В противном случае он пытается преобразовать вызов соответствующего GetDataHere из пространства имен System.Runtime.InteropServices.ComTypes, если объект буфера обмена можно создать существующее IDataObject.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ClipboardObject Класс

Microsoft.VisualStudio.Data.Framework - пространство имен

Поделиться через