通过

PropertySchema 元素 (字段类型)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

表示自定义字段类型的特定可变属性的架构，其中每个属性均被定义为 Field 元素。

<PropertySchema>
</PropertySchema>

重要

本主题介绍用于呈现自定义字段类型属性的已过时方法中使用的标记。 它仅用于帮助调试针对早期版本的 SharePoint Foundation 开发的自定义字段类型属性。 有关建议的方法的信息，请参阅 自定义字段类型属性呈现。

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

无

子元素

父元素

备注

自定义字段类型可能具有特殊属性，其值将有所不同，从基于字段类型的一栏到基于同一字段类型的另一栏。 请考虑一种自定义正则表达式字段类型，该字段类型旨在保存与特定正则表达式匹配的 String 值，例如 ^(\d{3})\d{3}-\d{4}$ 美国电话号码。

创建单个正则表达式字段类型并使基于字段类型创建列的用户能够设置需要逐列匹配的正则表达式字段类型，而不是为英国车牌号码、美国社会安全号码、中国电话号码等创建单独的自定义正则表达式字段类型。 例如，创建“美国电话号码”栏的用户会将该栏的正则表达式设置为上述字符串。 另一个创建“巴西邮政框”列的用户会将其列的正则表达式设置为 ^\d{5}\-\d{3}$。

为此，创建新栏时，自定义字段需要有一个 RegularExpression 属性，该属性呈现在用户界面 (UI) 上的可编辑控件中。 在 SharePoint Foundation 中，它位于“新建网站栏”页和“创建列”页上的“其他列设置”部分。 文件中的 fldtypes*.xmlPropertySchema 元素是声明此类变量属性并给定默认呈现架构的位置。 此外，还可以为它们赋予默认值。

注意

如果在 PropertySchema 元素中定义自定义字段类型的变量属性，SharePoint Foundation 将根据架构自动呈现这些属性。

示例

以下示例为名为 RegularExpressionMatch 的自定义字段类型定义属性架构。 该架构声明在栏创建者基于字段类型创建栏时可以使用的字段。 此字段旨在使栏创建者能够为每个基于 RegularExpressionMatch 字段类型的栏设置一个不同的 正则表达式。

DisplayName 和可编辑的文本字段将显示在“新建网站栏”页和“创建列”页上的“其他列设置”部分中。 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>

另请参阅