Método ValidationContext.LogError

Artigo
05/22/2013

Cria um erro de validação e registra uma mensagem 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 LogError ( _
    description As String, _
    code As String, _
    ParamArray elements As ModelElement() _
) As ValidationMessage

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

Parâmetros

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

code
Tipo: System.String
Uma string exclusiva que identifica este erro.

elements
Tipo: array<Microsoft.VisualStudio.Modeling.ModelElement[]
Uma lista de zero ou mais elementos no modelo são destacadas quando 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 o erro.

Comentários

LogErrornão envia o erro de validação para Visual Studio.

O VsValidationContext objeto causa o erro apareça na Error List janela de Visual Studio.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 verifica se o valor da propriedade de nascimento de cada pessoa não está antes de ou igual ao valor da propriedade de nascimento de seus pais.

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

[C#]

[ValidationMethod
(
    ValidationCategory.Open |
    ValidationCategory.Save |
    ValidationCategory.Menu
)
]
private void ValidateParentBirth(ValidationContext context)   
{
    foreach (Person parent in this.Parent)
    {
        if (this.Birth <= parent.Birth)
        {
            context.LogError(
                "Birth must be after Parent's birth",
                "FamilyParentBirthError", 
                this, 
                parent);
        }
    }
}

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