StringValidator

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

StringValidator クラス

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

文字列の検証を提供します。

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

Visual Basic (宣言)

Public Class StringValidator
    Inherits ConfigurationValidatorBase

Visual Basic (使用法)

Dim instance As StringValidator

C#

public class StringValidator : ConfigurationValidatorBase

C++

public ref class StringValidator : public
 ConfigurationValidatorBase

J#

public class StringValidator extends ConfigurationValidatorBase

JScript

public class StringValidator extends
 ConfigurationValidatorBase

解説

StringValidator は、文字列が特定の基準を満たしていることを確認するために使用されます。検証の基準は、StringValidator がインスタンス化されたときに設定されます。StringValidator には、3 つのコンストラクタ オーバーロードがあります。パラメータが 1 つ指定された System.Configuration.StringValidator(Int32) コンストラクタは、検証される文字列に設定できる最小長を確認します。パラメータが 2 つ指定された System.Configuration.StringValidator(Int32,Int32) コンストラクタは、検証される文字列が、最小長と最大長の両方に従っていることを確認します。パラメータが 3 つ指定された System.Configuration.StringValidator(Int32,Int32,String) コンストラクタは、検証される文字列の最小長と最大長の両方を確認し、検証される文字列中に特定の文字が存在しているかどうかも確認します。

CanValidate メソッドは、検証されるオブジェクト型が、正しい型に一致しているかどうかを確認します。検証されるオブジェクトは、Validate メソッドのパラメータとして渡されます。

使用例

StringValidator 型を使用する方法を次のコード例に示します。

Visual Basic

Imports System
Imports System.Configuration

Namespace Samples.AspNet
  Class UsingStringValidator
    Public Shared Sub Main()

      ' Display title.
      Console.WriteLine("ASP.NET Validators")
      Console.WriteLine()

      ' Create string and validator.
      Dim testVal As String
 = "filename"
      Dim myStrValidator As StringValidator
 = New StringValidator(1, 8, "$%^")

      ' Determine if the object to validate can be validated.
      Console.WriteLine("CanValidate: {0}", _
        myStrValidator.CanValidate(testVal.GetType()))

      Try
        ' Attempt validation.
        myStrValidator.Validate(testVal)
        Console.WriteLine("Validated.")

      Catch e As Exception
        ' Validation failed.
        Console.WriteLine("Error: {0}", e.Message.ToString())
      End Try

      ' Display and wait.
      Console.ReadLine()
    End Sub
  End Class
End Namespace

C#

using System;
using System.Configuration;

namespace Samples.AspNet
{
  class UsingStringValidator
  {
    static void Main(string[]
 args)
    {
      // Display title.
      Console.WriteLine("ASP.NET Validators");
      Console.WriteLine();

      // Create string and validator.
      string testVal = "filename";
      StringValidator myStrValidator = new StringValidator(1,8
,"$%^");

      // Determine if the object to validate can be validated.
      Console.WriteLine("CanValidate: {0}",
        myStrValidator.CanValidate(testVal.GetType()));

      try
      {
        // Attempt validation.
        myStrValidator.Validate(testVal);
        Console.WriteLine("Validated.");
      }
      catch (ArgumentException e)
      {
        // Validation failed.
        Console.WriteLine("Error: {0}", e.Message.ToString());
      }

      // Display and wait.
      Console.ReadLine();
    }
  }
}

継承階層

System.Object
   System.Configuration.ConfigurationValidatorBase
    System.Configuration.StringValidator

スレッド セーフ

この型の 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

参照

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

StringValidator コンストラクタ (Int32)

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

指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    minLength As Integer _
)

Visual Basic (使用法)

Dim minLength As Integer

Dim instance As New StringValidator(minLength)

C#

public StringValidator (
    int minLength
)

C++

public:
StringValidator (
    int minLength
)

J#

public StringValidator (
    int minLength
)

JScript

public function StringValidator (
    minLength : int
)

パラメータ

minLength

文字列値の最小長を指定する整数。

解説

StringValidator コンストラクタは、検証される文字列に設定できる最小長を確認します。

プラットフォーム

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

参照

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

StringValidator コンストラクタ (Int32, Int32)

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

指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    minLength As Integer, _
    maxLength As Integer _
)

Visual Basic (使用法)

Dim minLength As Integer
Dim maxLength As Integer

Dim instance As New StringValidator(minLength,
 maxLength)

C#

public StringValidator (
    int minLength,
    int maxLength
)

C++

public:
StringValidator (
    int minLength, 
    int maxLength
)

J#

public StringValidator (
    int minLength, 
    int maxLength
)

JScript

public function StringValidator (
    minLength : int, 
    maxLength : int
)

パラメータ

minLength

文字列値の最小長を指定する整数。

maxLength

文字列値の最大長を指定する整数。

解説

この StringValidator コンストラクタは、検証される文字列が、最小長と最大長の両方に従っていることを確認します。

プラットフォーム

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

参照

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

StringValidator コンストラクタ (Int32, Int32, String)

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

指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    minLength As Integer, _
    maxLength As Integer, _
    invalidCharacters As String _
)

Visual Basic (使用法)

Dim minLength As Integer
Dim maxLength As Integer
Dim invalidCharacters As String

Dim instance As New StringValidator(minLength,
 maxLength, invalidCharacters)

C#

public StringValidator (
    int minLength,
    int maxLength,
    string invalidCharacters
)

C++

public:
StringValidator (
    int minLength, 
    int maxLength, 
    String^ invalidCharacters
)

J#

public StringValidator (
    int minLength, 
    int maxLength, 
    String invalidCharacters
)

JScript

public function StringValidator (
    minLength : int, 
    maxLength : int, 
    invalidCharacters : String
)

パラメータ

minLength

文字列値の最小長を指定する整数。

maxLength

文字列値の最大長を指定する整数。

invalidCharacters

無効な文字を表す文字列。

解説

この StringValidator コンストラクタは、検証される文字列が最小長と最大長の両方に従っていることを確認し、特定の文字が文字列に含まれていないことも確認します。

使用例

この StringValidator コンストラクタを使用する方法を次のコード例に示します。このコード例は、StringValidator クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Create string and validator.
Dim testVal As String =
 "filename"
Dim myStrValidator As StringValidator = New
 StringValidator(1, 8, "$%^")

C#

// Create string and validator.
string testVal = "filename";
StringValidator myStrValidator = new StringValidator(1,8,"$%^");

プラットフォーム

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

参照

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

StringValidator コンストラクタ

StringValidator クラスのインスタンスを初期化します。
オーバーロードの一覧

名前	説明
StringValidator (Int32)	指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。
StringValidator (Int32, Int32)	指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。
StringValidator (Int32, Int32, String)	指定されたパラメータに基づいて、StringValidator クラスのインスタンスを初期化します。

参照

関連項目

StringValidator クラス
StringValidator メンバ
System.Configuration 名前空間

StringValidator メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanValidate	オーバーライドされます。 オブジェクトを型に基づいて検証できるかどうかを確認します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Validate	オーバーライドされます。 オブジェクトの値が有効かどうかを確認します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

StringValidator クラス
System.Configuration 名前空間
StringValidatorAttribute
ConfigurationValidatorBase クラス

StringValidator メンバ

文字列の検証を提供します。

StringValidator データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	StringValidator	オーバーロードされます。 StringValidator クラスのインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	CanValidate	オーバーライドされます。 オブジェクトを型に基づいて検証できるかどうかを確認します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Validate	オーバーライドされます。 オブジェクトの値が有効かどうかを確認します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

StringValidator クラス
System.Configuration 名前空間
StringValidatorAttribute
ConfigurationValidatorBase クラス