Field 要素 (フィールド型)
フィールド型の特性を表します。
<Field
Name="Text">
</Field>
属性
属性 |
説明 |
|---|---|
Name |
必須の Text。Field 要素が表すフィールド型の、ある性質を表す名前文字列です。値は、下表に示されている文字列のいずれかである必要があります。 |
子要素
なし |
親要素
Remarks
FieldType 要素の子要素である Field 要素は、C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML 内の fldtypes*.xml ファイルに構成されます。
各 FieldType 要素には Field 要素がいくつかあり、必須のものと、必要に応じて指定すればよいものがあり、その Name 属性によって識別されます。この要素を以下に列挙します。Windows SharePoint Services 3.0 オブジェクト モデルでは、フィールド型は、SPFieldTypeDefinition クラスによって表されます。後者のクラスには、表のうち 2 行を除くすべてに対応する、読み取り専用のプロパティがあります。(例外は、InternalType と SQLType です。) 特に指定のない限り、プロパティ名は対応する Name 属性の値に一致します。
Field 要素の Name 属性の値 |
説明 |
|---|---|
AllowBaseTypeRendering |
オプションの Boolean。既定は FALSE です。ユーザー設定フィールド型をどのようにレンダリングするか、クライアント アプリケーションが判断できない場合に、基底型 ( ParentType とも呼ばれます) のフィールドとして表示するかどうかを表します。TRUE であり、クライアント アプリケーションがユーザー設定フィールド型を適切にレンダリングできない場合、Windows SharePoint Services に初めから組み込まれている、親 (継承元) フィールド型のフィールドとして表示するようになります。 |
FieldTypeClass |
オプションの String ですが、すべてのユーザー設定フィールド型で必要とされます。フィールド型クラス ライブラリの厳密な名前を表します。"FieldTypeClass" には、Version、Culture、および PublicKeyToken を持つクラス名とアセンブリ名が含まれます。たとえば、<Field Name="FieldTypeClass">CustomFieldTypes.RegularExpression.RegularExpressionField, CustomFieldTypes.RegularExpression, Version=1.0.0.0, Culture=neutral, PublicKeyToken=57e55365ec0ce80a</Field> になります。(完全修飾クラス名のみが、Windows SharePoint Services 3.0 に組み込まれているフィールド型に含まれます。) |
FieldEditorUserControl |
オプションの String。Windows SharePoint Services 3.0 での [サイト内の新しい列] ページの [列の追加設定] セクションに表示されるコントロールを定義する、field_type FieldEditor.ascx ファイルへの相対パスを表します。このコントロールにより、特定の列に対して、列クリエータはフィールド型の可変プロパティを設定できます。たとえば、"/_controltemplates/RegularExpressionFieldEditor.ascx" です。<Field Name="FieldEditorUserControl"> 要素がない場合、フィールド型の特別なプロパティが PropertySchema 要素 (フィールド型) 要素によってレンダリングされます。 FieldEditorUserControl は、ローカライズによっても値が変わらない、固定文字列である必要があります。 |
Filterable |
必須の Boolean。このフィールド型をベースとする列が含まれるリストが、この型を使用する列の値に従ってフィルタ処理できるかどうかを表します。TRUE であれば、列のヘッダーは、ユーザーがリストをフィルタ処理するのに使用できるコントロールになります。 |
InternalType |
オプションの String。内部の基底型を表します。ユーザー設定フィールド型の定義に <Field Name="InternalType"> 要素を使用しないでください。 |
ParentType |
必須の String (空の文字列にすることもできます)。フィールド クラスが派生する型の名前を表します。設定可能な値は、Field 要素 (リスト - 定義) 要素の Type 属性と完全に同じです。フィールド型が別の型からの派生ではない場合、値は空の文字列です。 <Field Name="ParentType"></Field>。ユーザー設定フィールド型では、空にしないでください。すべてのユーザー設定型が別の型から継承されます。 Windows SharePoint Services 3.0 オブジェクト モデルでは、ParentType は BaseRenderingTypeName と呼ばれます。 |
ShowOnListAuthoringPages |
オプションの Boolean。既定は TRUE です。このフィールド型をリストに追加できるよう、画面に表示するかどうかを表します。TRUE であれば、Windows SharePoint Services はこのフィールド型をリスト作成ページに表示して、ユーザーが自分で作ったリストに追加できるようにします。 Windows SharePoint Services 3.0 オブジェクト モデルでは、ShowOnListAuthoringPages は ShowOnListCreate と呼ばれます。 |
ShowOnDocumentLibraryAuthoringPages |
オプションの Boolean。既定は TRUE です。このフィールド型をドキュメント ライブラリに追加できるよう、画面に表示するかどうかを表します。TRUE であれば、Windows SharePoint Services はこのフィールド型をドキュメント ライブラリ作成ページに表示して、ユーザーが自分で作ったドキュメント ライブラリに追加できるようにします。 Windows SharePoint Services 3.0 オブジェクト モデルでは、ShowOnDocumentLibraryAuthoringPages は ShowOnDocumentLibraryCreate と呼ばれます。 |
ShowOnSurveyAuthoringPages |
オプションの Boolean。既定は TRUE です。このフィールド型をアンケートに追加できるよう、画面に表示するかどうかを表します。TRUE であれば、Windows SharePoint Services はこのフィールド型をアンケート作成ページに表示して、ユーザーが自分で作ったアンケートに追加できるようにします。 Windows SharePoint Services 3.0 オブジェクト モデルでは、ShowOnSurveyAuthoringPages は ShowOnSurveyCreate と呼ばれます。 |
ShowOnColumnTemplateAuthoringPages |
オプションの Boolean。既定は TRUE です。このフィールド型を、列テンプレート フィールド型として表示するかどうかを表します。TRUE であれば、Windows SharePoint Services はこのフィールド型を列テンプレート作成ページに表示して、ユーザーがこのフィールド型の列テンプレートを作成できるようにします。 Windows SharePoint Services 3.0 オブジェクト モデルでは、ShowOnColumnTemplateAuthoringPages は ShowOnColumnTemplateCreate と呼ばれます。 |
SQLType |
オプションの String。コンテンツ データベースにデータを格納するのに使用される SQL データ型を表します。ユーザー設定フィールド型の定義に <Field Name="SQLType"> 要素を使用しないでください。 |
Sortable |
必須の Boolean。このフィールド型をベースとする列が含まれるリストが、この型を使用する列で並べ替えることができるかどうかを表します。TRUE であれば、列のヘッダーは、ユーザーがリストを並べ替えするのに使用できるコントロールになります。 |
TypeDisplayName |
必須の String。画面表示 (UI) に使う、フィールド型の名前を表します。Windows SharePoint Services 3.0 では、[カスタマイズ] [リスト] ページ (listedit.aspx) の [種類] 列に表示されます。"TypeShortDescription" の代わりにも使用されます (後者が存在しない場合)。 "TypeDisplayName" はローカライズが可能な文字列でなければなりません。 |
TypeName |
必須の String。フィールド型の名前を表します。これは、SharePoint サーバー ファームのすべてのフィールド型の名前で一意である必要があります。 "TypeName" は、ローカライズによっても値が変わらない、固定文字列である必要があります。 |
TypeShortDescription |
オプションの String。UI に表示される、フィールド型の簡単な説明です。 Windows SharePoint Services 3.0 では、[サイト内の新しい列] ページおよび [列の作成] ページの [名前と種類 ] セクションと [サイト内の列ギャラリー] の [種類] 列のラジオ ボタンと共に表示されます。<Field Name="TypeShortDescription"> 要素が存在しない場合、"TypeDisplayName" を使用します。 "TypeShortDescription" はローカライズが可能な文字列でなければなりません。 |
UserCreatable |
オプションの Boolean。既定は TRUE であり、ユーザーがこのフィールド型のフィールドをリストに追加できます。値を FALSE に設定すると、リスト スキーマでフィールド型を使用できますが、[サイト内の新しい列] ページと [列の作成] ページの [名前と種類] セクションでは、ユーザーにはフィールド型が非表示になります。 |
例
ユーザー設定フィールド型を定義する例を示します。
<FieldType>
<Field Name="TypeName">SocialSecurityNumber</Field>
<Field Name="ParentType">Text</Field>
<Field Name="TypeDisplayName">Social Security Number</Field>
<Field Name="TypeShortDescription">Social Security Number (123456789, 123-45-6789)</Field>
<Field Name="AllowBaseTypeRendering">TRUE</Field>
<Field Name="FieldTypeClass">
AdventureWorks.FieldTypes.SPFieldSSN, AdventureWorks.FieldTypes.SPFieldSSN,
Version=1.0.0.0,Culture=neutral,PublicKeyToken=90734cc53324b79c
</Field>
<RenderPattern Name="DisplayPattern">
<Column HTMLEncode="TRUE" />
<Column HTMLEncode="TRUE" UseRelatedField="TRUE"/>
</RenderPattern>
</FieldType>