CodeDomProvider.IsValidIdentifier(String) Methode

Definition

Gibt einen Wert zurück, der angibt, ob der angegebene Wert ein gültiger Bezeichner für die aktuelle Sprache ist.

public:
 virtual bool IsValidIdentifier(System::String ^ value);
public virtual bool IsValidIdentifier(string value);
abstract member IsValidIdentifier : string -> bool
override this.IsValidIdentifier : string -> bool
Public Overridable Function IsValidIdentifier (value As String) As Boolean

Parameter

value
String

Der Wert, der als gültiger Bezeichner überprüft werden soll.

Gibt zurück

true wenn der value Parameter ein gültiger Bezeichner ist; andernfalls false.

Ausnahmen

Weder diese Methode noch die CreateGenerator() Methode wird in einer abgeleiteten Klasse überschrieben.

Hinweise

Diese Methode prüft, ob ein Bezeichner gültig ist. Die IsValidIdentifier Methode ist anbieterspezifisch. Bezeichner, die für einen Anbieter gültig sind, sind möglicherweise für andere Anbieter nicht gültig. Wenn value Zeichen außerhalb des ASCII-Zeichenbereichs enthalten sind, überprüfen Sie den Bezeichner für alle Sprachen, die zum Kompilieren des Codes verwendet werden können.

Note

In .NET Framework-Versionen 1.0 und 1.1 wird diese Methode von der ICodeGenerator-Implementierung bereitgestellt, die von der CreateGenerator-Methode des Anbieters zurückgegeben wird. In Version 2.0 kann diese Methode direkt für den Codeanbieter aufgerufen werden, auch wenn sie vom Codeanbieter nicht außer Kraft gesetzt wird. Wenn der Codeanbieter diese Methode nicht überschreibt, wird die ICodeGenerator Implementierung von der Basisklasse aufgerufen.

Hinweise für Vererber

Entwerfen Sie beim Überschreiben IsValidIdentifier(String) in einer abgeleiteten Klasse die Methode so, dass sie nur zurückgegeben true wird, wenn der Wert den Regeln der Sprache entspricht und nicht mit einem Schlüsselwort in Konflikt steht.

Wenn Sie diese Methode außer Kraft setzen, dürfen Sie die entsprechende Methode der Basisklasse nicht aufrufen. Die Basisklassenmethode erstellt einen Generator in der abgeleiteten Klasse mithilfe der veralteten CreateGenerator() Methode zur Kompatibilität mit bereits vorhandenen Anbietern, die Codegeneratoren verwenden. Die Basisklassenmethode ruft dann die entsprechende Methode in der ICodeGenerator Implementierung auf, um diese Funktion auszuführen. Sie erhalten einen NotImplementedException Fall, wenn Sie die Basisklassenmethode von einem Codeanbieter aufrufen, der keinen Codegenerator verwendet.

Gilt für: