CodeDomProvider.CreateValidIdentifier(String) Método

Definição

Namespace:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Pacote:

System.CodeDom v8.0.0

Origem:

CodeDomProvider.cs

Cria um identificador válido para o valor especificado.

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

public virtual string CreateValidIdentifier (string value);

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

Public Overridable Function CreateValidIdentifier (value As String) As String

Parâmetros

value

String

A cadeia de caracteres para a qual gerar um identificador válido.

Retornos

String

Um identificador válido para o valor especificado.

Exceções

NotImplementedException

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

Comentários

CreateValidIdentifier testa se o identificador está em conflito com palavras-chave reservadas ou de idioma e, nesse caso, tenta retornar um nome de identificador válido que não está em conflito. Normalmente, o identificador retornado é apenas ligeiramente modificado para diferenciar o identificador do palavra-chave; por exemplo, o nome pode ser precedido pelo caractere sublinhado ("_").

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

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 preexistidos 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.