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