Método ClipboardObject.IDataObject.GetData

Artigo
05/17/2015

Obtém dados de um objeto de fonte de dados. Este método é chamado por um consumidor dos dados. Processa os dados descritos na estrutura especificada de FORMATETC e transferir-los através da estrutura de STGMEDIUM especificada. O chamador assume a responsabilidade para liberar a estrutura de STGMEDIUM .

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
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 não oferece suporte a implementações explícitas da interface.

Parâmetros

pformatetcIn
Tipo: array<FORMATETC[]

Uma referência a uma estrutura de FORMATETC , passada por referência, que define o formato, o meio, e o dispositivo de destino para usar para passar os dados. É possível especificar mais de um meio usando o operador OR de Boolean , permitindo que o método escolha melhor meio entre aquelas especificadas.

pRemoteMedium
Tipo: array<STGMEDIUM[]

Quando esse método retorna, contém uma referência para a estrutura de STGMEDIUM que indica o suporte de memória que contém os dados retornados por meio do membro de tymed , e responsabilidade para liberar o meio com o valor do membro de pUnkForRelease . Se pUnkForRelease é nulluma referência nula (Nothing no Visual Basic), o receptor do meio é responsável por liberar-lo; se não, os pontos de pUnkForRelease a interface de IUnknown no objeto apropriado para que no método de Release podem ser chamados. O meio deve ser atribuído e preenchido por esse método. Este parâmetro é passado não inicializado.

Implementações

IDataObject.GetData(FORMATETC, STGMEDIUM)

Exceções

Exceção	Condição
ArgumentNullException	O objeto da área de transferência não é Microsoft.VisualStudio.OLE.Interop.IDataObject definir e os parâmetros de pformatetcIn e/ou de pRemoteMedium são nulluma referência nula (Nothing no Visual Basic).
ArgumentException	O objeto da área de transferência não é Microsoft.VisualStudio.OLE.Interop.IDataObject definir e o comprimento das estruturas de pformatetcIn e/ou de pRemoteMedium é zero.

Comentários

Se o objeto da área de transferência envolve IDataObject existente (namespace de Microsoft.VisualStudio.OLE.Interop ), representantes deste método a chamada para o GetData correspondente desse namespace. Caso contrário, ele tenta converter a chamada para o GetData do espaço de System.Runtime.InteropServices.ComTypes , no caso do objeto da área de transferência pode envolver IDataObjectexistente.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

ClipboardObject Classe

Namespace Microsoft.VisualStudio.Data.Framework

Partilhar via