ValidationContext.LogMessage 方法
建立驗證資訊訊息,並將該訊息記錄到驗證內容維護的集合中。
命名空間: Microsoft.VisualStudio.Modeling.Validation
組件: Microsoft.VisualStudio.Modeling.Sdk.12.0 (在 Microsoft.VisualStudio.Modeling.Sdk.12.0.dll 中)
語法
'宣告
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
)
參數
- description
類型:System.String
描述這個訊息的文字,並且如果發現違規情形,就會出現在 [錯誤清單] 視窗中。
- code
類型:System.String
識別這個訊息的唯一字串。
- elements
類型:array<Microsoft.VisualStudio.Modeling.ModelElement[]
模型中的零個或多個項目的清單,這些項目是使用者在 [錯誤清單] 視窗中按兩下這個訊息時所反白顯示的項目。
傳回值
類型:Microsoft.VisualStudio.Modeling.Validation.ValidationMessage
包含訊息相關資訊的驗證訊息。
備註
LogMessage 不會傳送驗證資訊至 Visual Studio。
VsValidationContext 物件會造成訊息會出現在 [錯誤清單 ] 視窗中。 您提供的描述,因為此方法的參數是顯示在視窗的文字說明。
注意事項 |
---|
如果使用者在 [錯誤清單] 視窗中以滑鼠右鍵按一下然後按一下 [先前的錯誤] 或 [下一個錯誤],則清單中的項目也會反白顯示。 |
範例
下列範例會驗證子系數目每個人的是否不大於 20。
如果發生違規, LogMessage 方法會將警告加入至出現在 [錯誤清單] 視窗中的訊息清單。
[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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。