BaseFieldControl.ErrorMessage 属性

项目
05/13/2015

获取或设置一条消息，指示，并且可能原因， Value的当前值无效。

命名空间： Microsoft.SharePoint.WebControls
程序集： Microsoft.SharePoint（位于 Microsoft.SharePoint.dll 中）

语法

声明
Public Property ErrorMessage As String
    Get
    Set
用法
Dim instance As BaseFieldControl
Dim value As String

value = instance.ErrorMessage

instance.ErrorMessage = value

public string ErrorMessage { get; set; }

属性值

类型：System.String
表示的错误消息String 。

实现

IValidator.ErrorMessage

示例

下面是设置ErrorMessageValidate方法的重写的示例。首先检查以查看当前控制模式是否显示，这种情况下它并不重要是否域无效，因为它仍然不能更改。此方法还查看如果已经已知Value属性可通过检查IsValid属性无效。如果任一这些检查，则返回 true，则没有任何影响。如果既不为 true，该方法将调用基Validate会将IsValid设置为false ，如果找到Value属性有什么问题，并设置相应的ErrorMessage。( BaseFieldControl.Validate方法没有任何影响，因此如果直接从BaseFieldControl，然后对基Validate方法的调用派生其Validate方法将被覆盖的类可省略。）最后，该方法检查Required的值，并强制该值。

public override void Validate()
{
    if (ControlMode == SPControlMode.Display || !IsValid)
    {
        return;
    }

    base.Validate();

    if (Field.Required && 
        (Value == null || Value.ToString().Length == 0))
    {
        this.ErrorMessage = Field.Title + " must have a value."
        IsValid = false;
        return;
    }
}

Public Overrides Sub Validate()
    If ControlMode = SPControlMode.Display OrElse (Not IsValid) Then
        Return
    End If

    MyBase.Validate()

    If Field.Required AndAlso (Value Is Nothing OrElse Value.ToString().Length = 0) Then
        Me.ErrorMessage = Field.Title & " must have a value." 
            IsValid = False

        Return
    End If
End Sub