StronglyTypedResourceBuilder.VerifyResourceName Метод

Определение

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

System.Resources.Tools

Сборка:

System.Windows.Forms.Design.dll

Создает допустимую строку ресурса на основе указанной входной строки и поставщика кода.

public:
 static System::String ^ VerifyResourceName(System::String ^ key, System::CodeDom::Compiler::CodeDomProvider ^ provider);

public static string VerifyResourceName (string key, System.CodeDom.Compiler.CodeDomProvider provider);

static member VerifyResourceName : string * System.CodeDom.Compiler.CodeDomProvider -> string

Public Shared Function VerifyResourceName (key As String, provider As CodeDomProvider) As String

Параметры

key

String

Строка для проверки и, если это необходимо, преобразования в допустимое имя ресурса.

provider

CodeDomProvider

Объект CodeDomProvider, указывающий используемый целевой язык.

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

String

Допустимое имя ресурса, производное от параметра key. Любые недопустимые токены заменяются на символ подчеркивания (_) или null, если в полученной строке остаются недопустимые символы согласно языку, заданному в параметре provider.

Исключения

ArgumentNullException

Параметр key или provider имеет значение null.

Комментарии

key Если параметр является допустимой строкой символов, возвращается эта строка. key Если параметр является недопустимой строкой или строкой, содержащей недопустимые символы, VerifyResourceName метод пытается создать допустимую строку на key основе параметров и provider . Если можно создать допустимую строку, возвращается эта строка; null в противном случае возвращается значение .

key Если параметр является пустой строкой (""), возвращается строка, состоящая из одного символа подчеркивания (_). key Если параметр не является пустой строкой, метод сравнивает каждый символ строки с набором недопустимых маркеров на основе языка, VerifyResourceName заданного параметром provider . Любой недопустимый символ в строке заменяется символом подчеркивания. Символы, которые будут заменены символами подчеркивания:

' (пробел), U+00A0 (неразрывное пространство), '.' (точка), "," (запятая), ";" (точка с запятой), '|', "~", "@", "#", "%", "^", "&", "*", "+", "-", "/", "\", "", "<>", "?", "[", "]", "(", ")", "{", "}", "" (цитата), """ (апостроф), ":" и "!".

Примечание

Строго типизированные ресурсы не позволяют использовать ключевые слова языка (например if, , forи т. д.) в качестве имен ключей ресурсов. Однако шаблон конструктора System.CodeDom позволяет использовать ключевые слова языка путем создания префикса ключевое слово символом подчеркивания. Метод VerifyResourceName вызывает метод для принудительного CreateValidIdentifier применения этой структуры. Например, если вы используете имя ресурса, совпадающее с именем языка ключевое слово, например for, имя отображается как _for в созданном строго типизированном классе ресурсов.