Udostępnij za pośrednictwem

Metoda ValidationContext.LogMessage —

  • Artykuł

Tworzy wiadomość sprawdzania poprawności informacji i loguje się do kolekcji utworzonej w kontekście sprawdzania poprawności.

Przestrzeń nazw:  Microsoft.VisualStudio.Modeling.Validation
Zestaw:  Microsoft.VisualStudio.Modeling.Sdk.11.0 (w Microsoft.VisualStudio.Modeling.Sdk.11.0.dll)

Składnia

'Deklaracja
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
)

Parametry

  • description
    Typ: System.String
    Tekst, który opisuje tę wiadomość i który jest wyświetlany w oknie Lista błędów, jeśli stwierdzono naruszenie.
  • code
    Typ: System.String
    Unikatowy ciąg, który identyfikuje tę wiadomość.
  • elements
    Typ: array<Microsoft.VisualStudio.Modeling.ModelElement[]
    Lista zero lub więcej elementów, które są w modelu i że zostaną wyróżnione, jeśli użytkownik kliknie dwukrotnie tę wiadomość w oknie Lista błędów.

Wartość zwracana

Typ: Microsoft.VisualStudio.Modeling.Validation.ValidationMessage
Komunikat sprawdzania poprawności, który zawiera informacje o wiadomości.

Uwagi

LogMessagenie wysyła komunikat sprawdzania poprawności do Visual Studio.

VsValidationContext Obiektu powoduje, że wiadomości są wyświetlane w Listy błędów okna.Opis, który jest udostępniany jako parametr do tej metody jest wyjaśnienie tekstowy, który pojawia się w oknie.

[!UWAGA]

Jeśli użytkownik kliknie w prawym przyciskiem myszy elementy na liście są wyróżnione Listy błędów okna, a następnie kliknie opcję Poprzedni błąd lub Następny błąd.

Przykłady

Poniższy przykład sprawdza, czy liczba dzieci dla każdej osoby, nie jest większa niż 20.

Jeśli okaże się to naruszenie, LogMessage metoda dodaje ostrzeżenie do listy wiadomości, które pojawiają się w Listy błędów okna.

[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 
        );
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

ValidationContext Klasa

Przestrzeń nazw Microsoft.VisualStudio.Modeling.Validation