CodeDomProvider.IsValidIdentifier(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, показывающее, является ли указанное значение допустимым идентификатором для текущего языка.
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
Значение для проверки на допустимый идентификатор.
Возвращаемое значение
true
, если параметр value
является допустимым идентификатором; в противном случае — false
.
Исключения
В производном классе нельзя переопределить ни этот метод, ни метод CreateGenerator().
Комментарии
Этот метод проверяет, является ли идентификатор допустимым. Метод IsValidIdentifier зависит от поставщика. Идентификаторы, допустимые для одного поставщика, могут быть недопустимыми для других поставщиков. Если value
содержит символы за пределами диапазона символов ASCII, проверка идентификатор для всех языков, которые могут использоваться для компиляции кода.
Примечание
В платформа .NET Framework версий 1.0 и 1.1 этот метод предоставляется реализациейICodeGenerator, возвращаемой CreateGenerator методом поставщика. В версии 2.0 этот метод можно вызывать непосредственно в поставщике кода, даже если он не переопределен поставщиком кода. Если поставщик кода не переопределяет этот метод, ICodeGenerator реализация вызывается базовым классом.
Примечания для тех, кто наследует этот метод
При переопределении IsValidIdentifier(String) в производном классе проектируйте метод так, чтобы возвращать true
его, только если значение соответствует правилам языка и не конфликтует с ключевое слово.
При переопределении этого метода не следует вызывать соответствующий метод базового класса. Метод базового класса создает генератор в производном классе, используя устаревший CreateGenerator() метод для обеспечения совместимости с уже существовающими поставщиками, которые используют генераторы кода. Затем метод базового класса вызывает эквивалентный метод в ICodeGenerator реализации для выполнения этой функции. Вы получите при NotImplementedException вызове метода базового класса из поставщика кода, который не использует генератор кода.