CodeDomProvider.IsValidIdentifier(String) Метод

Определение

Пространство имен:

System.CodeDom.Compiler

Сборка:

System.CodeDom.dll

Пакет:

System.CodeDom v8.0.0

Исходный код:

CodeDomProvider.cs

Возвращает значение, показывающее, является ли указанное значение допустимым идентификатором для текущего языка.

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

Параметры

value

String

Значение для проверки на допустимый идентификатор.

Возвращаемое значение

Boolean

true, если параметр value является допустимым идентификатором; в противном случае — false.

Исключения

NotImplementedException

В производном классе нельзя переопределить ни этот метод, ни метод CreateGenerator().

Комментарии

Этот метод проверяет, является ли идентификатор допустимым. Метод IsValidIdentifier зависит от поставщика. Идентификаторы, допустимые для одного поставщика, могут быть недопустимыми для других поставщиков. Если value содержит символы за пределами диапазона символов ASCII, проверка идентификатор для всех языков, которые могут использоваться для компиляции кода.

Примечание

В платформа .NET Framework версий 1.0 и 1.1 этот метод предоставляется реализациейICodeGenerator, возвращаемой CreateGenerator методом поставщика. В версии 2.0 этот метод можно вызывать непосредственно в поставщике кода, даже если он не переопределен поставщиком кода. Если поставщик кода не переопределяет этот метод, ICodeGenerator реализация вызывается базовым классом.

Примечания для тех, кто наследует этот метод

При переопределении IsValidIdentifier(String) в производном классе проектируйте метод так, чтобы возвращать true его, только если значение соответствует правилам языка и не конфликтует с ключевое слово.

При переопределении этого метода не следует вызывать соответствующий метод базового класса. Метод базового класса создает генератор в производном классе, используя устаревший CreateGenerator() метод для обеспечения совместимости с уже существовающими поставщиками, которые используют генераторы кода. Затем метод базового класса вызывает эквивалентный метод в ICodeGenerator реализации для выполнения этой функции. Вы получите при NotImplementedException вызове метода базового класса из поставщика кода, который не использует генератор кода.