INameCreationService.ValidateName(String) Método

Definición

Espacio de nombres:

System.ComponentModel.Design.Serialization

Ensamblado:

System.ComponentModel.TypeConverter.dll

Obtiene un valor que indica si el nombre especificado es válido.

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

public void ValidateName (string name);

abstract member ValidateName : string -> unit

Public Sub ValidateName (name As String)

Parámetros

name

String

Nombre que se va a validar.

Ejemplos

En el ejemplo de código siguiente se proporciona una implementación de método de ejemplo INameCreationService.IsValidName que usa un esquema de validación de cadenas que examina cada carácter de la cadena especificada para determinar si la cadena especificada es un nombre válido. El método produce una excepción si la cadena no es válida.

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

Comentarios

Una implementación de INameCreationService puede tener reglas que definan los parámetros para los nombres válidos. Este método se puede implementar para validar un nombre y aplicar esas reglas.

Este método es similar a IsValidName, salvo que este método produce una excepción si el nombre no es válido. Esto permite a los implementadores proporcionar información detallada en el mensaje de excepción.