Método ValidationContext.LogMessage

Artigo
05/22/2013

Cria uma mensagem de informações de validação e o registra para a coleção que o contexto de validação mantém.

Namespace: Microsoft.VisualStudio.Modeling.Validation
Assembly: Microsoft.VisualStudio.Modeling.Sdk.11.0 (em Microsoft.VisualStudio.Modeling.Sdk.11.0.dll)

Sintaxe

'Declaração
Public Function LogMessage ( _
    description As String, _
    code As String, _
    ParamArray elements As ModelElement() _
) As ValidationMessage

public ValidationMessage LogMessage(
    string description,
    string code,
    params ModelElement[] elements
)

Parâmetros

description
Tipo: System.String
O texto que descreve essa mensagem e que aparece na janela Error List se for encontrada uma violação.

code
Tipo: System.String
Uma string exclusiva que identifica esta mensagem.

elements
Tipo: array<Microsoft.VisualStudio.Modeling.ModelElement[]
Uma lista de zero ou mais elementos que estão no modelo e que são realçadas se um usuário clica duas vezes essa mensagem na janela Error List.

Valor de retorno

Tipo: Microsoft.VisualStudio.Modeling.Validation.ValidationMessage
Uma mensagem de validação que contém informações sobre a mensagem.

Comentários

LogMessagenão envia a mensagem de validação para Visual Studio.

O VsValidationContext objeto faz com que a mensagem seja exibida na Error List janela.A descrição que você fornece como um parâmetro para este método é a explicação textual que aparece na janela.

Observação
Os elementos na lista também são realçados se o usuário clica com o botão direito na Error List janela e depois clicar Erro anterior ou Próximo erro.

Exemplos

O exemplo a seguir valida se o número de filhos para cada pessoa não é maior do que 20.

Se for encontrada uma violação, o LogMessage método adiciona um aviso para a lista de mensagens que aparecem na Error List janela.

[C#]

[ValidationMethod
(
    ValidationCategory.Open |
    ValidationCategory.Save |
    ValidationCategory.Menu
)
]
private void ValidateNumberOfChildren(ValidationContext context)   
{
    if (this.Child.Count > 20)
    {
        context.LogMessage(
            "Number of children: " + this.Child.Count,
            "HighNumberOfChildren", 
            this 
        );
    }
}

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áveis.

Consulte também

Referência

ValidationContext Classe

Namespace Microsoft.VisualStudio.Modeling.Validation

Partilhar via