CodeDomProvider.CreateValidIdentifier(String) Metoda

Definice

Obor názvů:

System.CodeDom.Compiler

Sestavení:

System.CodeDom.dll

Balíček:

System.CodeDom v11.0.0-preview.4.26230.115

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ý se má 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, zda 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. Vrácený identifikátor je obvykle pouze mírně změněn tak, aby odlišil identifikátor od klíčového slova; Například název může předcházet znak podtržítka ("_").

Note

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

Poznámky pro dědice

Pokud tuto metodu přepíšete, 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.