INameCreationService.ValidateName(String) Methode

Definition

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Ruft einen Wert ab, der angibt, ob der angegebene Name gültig ist.

public:
 void ValidateName(System::String ^ name);

public void ValidateName (string name);

abstract member ValidateName : string -> unit

Public Sub ValidateName (name As String)

Parameter

name

String

Der Name, dessen Gültigkeit validiert werden soll.

Beispiele

Das folgende Codebeispiel enthält eine Beispielmethodenimplementierung INameCreationService.IsValidName , die ein Zeichenfolgenvalidierungsschema verwendet, das jedes Zeichen der angegebenen Zeichenfolge untersucht, um zu bestimmen, ob die angegebene Zeichenfolge ein gültiger Name ist. Die -Methode löst eine Ausnahme aus, wenn die Zeichenfolge ungültig ist.

// 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 ) );
      }
   }
}

// 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.");                
        }
    }
}

' 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

Hinweise

Eine Implementierung von INameCreationService kann Über Regeln verfügen, die die Parameter für gültige Namen definieren. Diese Methode kann implementiert werden, um einen Namen zu überprüfen und diese Regeln zu erzwingen.

Diese Methode ähnelt IsValidName, mit der Ausnahme, dass diese Methode eine Ausnahme auslöst, wenn der Name ungültig ist. Dadurch können Implementierer detaillierte Informationen in der Ausnahmemeldung bereitstellen.