ValidationContext.LogMessage-Methode
Erstellt eine Validierungsinformationsmeldung und protokolliert sie in der Sammlung, die der Validierungskontext beibehält.
Namespace: Microsoft.VisualStudio.Modeling.Validation
Assembly: Microsoft.VisualStudio.Modeling.Sdk.12.0 (in Microsoft.VisualStudio.Modeling.Sdk.12.0.dll)
Syntax
'Declaration
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
)
Parameter
- description
Typ: System.String
Der Text, der diese Meldung beschreibt und im Fenster "Fehlerliste" angezeigt wird, wenn eine Verletzung gefunden wird.
- code
Typ: System.String
Eine eindeutige Zeichenfolgen, die diese Meldung identifiziert.
- elements
Typ: array<Microsoft.VisualStudio.Modeling.ModelElement[]
Eine Liste von null oder mehr Elementen im Modell, die markiert werden, wenn ein Benutzer auf diese Meldung im Fenster Fehlerliste doppelt klickt.
Rückgabewert
Typ: Microsoft.VisualStudio.Modeling.Validation.ValidationMessage
Eine Validierungsmeldung, die Informationen zur Meldung enthält.
Hinweise
LogMessage sendet die Validierungsmeldung nicht zu Visual Studio.
Das VsValidationContext-Objekt wird die Meldung, im Fenster Fehlerliste angezeigt. Die Beschreibung, die Sie bereitstellen, als Parameter an diese Methode die Texterklärung ist, die im Fenster angezeigt.
Hinweis
Die Elemente in der Liste werden auch hervorgehoben, wenn der Benutzer im Fenster Fehlerliste mit der rechten Maustaste klicken und dann auf Nächster Fehler oder auf Vorheriger Fehler klickt.
Beispiele
Im folgenden Beispiel wird überprüft, ob die Anzahl der untergeordneten Elemente für jede Person nicht größer als 20 ist.
Wenn einer Verletzung auftritt, fügt die LogMessage methode einer Warnung der Liste von Meldungen hinzu, die im Fenster Fehlerliste werden.
[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
);
}
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.