CodeDomProvider.IsValidIdentifier(String) Méthode

Définition

Espace de noms:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Paquet:

System.CodeDom v8.0.0

Source:

CodeDomProvider.cs

Retourne une valeur indiquant si la valeur spécifiée est un identificateur valide pour le langage actuel.

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

Paramètres

value

String

Valeur à vérifier comme identificateur valide.

Retours

Boolean

true si le paramètre value est un identificateur valide ; sinon, false.

Exceptions

NotImplementedException

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

Remarques

Cette méthode teste si un identificateur est valide. La IsValidIdentifier méthode est spécifique au fournisseur. Les identificateurs valides pour un fournisseur peuvent ne pas être valides pour d’autres fournisseurs. Si value contient des caractères en dehors de la plage de caractères ASCII, vérifiez l’identificateur de tous les langages qui peuvent être utilisés pour compiler le code.

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

En cas de IsValidIdentifier(String) substitution dans une classe dérivée, concevez la méthode pour qu’elle true retourne uniquement si la valeur correspond aux règles du langage et n’est pas en conflit avec un mot clé.

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.