CodeDomProvider.CreateValidIdentifier(String) Metoda

Definicja

Przestrzeń nazw:

System.CodeDom.Compiler

Zestaw:

System.CodeDom.dll

Pakiet:

System.CodeDom v8.0.0

Źródło:

CodeDomProvider.cs

Tworzy prawidłowy identyfikator dla określonej wartości.

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

Ciąg, dla którego ma być wygenerowany prawidłowy identyfikator.

Zwraca

String

Prawidłowy identyfikator określonej wartości.

Wyjątki

NotImplementedException

Ani ta metoda, ani metoda nie CreateGenerator() są zastępowane w klasie pochodnej.

Uwagi

CreateValidIdentifier sprawdza, czy identyfikator powoduje konflikt z zastrzeżonymi słowami kluczowymi lub słowami kluczowymi języka, a jeśli tak, próbuje zwrócić prawidłową nazwę identyfikatora, która nie powoduje konfliktu. Zazwyczaj zwracany identyfikator jest tylko nieznacznie modyfikowany w celu odróżnienia identyfikatora od słowa kluczowego; na przykład nazwa może być poprzedzona znakiem podkreślenia ("_").

Uwaga

W .NET Framework wersji 1.0 i 1.1 ta metoda jest dostarczana przez ICodeGenerator implementację zwracaną przez CreateGenerator metodę dostawcy. W wersji 2.0 tę metodę można wywołać bezpośrednio u dostawcy kodu, nawet jeśli nie jest on zastępowany przez dostawcę kodu. Jeśli dostawca kodu nie zastąpi tej metody, implementacja ICodeGenerator jest wywoływana przez klasę bazową.

Uwagi dotyczące dziedziczenia

Jeśli zastąpisz tę metodę, nie można wywołać odpowiedniej metody klasy bazowej. Metoda klasy bazowej tworzy generator w klasie pochodnej przy użyciu przestarzałej CreateGenerator() metody w celu zachowania zgodności z wcześniej istniejących dostawców korzystających z generatorów kodu. Następnie metoda klasy bazowej wywołuje równoważną metodę w implementacji ICodeGenerator , aby wykonać tę funkcję. Jeśli wywołasz metodę klasy bazowej od dostawcy kodu, który nie używa generatora kodu, otrzymasz NotImplementedException metodę klasy bazowej.