Обеспечение соответствия строкового поля шаблону

Статья
08/11/2011

Элемент MATCH позволяет принудительно обеспечить соответствие значения в поле строкового типа заданному шаблону. Если определить несколько элементов MATCH, значение будет допустимым, если оно соответствует любому из определенных для поля шаблонов. Если есть хотя бы одно успешное соответствие, тип поля считается допустимым.

Структура синтаксиса элемента MATCH

Элемент MATCH принудительно обеспечивает соответствие базовому шаблону; для этого необходимо определить шаблон, которому должны соответствовать значения в полях строкового типа.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Атрибуты

Можно указать пользователей, на которых распространяется действие правила MATCH. Если ни один необязательный атрибут не определен, все допустимые пользователи и группы Team Foundation Server должны указывать значение, соответствующее шаблону.

Атрибут	Описание
pattern	Обязательный. Следит за соответствием строк основным шаблонам. Допустимыми значениями атрибута patternValue являются "A", "N" и "X", которые обозначают следующие типы знаков: "A" соответствует алфавитному символу; "N" соответствует цифре; "X" соответствует любому алфавитно-цифровому символу. Все остальные считаются обычными буквами. Минимальная длина: 1; максимальная длина: 255. Значение шаблона: ^[^\\]*$ Пример значения шаблона: xxxxx. nn. nn
for	Необязательный. Задает имя пользователя или группы Team Foundation, к которым применяется данное правило. Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков. Значение шаблона: ^[^\\]+\\[^\\]+$ Пример значения шаблона: Domain\userID
not	Необязательный. Задает имя пользователя или группы Team Foundation, к которым данное правило не применяется. Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков. Значение шаблона: ^[^\\]+\\[^\\]+$ Пример значения шаблона: Domain\userID

pattern

Обязательный. Следит за соответствием строк основным шаблонам. Допустимыми значениями атрибута patternValue являются "A", "N" и "X", которые обозначают следующие типы знаков:

"A" соответствует алфавитному символу;
"N" соответствует цифре;
"X" соответствует любому алфавитно-цифровому символу.

Все остальные считаются обычными буквами. Минимальная длина: 1; максимальная длина: 255.

Значение шаблона: ^[^\\]*$

Пример значения шаблона: xxxxx. nn. nn

for

Необязательный. Задает имя пользователя или группы Team Foundation, к которым применяется данное правило. Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков.

Значение шаблона: ^[^\\]+\\[^\\]+$

Пример значения шаблона: Domain\userID

not

Необязательный. Задает имя пользователя или группы Team Foundation, к которым данное правило не применяется. Допустимые имена представляют собой текстовую строку длиной от 1 до 255 знаков.

Значение шаблона: ^[^\\]+\\[^\\]+$

Пример значения шаблона: Domain\userID

К началу

Примеры соответствия шаблону

В следующих примерах показаны успешные и неудачные соответствия шаблону, которые по-разному используются в полях.

Номер выпуска

Шаблон: ANN.NN.NN

Пройдут проверку	R01.03.04 или V05.08.99
Не пройдут проверку	1.3.4 или V5.8.99, или v1.3

Гибкий идентификатор

Шаблон: XXX-XXX

Пройдут проверку	001-abc или a00-b02
Не пройдут проверку	1-abc или 001.abc

Приоритет

Шаблон: PN

Пройдут проверку	P1 или P5 или P9
Не пройдут проверку	1 или P10

Шаблоны сравнения рассматриваются без учета регистра. Следовательно, "PN" соответствует и P1, и p1.

К началу

См. также

Другие ресурсы

Работа с правилами полей

Журнал изменений

Дата	Журнал	Причина
Январь 2011	Добавлен синтаксис элемента MATCH.	Улучшение информации.

Январь 2011

Добавлен синтаксис элемента MATCH.

Улучшение информации.

Поделиться через