Método IVsGeneratorProgress.GeneratorError (Int32, UInt32, String, UInt32, UInt32)

Artigo
08/03/2016

Publicado: abril de 2016

Retornos de aviso e informações de erro para o sistema do projeto.

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

Sintaxe

int GeneratorError(
    int fWarning,
    uint dwLevel,
    string bstrError,
    uint dwLine,
    uint dwColumn
)

int GeneratorError(
    int fWarning,
    unsigned int dwLevel,
    String^ bstrError,
    unsigned int dwLine,
    unsigned int dwColumn
)

abstract GeneratorError : 
        fWarning:int *
        dwLevel:uint32 *
        bstrError:string *
        dwLine:uint32 *
        dwColumn:uint32 -> int

Function GeneratorError (
    fWarning As Integer,
    dwLevel As UInteger,
    bstrError As String,
    dwLine As UInteger,
    dwColumn As UInteger
) As Integer

Parâmetros

fWarning
[in] Sinalizador que indica se esta mensagem é um aviso ou erro.Definido como true para indicar um aviso ou to false para indicar um erro.

dwLevel
[in] Nível de gravidade do erro.O sistema do projeto atualmente ignora o valor desse parâmetro.

bstrError
[in] Texto do erro a ser exibido para o usuário por meio de uma lista de tarefas.

dwLine
[in] Número de linha de base zero que indica onde no arquivo de origem o erro ocorreu.Isso pode ser – 1 (ou 0xFFFFFFFF) se não for necessário.

dwColumn
[in] Número com base em uma coluna que indica onde no arquivo de origem o erro ocorreu.Isso pode ser – 1 se não for necessário, mas deve ser – 1 se dwLine é – 1.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsGeneratorProgress::GeneratorError(
   [in] BOOL fWarning,
   [in] DWORD dwLevel,
   [in] BSTR bstrError,
   [in] DWORD dwLine,
   [in] DWORD dwColumn
);

O comportamento do sistema do projeto em relação ao fWarning fornece uma ferramenta personalizada com duas possibilidades para relatar erros:

Use IVsGeneratorProgress.GeneratorError para relatar vários erros (ou itens de lista de tarefas).
Definir informações de erro no Generate e contam com o sistema de projeto para exibir um item de lista de tarefas automaticamente.

Quando uma falha é retornada a partir de Generate método e pelo menos um erro foi adicionado (fWarning = false), o sistema do projeto não exibe sua própria mensagem de erro genérica.Caso contrário, uma mensagem genérica que é exibida inclui o nome da ferramenta personalizada e qualquer informação de erro definido pela ferramenta personalizada antes para o seu retorno de Generate.

Consulte também

Interface IVsGeneratorProgress
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via