ValidationContext.LogWarning 方法
建立驗證警告,並將訊息記錄到驗證內容維護的集合中。
命名空間: Microsoft.VisualStudio.Modeling.Validation
組件: Microsoft.VisualStudio.Modeling.Sdk.12.0 (在 Microsoft.VisualStudio.Modeling.Sdk.12.0.dll 中)
語法
'宣告
Public Function LogWarning ( _
description As String, _
code As String, _
ParamArray elements As ModelElement() _
) As ValidationMessage
public ValidationMessage LogWarning(
string description,
string code,
params ModelElement[] elements
)
參數
- description
類型:System.String
描述這個警告的文字,並且如果發現違規情形,就會出現在 [錯誤清單] 視窗中。
- code
類型:System.String
識別這個警告的唯一字串。
- elements
類型:array<Microsoft.VisualStudio.Modeling.ModelElement[]
模型中的零個或多個項目的清單,這些項目是使用者在 [錯誤清單] 視窗中按兩下這個訊息時所反白顯示的項目。
傳回值
類型:Microsoft.VisualStudio.Modeling.Validation.ValidationMessage
含有警告相關資訊的驗證訊息。
備註
LogWarning 不會傳送警告的驗證對 Visual Studio。
VsValidationContext 物件會產生警告會出現在 [ 錯誤清單] 視窗中。 您提供的描述,因為此方法的參數是顯示在視窗的文字說明。
注意事項 |
---|
如果使用者在 [錯誤清單] 視窗中以滑鼠右鍵按一下然後按一下 [先前的錯誤] 或 [下一個錯誤],則清單中的項目也會反白顯示。 |
範例
下列範例會驗證類別的每個執行個體的已定義存在,而且該名稱符合規則運算式的預期格式。
如果發生違規, LogWarning 方法會將警告加入至清單會出現在 [錯誤清單] 視窗中。
[C#]
[ValidationMethod(
ValidationCategory.Menu
| ValidationCategory.Open
| ValidationCategory.Save)
]
protected void ValidateNameCorrectForm(ValidationContext context)
{
if (this.Name == null || this.Name.Trim().Length == 0 ||
!System.Text.RegularExpressions.Regex.IsMatch(this.Name,
"^[A-Za-z][A-Za-z0-9_]*$"))
{
string desc =
String.Format(CultureInfo.CurrentCulture,
DomainModel_Resource.WizardPageNameForm,
this.Name);
context.LogWarning(desc, "WizardPageNameForm", this);
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。