INameCreationService.ValidateName メソッド

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

INameCreationService.ValidateName メソッド

指定した名前が有効かどうかを示す値を取得します。

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Sub ValidateName ( _
    name As String _
)

Visual Basic (使用法)

Dim instance As INameCreationService
Dim name As String

instance.ValidateName(name)

C#

void ValidateName (
    string name
)

C++

void ValidateName (
    String^ name
)

J#

void ValidateName (
    String name
)

JScript

function ValidateName (
    name : String
)

パラメータ

name

検証対象の名前。

解説

INameCreationService の実装は、有効な名前のパラメータを定義する規則を持つことができます。このメソッドを実装して、名前を検証し、上記の規則を適用できます。

このメソッドは IsValidName に類似していますが、名前が無効である場合に例外をスローするという点が異なります。これにより、例外メッセージに詳細な情報を指定できます。

使用例

次に示すのは、INameCreationService.IsValidName メソッドを実装するコード例です。文字列検証スキームを使用して指定文字列の各文字を確認し、指定文字列が有効な名前であるかどうかを判定します。文字列が有効でない場合、このメソッドは例外をスローします。

Visual Basic

' Throws an exception if the specified name does not contain 
' all valid character types.
Public Sub ValidateName(ByVal
 name As String) Implements
 INameCreationService.ValidateName
    Dim i As Integer
    For i = 0 To name.Length - 1
        Dim ch As Char =
 name.Chars(i)
        Dim uc As UnicodeCategory = [Char].GetUnicodeCategory(ch)
        Select Case uc
            Case UnicodeCategory.UppercaseLetter, UnicodeCategory.LowercaseLetter,
 UnicodeCategory.TitlecaseLetter, UnicodeCategory.DecimalDigitNumber
            Case Else
                Throw New Exception("The
 name '" + name + "' is not a valid identifier.")
        End Select
    Next i
End Sub

C#

// Throws an exception if the specified name does not contain 
// all valid character types.
public void ValidateName(string
 name)
{
    for(int i = 0; i < name.Length; i++)
    {
        char ch = name[i];
        UnicodeCategory uc = Char.GetUnicodeCategory(ch);
        switch (uc) 
        {
            case UnicodeCategory.UppercaseLetter:       
            case UnicodeCategory.LowercaseLetter:     
            case UnicodeCategory.TitlecaseLetter:            
                                      
            case UnicodeCategory.DecimalDigitNumber:         
                
                break;
            default:
                throw new Exception("The name '"+name+"'
 is not a valid identifier.");                
        }
    }
}

C++

// Throws an exception if the specified name does not contain 
// all valid character types.
virtual void ValidateName( String^ name )
{
   for ( int i = 0; i < name->Length;
 i++ )
   {
      Char ch = name[ i ];
      UnicodeCategory uc = Char::GetUnicodeCategory( ch );
      switch ( uc )
      {
         case UnicodeCategory::UppercaseLetter:
         case UnicodeCategory::LowercaseLetter:
         case UnicodeCategory::TitlecaseLetter:
         case UnicodeCategory::DecimalDigitNumber:
            break;

         default:
            throw gcnew Exception( String::Format( "The name '{0}' is not a
 valid identifier.", name ) );
      }
   }
}

J#

// Throws an exception if the specified name does not contain 
// all valid character types.
public void ValidateName(String name)throws
 java.lang.Exception
{
    for (int i = 0; i < name.length(); i++)
 {
        char ch = name.get_Chars(i);
        UnicodeCategory uc = Char.GetUnicodeCategory(ch);
        switch (uc) {
            case UnicodeCategory.UppercaseLetter:
            case UnicodeCategory.LowercaseLetter:
            case UnicodeCategory.TitlecaseLetter:
            case UnicodeCategory.DecimalDigitNumber:
                break;

            default:
                throw new Exception("The name '" + name
 
                    + "' is not a valid identifier.");
        }
    }
} //ValidateName

プラットフォーム

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、1.1、1.0

参照

関連項目
INameCreationService インターフェイス
INameCreationService メンバ
System.ComponentModel.Design.Serialization 名前空間