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 クラス