ClipboardObject.IDataObject.GetData - метод

Статья
05/17/2015

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

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

Синтаксис

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

Параметры

pformatetcIn
Тип: array<FORMATETC[]

Ссылка на структуру FORMATETC, передаваемые по ссылке, которая определяет формат, носитель и целевое устройство для использования при передаче данных. Можно указать несколько носитель с помощью Boolean OR оператора, позволяя метод, чтобы выбрать наилучший указанный носитель для тех.

pRemoteMedium
Тип: array<STGMEDIUM[]

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

Реализации

IDataObject.GetData(FORMATETC, STGMEDIUM)

Исключения

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

Заметки

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

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

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

См. также

Ссылки

ClipboardObject Класс

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

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