PropertySchema 元素(字段类型)
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
本文内容
属性
子元素
父元素
重要信息 |
---|
本主题介绍用于呈现自定义字段类型属性的已过时方法中使用的标记。提供该方法的目的只是为了帮助调试针对早期版本的 SharePoint Foundation 开发的自定义字段类型属性。有关推荐的方法的信息,请参阅自定义字段类型属性呈现。 |
表示自定义字段类型的特定可变属性的架构,其中每个属性均被定义为 Field 元素。
<PropertySchema>
</PropertySchema>
属性
属性 |
说明 |
---|---|
None |
子元素
父元素
备注
自定义字段类型可能具有特殊属性,其值将有所不同,从基于字段类型的一栏到基于同一字段类型的另一栏。考虑旨在承载与特定正则表达式相匹配的 String 值的自定义正则表达式字段类型,如 ^(\d{3})\d{3}-\d{4}$ 表示美国电话号码。与为英国执照牌号、美国身份证号、中国电话号码等创建单独的自定义表达式字段类型相比,以下方法更有效:创建单个正则表达式字段类型,并使基于该字段类型创建栏的用户设置需要根据逐栏匹配的正则表达式。例如,创建"美国电话号码"栏的用户会将该栏的正则表达式设置为上述字符串。另一创建"巴西邮箱"栏的用户会将其栏的正则表达式设置为 ^\d{5}\-\d{3}$。
为此,创建新栏时,自定义字段需要有一个 RegularExpression 属性,该属性呈现在用户界面 (UI) 上的可编辑控件中。在 SharePoint Foundation 中,该属性位于"新建网站栏"页和"创建栏"页上的"其他栏设置"部分中。这些可变属性是在 fldtypes*.xml 文件中的 PropertySchema 元素中声明的,并为它们提供一个默认的呈现架构。此外,还可以为它们赋予默认值。
备注
如果您在 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>