CodeDomProvider.IsValidIdentifier(String) Méthode

Définition

Espace de noms:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Paquet:

System.CodeDom v11.0.0-preview.4.26230.115

Source:

CodeDomProvider.cs

Retourne une valeur qui indique si la valeur spécifiée est un identificateur valide pour la langue actuelle.

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 en tant qu’identificateur valide.

Retours

Boolean

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

Exceptions

NotImplementedException

Ni cette méthode ni la CreateGenerator() méthode ne sont remplacé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 toutes les langues qui peuvent être utilisées pour compiler le code.

Note

Dans .NET Framework versions 1.0 et 1.1, cette méthode est fournie par l’implémentation ICodeGenerator retournée par la méthode CreateGenerator 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 retourner true 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.