Элемент PropertySchema (Field Types)

Статья
04/21/2015

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы

Важно!
В этом разделе описана разметка, которая использовалась в устаревшем методе отображения свойств настраиваемого типа поля. Эта разметка предназначена исключительно для отладки свойств настраиваемого типа поля, разработанных в предыдущих версиях SharePoint Foundation. Сведения о рекомендуемом методе см. в статье Отображение свойств настраиваемого типа поля.

В этом разделе описана разметка, которая использовалась в устаревшем методе отображения свойств настраиваемого типа поля. Эта разметка предназначена исключительно для отладки свойств настраиваемого типа поля, разработанных в предыдущих версиях SharePoint Foundation. Сведения о рекомендуемом методе см. в статье Отображение свойств настраиваемого типа поля.

Представляет схему отдельных свойств специальной переменной настраиваемого типа поля, все свойства которого определяются как элемент Field.

<PropertySchema>
</PropertySchema>

Атрибуты

Атрибут	Описание
Нет

Дочерние элементы

Элемент Fields (схема свойств типов поля)

Родительские элементы

Элемент FieldType (Field Types)

Примечания

Настраиваемые типы поля могут иметь специальные свойства, значения которых изменяются от одного столбца, основанного на типе поля, до другого столбца, основанного на том же типе поля. Допустим, что настраиваемый тип поля регулярного выражения разработан для хранения значений String, которые соответствуют определенному регулярному выражению, например ^(\d{3})\d{3}-\d{4}$ для американских телефонных номеров. Вместо того, чтобы создавать отдельные настраиваемые типы поля регулярного выражения для британских автомобильных номерных знаков, американских номеров социального страхования, китайских телефонных номеров и т.д., более эффективно создать один тип поля регулярного выражения и позволить пользователям, создающим столбцы на основе этого типа поля, задавать регулярное выражение способом "столбец за столбцом". Например, пользователь, создающий столбец "Американский телефонный номер", задает регулярное выражение столбца в предыдущей строке. Другой пользователь, создающий столбец "Бразильский почтовый ящик", задает регулярное выражение своего столбца в ^\d{5}\-\d{3}$.

Чтобы это сделать, настраиваемое поле должно иметь свойство RegularExpression, которое отображается в элементе управления пользовательского интерфейса, допускающем изменение, при создании нового столбца. В SharePoint Foundation он находится в разделе Дополнительные параметры столбца на странице Создать столбец узла и на странице Создать столбец. Элемент PropertySchema в файле fldtypes*.xml находится в месте объявления свойств такой переменной и задания схемы отображения по умолчанию. При необходимости свойствам также можно задать значения по умолчанию.

Примечание
Если свойства переменной настраиваемого типа поля определяются в элементе PropertySchema, то SharePoint Foundation автоматически отображает эти свойства на основании схемы.

Пример

В следующем примере определяется схема свойств для изменяемого типа поля с именем "RegularExpressionMatch." В схеме объявляется поле для использования при создании столбцов на основе типа поля. Поле предназначено для того, чтобы создатель столбца смог задавать различные регулярные выражения для каждого столбца, основанного на типе поля RegularExpressionMatch.

DisplayName и поле Text, допускающее изменение, находятся в разделе Дополнительные параметры столбца на странице Создать столбец узла и на странице Создать столбец. Атрибут MaxLength задает максимальную длину регулярного выражения в знаках, а атрибут DisplaySize задает размер поля, которое его содержит. Пользователи могут прокручивать поле для просмотра всего регулярного выражения, если его длина превышает DisplaySize.

В данном примере не задаются значения по умолчанию, но если разработчику типа поля известно, что в большинстве случаев поле будет использоваться для создания столбцов, содержащих американские телефонные номера, то он может задать в качестве значения по умолчанию <Default>^(\d{3})\d{3}-\d{4}$</Default>.

Примечание. Следующий пример кода был упрощен для ясности.

<FieldType>
  <Field Name="TypeName">RegularExpressionMatch</Field>
  …
  <PropertySchema>
    <Fields>
      <Field Name="RegularExpression" 
             DisplayName="Regular Expression To Match" 
             MaxLength="500" 
             DisplaySize="100" 
             Type="Text">
        <Default></Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

См. также

Концепции

Типы настраиваемых полей

Инструкции. Создание настраиваемого класса поля

Отображение свойств настраиваемого типа поля

Практическое руководство. Создание определения настраиваемого типа поля

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