CodeDomProvider.CreateEscapedIdentifier(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 avec séquence d'échappement pour la valeur spécifiée.

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

public virtual string CreateEscapedIdentifier (string value);

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

Public Overridable Function CreateEscapedIdentifier (value As String) As String

Paramètres

value

String

Chaîne pour laquelle un identificateur avec séquence d'échappement doit être créé.

Retours

String

Identificateur avec séquence d'échappement pour la valeur.

Exceptions

NotImplementedException

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

Remarques

CreateEscapedIdentifier teste si l’identificateur est en conflit avec des mots clés réservés ou de langue et, le cas échéant, retourne un nom équivalent avec une mise en forme de code d’échappement spécifique à la langue. Il s’agit d’un identificateur d’échappement. L’identificateur d’échappement contient le mêmevalue, mais la mise en forme du code d’échappement est ajoutée pour différencier l’identificateur de l’mot clé. Deux exemples d’implémentation précèdent le value avec « @ » ou entre crochets avec value « [ » et « ] ».

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.