INameCreationService.ValidateName(String) Метод

Определение

Пространство имен:

System.ComponentModel.Design.Serialization

Сборка:

System.ComponentModel.TypeConverter.dll

Возвращает значение, определяющее, является ли указанное имя допустимым.

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

public void ValidateName (string name);

abstract member ValidateName : string -> unit

Public Sub ValidateName (name As String)

Параметры

name

String

Имя для проверки.

Примеры

В следующем примере кода представлен пример INameCreationService.IsValidName реализации метода, использующего схему проверки строки, которая проверяет каждый символ указанной строки, чтобы определить, является ли указанная строка допустимым именем. Метод создает исключение, если строка недопустима.

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

Комментарии

Реализация INameCreationService может иметь правила, определяющие параметры для допустимых имен. Этот метод можно реализовать для проверки имени и применения этих правил.

Этот метод аналогичен методу IsValidName, за исключением того, что этот метод создает исключение, если имя недопустимо. Это позволяет разработчикам предоставлять подробные сведения в сообщении об исключении.