INameCreationService.ValidateName(String) Metodo

Definizione

Spazio dei nomi:

System.ComponentModel.Design.Serialization

Assembly:

System.ComponentModel.TypeConverter.dll

Ottiene un valore che indica se il nome specificato è valido.

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

public void ValidateName (string name);

abstract member ValidateName : string -> unit

Public Sub ValidateName (name As String)

Parametri

name

String

Nome da convalidare.

Esempio

Nell'esempio di codice seguente viene fornita un'implementazione di metodo di esempio INameCreationService.IsValidName che usa uno schema di convalida della stringa che esamina ogni carattere della stringa specificata per determinare se la stringa specificata è un nome valido. Il metodo genera un'eccezione se la stringa non è valida.

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

Commenti

Un'implementazione di INameCreationService può avere regole che definiscono i parametri per i nomi validi. Questo metodo può essere implementato per convalidare un nome e applicare tali regole.

Questo metodo è simile a IsValidName, ad eccezione del fatto che questo metodo genera un'eccezione se il nome non è valido. Ciò consente ai responsabili dell'implementazione di fornire informazioni dettagliate nel messaggio di eccezione.