CodeDomProvider.IsValidIdentifier(String) Metoda

Definicja

Zwraca wartość wskazującą, czy określona wartość jest prawidłowym identyfikatorem bieżącego języka.Returns a value that indicates whether the specified value is a valid identifier for the current language.

public:
 virtual bool IsValidIdentifier(System::String ^ value);
public virtual bool IsValidIdentifier (string value);
abstract member IsValidIdentifier : string -> bool
override this.IsValidIdentifier : string -> bool
Public Overridable Function IsValidIdentifier (value As String) As Boolean

Parametry

value
String

Wartość do zweryfikowania jako prawidłowy identyfikator.The value to verify as a valid identifier.

Zwraca

Boolean

true Jeśli value parametr jest prawidłowym identyfikatorem; w przeciwnym razie, false .true if the value parameter is a valid identifier; otherwise, false.

Wyjątki

Żadna z tych metod ani CreateGenerator() Metoda nie została przesłonięta w klasie pochodnej.Neither this method nor the CreateGenerator() method is overridden in a derived class.

Uwagi

Ta metoda sprawdza, czy identyfikator jest prawidłowy.This method tests whether an identifier is valid. IsValidIdentifierMetoda jest specyficzna dla dostawcy.The IsValidIdentifier method is provider specific. Identyfikatory, które są prawidłowe dla jednego dostawcy mogą być nieprawidłowe dla innych dostawców.Identifiers that are valid for one provider might not be valid for other providers. Jeśli value zawiera znaki spoza zakresu znaków ASCII, należy sprawdzić identyfikator dla wszystkich języków, które mogą być używane do kompilowania kodu.If value contains characters outside of the ASCII character range, check the identifier for all the languages that might be used to compile the code.

Uwaga

W .NET Framework wersje 1,0 i 1,1 Ta metoda jest zapewniana przez ICodeGenerator implementację, która jest zwracana przez CreateGenerator metodę dostawcy.In the .NET Framework versions 1.0 and 1.1, this method is provided by the ICodeGenerator implementation that is returned by the CreateGenerator method of the provider. W wersji 2,0 tę metodę można wywołać bezpośrednio dla dostawcy kodu, nawet jeśli nie został on zastąpiony przez dostawcę kodu.In version 2.0, this method can be called directly on the code provider even if it is not overridden by the code provider. Jeśli dostawca kodu nie przesłania tej metody, ICodeGenerator implementacja jest wywoływana przez klasę bazową.If the code provider does not override this method, the ICodeGenerator implementation is called by the base class.

Uwagi dotyczące dziedziczenia

Podczas zastępowania IsValidIdentifier(String) w klasie pochodnej należy zaprojektować metodę, aby zwracała true tylko wtedy, gdy wartość jest zgodna z regułami języka i nie powoduje konfliktu ze słowem kluczowym.When overriding IsValidIdentifier(String) in a derived class, design the method to return true only if the value fits the rules of the language and does not conflict with a keyword.

W przypadku zastąpienia tej metody nie należy wywoływać odpowiedniej metody klasy bazowej.If you override this method, you must not call the corresponding method of the base class. Metoda klasy bazowej tworzy generator w klasie pochodnej przy użyciu przestarzałej CreateGenerator() metody w celu zapewnienia zgodności z istniejącymi dostawcami, którzy używają generatorów kodu.The base-class method creates a generator in the derived class using the obsolete CreateGenerator() method for compatibility with preexisting providers that use code generators. Metoda klasy bazowej następnie wywołuje równoważną metodę w ICodeGenerator implementacji, aby wykonać tę funkcję.The base-class method then calls the equivalent method in the ICodeGenerator implementation to perform this function. Otrzymasz NotImplementedException wywołanie metody klasy bazowej od dostawcy kodu, który nie używa generatora kodu.You will get a NotImplementedException if you call the base-class method from a code provider that does not use a code generator.

Dotyczy