INameCreationService.ValidateName(String) Metoda

Definice

Obor názvů:

System.ComponentModel.Design.Serialization

Sestavení:

System.ComponentModel.TypeConverter.dll

Získá hodnotu označující, zda je zadaný název platný.

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

public void ValidateName (string name);

abstract member ValidateName : string -> unit

Public Sub ValidateName (name As String)

Parametry

name

String

Název, který chcete ověřit.

Příklady

Následující příklad kódu poskytuje příklad INameCreationService.IsValidName implementace metody, která používá schéma ověření řetězce, které zkoumá každý znak zadaného řetězce určit, zda zadaný řetězec je platný název. Metoda vyvolá výjimku, pokud řetězec není platný.

// 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

Poznámky

Implementace může INameCreationService obsahovat pravidla, která definují parametry pro platné názvy. Tuto metodu je možné implementovat k ověření názvu a vynucení těchto pravidel.

Tato metoda je podobná IsValidNamemetodě s tím rozdílem, že tato metoda vyvolá výjimku, pokud je název neplatný. To umožňuje implementátorům poskytnout podrobné informace ve zprávě o výjimce.