Método IVsToolboxDataProvider2.GetProfileData (IDataObject, String)

Artigo
09/30/2016

Publicado: agosto de 2016

Obtém todas as informações adicionais, se necessário, sobre um Toolbox item que pode ser salvo por meio do mecanismo de configurações usando o configurações de importação/exportação recurso disponível no IDE' ferramentas menu.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (em Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Sintaxe

int GetProfileData(
    IDataObject pDO,
    out string pbstrData
)

int GetProfileData(
    IDataObject^ pDO,
    [OutAttribute] String^% pbstrData
)

abstract GetProfileData : 
        pDO:IDataObject *
        pbstrData:string byref -> int

Function GetProfileData (
    pDO As IDataObject,
    <OutAttribute> ByRef pbstrData As String
) As Integer

Parâmetros

pDO
Type: Microsoft.VisualStudio.OLE.Interop.IDataObject

[in] O objeto de dados correspondente ao item de caixa de ferramentas.

pbstrData
Type: System.String

[out] Uma cadeia de caracteres que contém todas as informações extras que seriam necessários para reconstituir o item quando importados de configurações.

Valor Retornado

Type: System.Int32

Se o método for bem-sucedido, ele retornará S_OK. Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell80.idl:

HRESULT IVsToolboxDataProvider2::GetProfileData(
   [in] IDataObject *pDO,
   [out] BSTR *pbstrData
);

O ambiente chama IVsToolboxDataProvider2.GetProfileData quando um usuário escolhe a opção de exportação do IDE do configurações de importação/exportação recurso.

Durante a importação de configurações, o ambiente de recuperar essas informações e passá-lo para o ReconstituteItem método para recriar o item de caixa de ferramentas.

Informações fornecidas por IVsToolboxDataProvider2.GetProfileData deve ser:

Suficientes para identificar o controle original usado pelo item e adicioná-lo à caixa de ferramentas.
Portátil e não-localizada, para que eles podem ser transferidos entre instâncias do Visual Studio usando o IDE configurações de importação/exportação recurso.

Para obter mais informações sobre como usar o mecanismo vssettings, consulte persistência de estado e o Visual Studio IDE.

Observação
As configurações não instalará o controle do sistema se o controle já não estiver presente.

Confira Também

Interface IVsToolboxDataProvider2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao início

Partilhar via