CodeDomProvider.IsValidIdentifier(String) Methode

Definition

Namespace:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Paket:

System.CodeDom v8.0.0

Quelle:

CodeDomProvider.cs

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 validiert werden soll.

Gibt zurück

Boolean

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

Ausnahmen

NotImplementedException

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

Hinweise

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

Hinweis

In den .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 im Codeanbieter aufgerufen werden, auch wenn sie nicht vom Codeanbieter überschrieben wird. Wenn der Codeanbieter diese Methode nicht überschreibt, wird die ICodeGenerator Implementierung von der Basisklasse aufgerufen.

Hinweise für Vererber

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

Wenn Sie diese Methode überschreiben, dürfen Sie nicht die entsprechende Methode der Basisklasse aufrufen. Die Basisklassenmethode erstellt einen Generator in der abgeleiteten Klasse, indem die veraltete CreateGenerator() Methode verwendet wird, um die Kompatibilität mit bereits vorhandenen Anbietern zu gewährleisten, die Codegeneratoren verwenden. Die Basisklassenmethode ruft dann die entsprechende Methode in der ICodeGenerator Implementierung auf, um diese Funktion auszuführen. Sie erhalten eine NotImplementedException , wenn Sie die Basisklassenmethode von einem Codeanbieter aufrufen, der keinen Codegenerator verwendet.