RegexStringValidatorAttribute Class (System.Configuration)

.NET Framework Class Library

RegexStringValidatorAttribute Class

Declaratively instructs the .NET Framework to perform string validation on a configuration property using a regular expression. This class cannot be inherited.

Namespace: System.Configuration
Assembly: System.Configuration (in System.Configuration.dll)

Syntax

Visual Basic (Declaration)

<AttributeUsageAttribute(AttributeTargets.Property)> _
Public NotInheritable Class RegexStringValidatorAttribute _
    Inherits ConfigurationValidatorAttribute

Visual Basic (Usage)

Dim instance As RegexStringValidatorAttribute

[AttributeUsageAttribute(AttributeTargets.Property)]
public sealed class RegexStringValidatorAttribute : ConfigurationValidatorAttribute

Visual C++

[AttributeUsageAttribute(AttributeTargets::Property)]
public ref class RegexStringValidatorAttribute sealed : public ConfigurationValidatorAttribute

JScript

public final class RegexStringValidatorAttribute extends ConfigurationValidatorAttribute

Remarks

You use the RegexStringValidatorAttribute to decorate a configuration property, which will instruct the .NET Framework to validate the property using the RegexStringValidator and pass to it the value of the decorating parameters.

You may apply RegexStringValidatorAttribute objects to property types only.

Examples

The following example shows how to decorate the properties of a custom ConfigurationSection object using the RegexStringValidatorAttribute object.

Visual Basic

<ConfigurationProperty("alias2", _
DefaultValue:="alias.txt", _
IsRequired:=True, _
IsKey:=False), _
RegexStringValidator("\w+\S*")> _
Public Property Alias2() As String
    Get
        Return CStr(Me("alias2"))
    End Get
    Set(ByVal value As String)
        Me("alias2") = value
    End Set
End Property

[ConfigurationProperty("alias2", DefaultValue = "alias.txt",
    IsRequired = true, IsKey = false)]
[RegexStringValidator(@"\w+\S*")]
public string Alias2
{
    get
    {
        return (string)this["alias2"];
    }
    set
    {
        this["alias2"] = value;
    }
}

Inheritance Hierarchy

System..::.Object
  System..::.Attribute
    System.Configuration..::.ConfigurationValidatorAttribute
      System.Configuration..::.RegexStringValidatorAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

RegexStringValidatorAttribute Members

System.Configuration Namespace

ConfigurationValidatorAttribute

ConfigurationPropertyAttribute

RegexStringValidator