StringValidatorAttribute クラス

.NET Framework クラス ライブラリ リファレンス

StringValidatorAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

.NET Framework が構成プロパティに対して文字列の検証を実行するように、宣言によって指示します。このクラスは継承できません。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As StringValidatorAttribute

C#

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

C++

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

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */ 
public final class StringValidatorAttribute
 extends ConfigurationValidatorAttribute

JScript

AttributeUsageAttribute(AttributeTargets.Property) 
public final class StringValidatorAttribute
 extends ConfigurationValidatorAttribute

解説

StringValidatorAttribute を使用して、構成プロパティを装飾します。これは、.NET Framework に StringValidator を使用してプロパティを検証するように指示し、装飾のパラメータの値を渡すためです。

StringValidatorAttribute オブジェクトは、プロパティ型だけに適用できます。

使用例

StringValidatorAttribute オブジェクトを使用して、カスタム ConfigurationSection オブジェクトのプロパティを装飾する方法を、次のコード例に示します。

Visual Basic

<ConfigurationProperty("fileName", _
DefaultValue:="default.txt", _
IsRequired:=True, _
IsKey:=False), _
StringValidator( _
InvalidCharacters:=" ~!@#$%^&*()[]{}/;'""|\",
 _
MinLength:=1, _
MaxLength:=60)> _
Public Property FileName() As
 String
    Get
        Return CStr(Me("fileName"))
    End Get
    Set(ByVal value As String)
        Me("fileName") = value
    End Set
End Property

C#

[ConfigurationProperty("fileName", DefaultValue = "default.txt"
,
    IsRequired = true, IsKey = false)]
[StringValidator(InvalidCharacters = " ~!@#$%^&*()[]{}/;'\"|\\"
,
    MinLength = 1, MaxLength = 60)]
public string FileName
{
    get
    {
        return (string)this["fileName"];
    }
    set
    {
        this["fileName"] = value;
    }
}

継承階層

System.Object
   System.Attribute
     System.Configuration.ConfigurationValidatorAttribute
      System.Configuration.StringValidatorAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
StringValidatorAttribute メンバ
System.Configuration 名前空間
ConfigurationValidatorAttribute クラス
ConfigurationPropertyAttribute クラス
StringValidator クラス