INameCreationService.ValidateName(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald die aangeeft of de opgegeven naam geldig is.
public:
void ValidateName(System::String ^ name);
public void ValidateName(string name);
abstract member ValidateName : string -> unit
Public Sub ValidateName (name As String)
Parameters
- name
- String
De naam die moet worden gevalideerd.
Voorbeelden
Het volgende codevoorbeeld bevat een voorbeeldmethode-implementatie INameCreationService.IsValidName die gebruikmaakt van een tekenreeksvalidatieschema dat elk teken van de opgegeven tekenreeks onderzoekt om te bepalen of de opgegeven tekenreeks een geldige naam is. De methode genereert een uitzondering als de tekenreeks ongeldig is.
// 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
Opmerkingen
Een implementatie van de INameCreationService database kan regels bevatten waarmee de parameters voor geldige namen worden gedefinieerd. Deze methode kan worden geïmplementeerd om een naam te valideren en deze regels af te dwingen.
Deze methode is vergelijkbaar met IsValidName, behalve dat deze methode een uitzondering genereert als de naam ongeldig is. Hierdoor kunnen implementeerfuncties gedetailleerde informatie opgeven in het uitzonderingsbericht.