CodeDomProvider.IsValidIdentifier(String) Método

Definição

Namespace:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Pacote:

System.CodeDom v8.0.0

Origem:

CodeDomProvider.cs

Retorna um valor que indica se o valor especificado é um identificador válido para a linguagem de programação atual.

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

Parâmetros

value

String

O valor a ser verificado como um identificador válido.

Retornos

Boolean

true se o parâmetro value é um identificador válido; caso contrário, false.

Exceções

NotImplementedException

Nem esse método nem o método CreateGenerator() são substituídos em uma classe derivada.

Comentários

Esse método testa se um identificador é válido. O IsValidIdentifier método é específico do provedor. Identificadores válidos para um provedor podem não ser válidos para outros provedores. Se value contiver caracteres fora do intervalo de caracteres ASCII, marcar o identificador para todos os idiomas que podem ser usados para compilar o código.

Observação

No .NET Framework versões 1.0 e 1.1, esse método é fornecido pela ICodeGenerator implementação retornada pelo CreateGenerator método do provedor. Na versão 2.0, esse método pode ser chamado diretamente no provedor de código, mesmo que não seja substituído pelo provedor de código. Se o provedor de código não substituir esse método, a ICodeGenerator implementação será chamada pela classe base.

Notas aos Herdeiros

Ao substituir IsValidIdentifier(String) em uma classe derivada, projete o método para retornar true somente se o valor se ajustar às regras do idioma e não entrar em conflito com um palavra-chave.

Se você substituir esse método, não deverá chamar o método correspondente da classe base. O método de classe base cria um gerador na classe derivada usando o método obsoleto CreateGenerator() para compatibilidade com provedores pré-existentes que usam geradores de código. Em seguida, o método de classe base chama o método equivalente na ICodeGenerator implementação para executar essa função. Você receberá um NotImplementedException se chamar o método de classe base de um provedor de código que não usa um gerador de código.