CodeDomProvider.CreateValidIdentifier(String) Méthode

Définition

Espace de noms:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Paquet:

System.CodeDom v8.0.0

Source:

CodeDomProvider.cs

Crée un identificateur valide pour la valeur spécifiée.

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

Paramètres

value

String

Chaîne pour laquelle un identificateur valide doit être généré.

Retours

String

Identificateur valide pour la valeur spécifiée.

Exceptions

NotImplementedException

Ni cette méthode ni la méthode CreateGenerator() ne sont substituées dans une classe dérivée.

Remarques

CreateValidIdentifier teste si l’identificateur est en conflit avec des mots clés réservés ou linguistiques et, le cas échéant, tente de renvoyer un nom d’identificateur valide qui n’est pas en conflit. En règle générale, l’identificateur retourné n’est que légèrement modifié pour différencier l’identificateur du mot clé ; par exemple, le nom peut être précédé du caractère de trait de soulignement (« _ »).

Notes

Dans les versions 1.0 et 1.1 du .NET Framework, cette méthode est fournie par l’implémentation ICodeGenerator retournée par la CreateGenerator méthode du fournisseur. Dans la version 2.0, cette méthode peut être appelée directement sur le fournisseur de code même si elle n’est pas remplacée par le fournisseur de code. Si le fournisseur de code ne remplace pas cette méthode, l’implémentation ICodeGenerator est appelée par la classe de base.

Notes pour les héritiers

Si vous remplacez cette méthode, vous ne devez pas appeler la méthode correspondante de la classe de base. La méthode de classe de base crée un générateur dans la classe dérivée à l’aide de la méthode obsolète CreateGenerator() pour la compatibilité avec les fournisseurs préexistants qui utilisent des générateurs de code. La méthode de classe de base appelle ensuite la méthode équivalente dans l’implémentation ICodeGenerator pour effectuer cette fonction. Vous obtiendrez un NotImplementedException si vous appelez la méthode de classe de base à partir d’un fournisseur de code qui n’utilise pas de générateur de code.