CodeDomProvider.CreateValidIdentifier(String) Metoda

Definice

Obor názvů:

System.CodeDom.Compiler

Sestavení:

System.CodeDom.dll

Balíček:

System.CodeDom v8.0.0

Zdroj:

CodeDomProvider.cs

Vytvoří platný identifikátor pro zadanou hodnotu.

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

Parametry

value

String

Řetězec, pro který chcete vygenerovat platný identifikátor.

Návraty

String

Platný identifikátor pro zadanou hodnotu.

Výjimky

NotImplementedException

Tato metoda ani CreateGenerator() metoda není přepsána v odvozené třídě.

Poznámky

CreateValidIdentifier testuje, jestli identifikátor koliduje s rezervovanými nebo jazykovými klíčovými slovy, a pokud ano, pokusí se vrátit platný název identifikátoru, který není v konfliktu. Obvykle je vrácený identifikátor pouze mírně změněn, aby se identifikátor od klíčového slova odlišil; Název může například předcházet podtržítko ("_").

Poznámka

V rozhraní .NET Framework verze 1.0 a 1.1 je tato metoda poskytována ICodeGenerator implementací, která je vrácena metodou CreateGenerator zprostředkovatele. Ve verzi 2.0 lze tuto metodu volat přímo na zprostředkovatele kódu, i když není přepsána zprostředkovatelem kódu. Pokud zprostředkovatel kódu nepřepíše tuto metodu ICodeGenerator , je implementace volána základní třídou.

Poznámky pro dědice

Pokud přepíšete tuto metodu, nesmíte volat odpovídající metodu základní třídy. Metoda základní třídy vytvoří generátor v odvozené třídě pomocí zastaralé CreateGenerator() metody pro kompatibilitu s existujícími zprostředkovateli, kteří používají generátory kódu. Metoda základní třídy pak volá ekvivalentní metodu v implementaci ICodeGenerator k provedení této funkce. Získáte, NotImplementedException pokud zavoláte metodu základní třídy od zprostředkovatele kódu, který nepoužívá generátor kódu.