CodeDomProvider.IsValidIdentifier(String) Método

Definição

Retorna um valor que indica se o valor especificado é um identificador válido para a linguagem de programação atual.Returns a value that indicates whether the specified value is a valid identifier for the current language.

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.The value to verify as a valid identifier.

Retornos

Boolean

true se o parâmetro value é um identificador válido; caso contrário, false.true if the value parameter is a valid identifier; otherwise, false.

Exceções

Nem esse método nem o método CreateGenerator() são substituídos em uma classe derivada.Neither this method nor the CreateGenerator() method is overridden in a derived class.

Comentários

Esse método testa se um identificador é válido.This method tests whether an identifier is valid. O IsValidIdentifier método é específico do provedor.The IsValidIdentifier method is provider specific. Identificadores que são válidos para um provedor podem não ser válidos para outros provedores.Identifiers that are valid for one provider might not be valid for other providers. Se value contiver caracteres fora do intervalo de caracteres ASCII, verifique o identificador de todos os idiomas que podem ser usados para compilar o código.If value contains characters outside of the ASCII character range, check the identifier for all the languages that might be used to compile the code.

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.In the .NET Framework versions 1.0 and 1.1, this method is provided by the ICodeGenerator implementation that is returned by the CreateGenerator method of the provider. Na versão 2,0, esse método pode ser chamado diretamente no provedor de código, mesmo se ele não for substituído pelo provedor de código.In version 2.0, this method can be called directly on the code provider even if it is not overridden by the code provider. Se o provedor de código não substituir esse método, a ICodeGenerator implementação será chamada pela classe base.If the code provider does not override this method, the ICodeGenerator implementation is called by the base class.

Notas aos Herdeiros

Ao substituir IsValidIdentifier(String) em uma classe derivada, projete o método para retornar true somente se o valor couber nas regras do idioma e não entrar em conflito com uma palavra-chave.When overriding IsValidIdentifier(String) in a derived class, design the method to return true only if the value fits the rules of the language and does not conflict with a keyword.

Se você substituir esse método, não deverá chamar o método correspondente da classe base.If you override this method, you must not call the corresponding method of the base class. O método de classe base cria um gerador na classe derivada usando o método obsoleto CreateGenerator() para compatibilidade com provedores preexistentes que usam geradores de código.The base-class method creates a generator in the derived class using the obsolete CreateGenerator() method for compatibility with preexisting providers that use code generators. Em seguida, o método de classe base chama o método equivalente na ICodeGenerator implementação para executar essa função.The base-class method then calls the equivalent method in the ICodeGenerator implementation to perform this function. 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.You will get a NotImplementedException if you call the base-class method from a code provider that does not use a code generator.

Aplica-se a