CodeDomProvider.CreateEscapedIdentifier(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 de escape para o valor especificado.

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

public virtual string CreateEscapedIdentifier (string value);

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

Public Overridable Function CreateEscapedIdentifier (value As String) As String

Parâmetros

value

String

A cadeia de caracteres para a qual criar um identificador de escape.

Retornos

String

O identificador de escape para o valor.

Exceções

NotImplementedException

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

Comentários

CreateEscapedIdentifier testa se o identificador está em conflito com palavras-chave reservadas ou de idioma e, nesse caso, retorna um nome equivalente com formatação de código de escape específico do idioma. Isso é referenciado a um identificador de escape. O identificador de escape contém o mesmovalue, mas tem formatação de código de escape adicionada para diferenciar o identificador do palavra-chave. Dois exemplos de implementação estão precedendo o value com "@" ou entre colchetes com value "[" e "]".

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.