CodeDomProvider.CreateValidIdentifier(String) Methode

Definition

Namespace:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Paket:

System.CodeDom v8.0.0

Quelle:

CodeDomProvider.cs

Erstellt einen gültigen Bezeichner für den angegebenen Wert.

public:
 virtual System::String ^ CreateValidIdentifier(System::String ^ value);

public virtual string CreateValidIdentifier (string value);

abstract member CreateValidIdentifier : string -> string
override this.CreateValidIdentifier : string -> string

Public Overridable Function CreateValidIdentifier (value As String) As String

Parameter

value

String

Die Zeichenfolge, für die ein gültiger Bezeichner generiert werden soll.

Gibt zurück

String

Ein gültiger Bezeichner für den angegebenen Wert.

Ausnahmen

NotImplementedException

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

Hinweise

CreateValidIdentifier testet, ob der Bezeichner mit reservierten Schlüsselwörtern oder Sprachschlüsselwörtern in Konflikt steht, und versucht, einen gültigen Bezeichnernamen zurückzugeben, der keinen Konflikt darstellt. In der Regel wird der zurückgegebene Bezeichner nur geringfügig geändert, um den Bezeichner vom Schlüsselwort (keyword) zu unterscheiden. Beispielsweise kann dem Namen der Unterstrich ("_") vorangestellt werden.

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 auf dem 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

Wenn Sie diese Methode überschreiben, dürfen Sie die entsprechende Methode der Basisklasse nicht aufrufen. Die Basisklassenmethode erstellt einen Generator in der abgeleiteten Klasse unter Verwendung 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 eine NotImplementedException , wenn Sie die Basisklassenmethode von einem Codeanbieter aufrufen, der keinen Codegenerator verwendet.