Field 要素 (Field)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
サイト列を定義します。
定義
<Field
Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
AllowDeletion="TRUE" | "FALSE"
AllowDuplicateValues="TRUE" | "FALSE"
AllowHyperlink="TRUE" | "FALSE"
AllowMultiVote="TRUE" | "FALSE"
AppendOnly="TRUE" | "FALSE"
AuthoringInfo="Text"
BaseType="Integer" | "Text"
CalType="Integer"
CanToggleHidden="TRUE" | "FALSE"
ClassInfo="Text"
ColName="Text"
Commas="TRUE" | "FALSE"
Customization=Text
Decimals="Integer"
DefaultListField="TRUE" | "FALSE"
Description="Text"
Dir="Text"
DisplaceOnUpgrade="TRUE" | "FALSE"
DisplayImage="Text"
DisplayName="Text"
DisplayNameSrcField="Text"
DisplaySize=Integer
Div="Number"
EnableLookup="TRUE" | "FALSE"
ExceptionImage="Text"
FieldRef="Text"
FillInChoice="TRUE" | "FALSE"
Filterable="TRUE" | "FALSE"
FilterableNoRecurrence="TRUE" | "FALSE"
ForcedDisplay="Text"
Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
FromBaseType="TRUE" | "FALSE"
Group="Text"
HeaderImage="Text"
Height="Integer"
Hidden="TRUE" | "FALSE"
HTMLEncode="TRUE" | "FALSE"
ID="Text"
IMEMode="active | inactive"
Indexed="TRUE" | "FALSE"
IsolateStyles="TRUE" | "FALSE"
IsRelationship="TRUE" | "FALSE"
JoinColName="Text"
JoinRowOrdinal="Integer"
JoinType="INNER" | "LEFT OUTER" | "RIGHT OUTER"
LCID="Integer"
LinkToItem="TRUE" | "FALSE"
List="Text"
Max="Number"
MaxLength="Integer"
Min="Number"
Mult="TRUE" | "FALSE"
Name="Text"
NegativeFormat="MinusSign" | "Parens"
Node="Text"
NoEditFormBreak="TRUE" | "FALSE"
NumLines="Integer"
Overwrite="TRUE" | "FALSE"
OverwriteInChildScopes="TRUE" | "FALSE"
Percentage="TRUE" | "FALSE"
PIAttribute="Text"
PITarget="Text"
PrependId="TRUE" | "FALSE"
Presence="TRUE" | "FALSE"
PrimaryKey="TRUE" | "FALSE"
PrimaryPIAttribute="Text"
PrimaryPITarget="Text"
ReadOnly="TRUE" | "FALSE"
ReadOnlyEnforced="TRUE" | "FALSE"
RelationshipDeleteBehavior="Restrict | Cascade | None"
RenderXMLUsingPattern="TRUE" | "FALSE"
Required="TRUE" | "FALSE"
RestrictedMode="TRUE" | "FALSE"
ResultType="Text"
RichText="TRUE" | "FALSE"
RichTextMode="Text"
RowOrdinal="Integer"
Sealed="TRUE" | "FALSE"
SeperateLine="TRUE" | "FALSE"
SetAs="Text"
ShowAddressBookButton="TRUE" | "FALSE"
ShowField="Text" | "Choice" | "Counter"
ShowInDisplayForm="TRUE" | "FALSE"
ShowInEditForm="TRUE" | "FALSE"
ShowInFileDlg="TRUE" | "FALSE"
ShowInListSettings="TRUE" | "FALSE"
ShowInNewForm="TRUE" | "FALSE"
ShowInVersionHistory="TRUE" | "FALSE"
ShowInViewForms="TRUE" | "FALSE"
Sortable="TRUE" | "FALSE"
SourceID="Text"
StaticName="Text"
StorageTZ="UTC" | "Abstract"
StripWS="TRUE" | "FALSE"
SuppressNameDisplay="TRUE" | "FALSE"
TextOnly="TRUE" | "FALSE"
Title="Text"
Type="Data_Type"
UniqueId="Text"
UnlimitedLengthInDocumentLibrary="TRUE" | "FALSE"
URLEncode="TRUE" | "FALSE"
URLEncodeAsUrl="TRUE" | "FALSE"
UserSelectionMode="Text"
UserSelectionScope="Integer"
Viewable="TRUE" | "FALSE"
Width="Integer"
WikiLinking="TRUE" | "FALSE"
XName="Text">
</Field>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| 集計 | オプションの Text。 XPath 式によって返される値または要素のコレクションに適用する関数を指定するために、XML フォームの集計フィールドで使用されます。 Node 属性を使用して、値のコレクションを返す XPath 式を指定する場合は、返された値セットに対するアクションを指定する Aggregation 属性も含めることができます。 このアクションには、集計関数またはコレクション内の特定の要素の表示を指定できます。 以下のいずれかの値を使用できます。
XML ドキュメントでのプロパティの昇格と降格に Node、PIAttribute、PITarget、PrimaryPIAttribute、PrimaryPITarget の各属性を使用する方法の詳細については、「コンテンツ タイプを使用して XML ドキュメントのプロパティを指定する」を参照してください。 |
| AllowDeletion | 省略可能 なブール値。 フィールドを削除できる場合は TRUE。 |
| AllowDuplicateValues | 省略可能 なブール値。 指定したリスト フィールドで値の重複を許可するかどうかを指定します。 この値を false に設定すると、重複した値を入力できなくなり、このフィールドを主キーのように効果的に動作させることができます。 フィールドで重複した値が許可されている場合は True、それ以外の場合は false です。 既定値は true です。 |
| AllowHyperlink | 省略可能 なブール値。 フィールド内でハイパーリンクを使用できる場合は TRUE。 |
| AllowMultiVote | 省略可能 なブール値。 アンケートで複数の回答を許可する場合は TRUE。 |
| AppendOnly | 省略可能 なブール値。 リストでバージョン管理が有効になっているときに、Note フィールドの既存のテキストにテキストを追加できるだけである場合は TRUE。 |
| AuthoringInfo | オプションの Text。 フィールドとその目的を識別するためにフィールド編集ページに表示される説明文字列。たとえば、 LinkTitle フィールドには作成情報 "(項目へのリンク)" があります。 この属性は、通常、同じ名前のフィールドが別の目的で存在する場合に使用されます。 |
| Basetype | オプション。 BaseType 属性を Integer に設定すると値は整数として保存され、Text (既定) に設定すると値はテキストとして保存されます。 基本データ型が整数型の選択フィールドは作成できません。 |
| CalType | オプションの Integer。 カレンダーの種類を指定します。 指定できる値は次のとおりです。
|
| CanToggleHidden | 省略可能 なブール値。 フィールドをユーザー インターフェイスで非表示にすることができる場合は TRUE。 |
| ClassInfo | オプションの Text。 標準のテーブル ビューのフィールドで使用するカスケード スタイル シート (CSS) クラスを指定します。 設定した場合、標準の ms-vb2 クラスの代わりに指定したクラスが使用されます。 |
| ColName | オプションの Text。 フィールドとこのフィールドの物理ストレージ名のマッピングを定義する内部属性。 この属性は基になるデータベース内の有効な名前である必要があり、データベース テーブルで使用されている名前と同じである必要があります。 指定しなかった場合、サーバーは、既存の列名と競合せず、Microsoft SQL Server で許容される文字のみを含む列名を生成します。 |
| コンマ (,) | 省略可能 なブール値。 カンマが千の位の区切りとして使用される場合は TRUE。 |
| カスタマイズ | オプションの Text。 カスタム プロパティをユーザー設定フィールド型に追加できるようにします。 |
| 小数 | オプションの Integer。 表示する小数点以下の桁数を指定します。 表示される値は、表示精度に切り上げられます。たとえば、小数点以下 1 桁に丸めると、1.05 は 1.1 として表示されます。 |
| DefaultListField | 省略可能 なブール値。 ファイルがドキュメント ライブラリにアップロードされるときに、そのファイルに対して [プロパティの編集] フォームを表示するかどうかを指定する値を取得します。 ライブラリに追加するフィールドに [プロパティの編集] フォームが表示されていない場合は True、それ以外の場合は false です。 既定値は false です。 |
| 説明 | オプションの Text。 フィールドの説明が指定されている場合に、リストの編集フォームに表示される説明を提供します。 既定では、Microsoft SharePoint Foundation のフィールドには説明がありません。 |
| Dir | オプションの Text。 双方向読み取り順序をサポートするフィードについてテキストの方向を指定します。 LTR (左から右)、RTL (右から左)、none のどちらかの値を使用できます。 |
| DisplaceOnUpgrade | 省略可能 なブール値。 フィールドのフィールド定義が既に存在する場合、そのフィールド定義で指定されている値でフィールドのプロパティを強制的に更新するには、TRUE に設定します。 |
| DisplayImage | オプションの Text。 列に表示されるアイコンの名前を指定します。 |
| DisplayName | オプションの Text。 フィールドの表示名です。 スペースの使用に制限はありません。 最大文字数は 255 文字です。 値は、$Resources:String の形式でリソースへの参照にすることができます。 詳細については、「 SharePoint ソリューションのローカライズ」を参照してください。 表示名は、ユーザーが編集でき、最初にフィールドを作成した後に変更できます。 フィールドがテーブル ビューに表示される場合には、この名前は列見出しとして使用され、フィールドがフォームに表示される場合には、フォーム ラベルとして使用されます。 |
| DisplayNameSrcField | オプションの Text。 一般的に、別のフィールドと同じ名前である必要がある計算フィールドで使用されます。 ソース フィールドが変更され、表示名がユーザーによって変更された場合、このフィールドの表示名も変更されます。 この文字列は、他のフィールドの名前を参照します。 |
| DisplaySize | オプションの Integer。 |
| 部 | オプションの Number。 数値を表示する前に除算で使用される倍率。 表示数値は N * Mult / Div です (Decimals で指定された桁数に切り上げられます)。 |
| EnableLookup | 省略可能 なブール値。 フィールドで参照値を有効にする場合は TRUE。 |
| ExceptionImage | オプションの Text。 例外に使用するイメージ ファイルの名前を指定するために、Recurrence フィールド型で使用されます。 |
| Fieldref | オプションの Text。 セカンダリ ルックアップ フィールドでは、依存するプライマリ ルックアップ フィールドの ID を指定します。 値は、中かっこなしで、GUID の文字列表記にする必要があります。 |
| FillInChoice | 省略可能 なブール値。 フィールドでユーザーが列の値を入力することが許可されている場合は TRUE。 |
| フィルター処理可能 | 省略可能 なブール値。 フィールドをフィルタ処理できる場合は TRUE。 |
| FilterableNoRecurrence | 省略可能 なブール値。 定期的なイベントを展開しないビューでフィールドに対してフィルタを作成できる場合は TRUE。 Filterable が TRUE である場合は、FilterableNoRecurrence の設定に関係なく、すべてのビューでフィールドをフィルタ処理することができます。 |
| ForcedDisplay | オプションの Text。 実際のフィールド値の代わりに表示するテキストを指定します。 この属性は、アンケートでユーザー名が表示されることを防止するために使用されます。 |
| Format | オプションの Text。 数値について使用する表示形式を指定します。 日付/時刻フィールドの場合は、以下の値を指定できます。
[選択肢] フィールドの場合、この属性は ドロップダウン (既定値) に設定できます。ドロップダウン選択を使用して編集オプションを提供するか、ラジオ ボタンのグループを使用してオプションを提供する RadioButtons に設定できます。 URL フィールドの場合、この属性は ハイパーリンク (既定値) に設定できます。URL は通常 |
| FromBaseType | 省略可能 なブール値。 この属性は、 Sealed 属性を優先して非推奨になっています。 |
| グループ | オプションの Text。 フィールドが属する列グループを指定します。 |
| HeaderImage | オプションの Text。 フィールドのヘッダーとして使用する画像ファイルの名前を指定します。 |
| Height | オプションの Integer。 ユーザー情報リストのユーザー用に表示されるイメージの高さをピクセル単位で指定します。 |
| Hidden | 省略可能 なブール値。 TRUE の場合、フィールドはユーザー インターフェイスにまったく表示されません。 ReadOnly を TRUE に設定した場合は、フィールドは新規作成フォームや編集フォームに表示されませんが、ビューには含めることができます。 |
| Htmlencode | 省略可能 なブール値。 埋 め込まれた文字をブラウザーにテキストとして表示するように変換する場合は TRUE。HTML タグと混同される可能性のある文字は、エンティティに変換されます。 |
| ID | 必須の Text。 フィールドを一意に識別します。 値は、中かっこ ({}) に含まれる GUID の文字列表現である必要があります。 |
| IMEMode | オプションの Text。 フィールドに対して使用する入力システム (IME) のモード バイアスを指定します。 IME を使用すると、ある文章入力システムで使用する文字数が特定のキーボードでエンコードできる文字数よりも多い場合に、言語に応じてキーストロークを変換することができます。 以下のいずれかの値を使用できます。
|
| Indexed | 省略可能 なブール値。 ビューのフィルターで使用するために列にインデックスを付ける場合は TRUE。 注: パフォーマンスを向上させるためにルックアップ列にインデックスを付けることができますが、インデックス付きルックアップ列を使用してリスト ビューのしきい値を超えないようにすることはできません。 リスト ビューのしきい値を超えないようにするためには、プライマリまたはセカンダリ インデックスとして別の種類の列を使用します。 |
| IsolateStyles | 省略可能 なブール値。 RichText 属性が TRUE であり、RichTextMode 属性が FullHtml である Text フィールドの場合、この属性は、フィールドが含まれているページのレンダリングの妨げとならないように、サーバーがフィールドの HTML を書き換えることを指定します。 |
| IsRelationship | 省略可能 なブール値。 このフィールドが別のリストから GetRelatedFields() メソッドによって返される場合は TRUE。 |
| JoinColName | オプションの Text。 この属性は、参照フィールドについてのみ定義されます。 ColName によく似ていますが、この属性は、ローカル リストと外部リストとの SQL JOIN で使用される列の名前を示す点が異なります。 通常、この値をカスタマイズしないでください。 現在は、特定の組み込みおよび基本データ型フィールドのフィールド スキーマで、UrlID 列に結合される URLs (DocMd) テーブルへの参照を示すためにのみ使用されます。 |
| JoinRowOrdinal | オプションの Integer。 コードから直接使用することは想定されていません。 |
| JoinType | オプションの Text。 フィールドに対して使用される JOIN の種類を指定します。 可能な値には、 INNER、 LEFTOUTER、 RIGHTOUTER などがあります。 |
| LCID | オプションの Integer。 LCID 属性を使用して、通貨形式が使用されている国/地域 (たとえば、米国の場合は 1033 など) を指定できます。 ユーロ記号の形式には 2 つの特殊なケースがあります。 LCID = -1 (0xFFFFFFF) の場合、ユーロ記号は数値のプレフィックスとして追加されます。 LCID = -2 (0xFFFFFFE) の場合、ユーロ記号は数値のサフィックスとして追加されます。 小数点以下の桁数は 2 ですが、これはフィールドの Decimals 属性によって無効にされます。 ユーロ通貨記号は UCS-2 では 0x20AC です。 |
| List | オプションの Text。 ルックアップ フィールドのターゲットであるリストを識別するために使用します (Type="Lookup")。 ターゲット リストが既に存在する場合、List 属性の値は、ターゲット リストを識別する GUID (中かっこを含む) の文字列表記にする必要があります。 ターゲットが、フィールドが属するリストと同じである場合は、"Self" を指定できます。 ターゲット リストがまだ存在しない場合、List 属性の値は " Lists /My List" などの Web 相対 URL にすることができますが、ターゲット リストがルックアップ フィールドを作成する機能と同じ機能で作成されている場合にのみ使用できます。 この場合、Field 要素の List 属性の値は、ターゲット リストを作成する ListInstance 要素の Url 属性の値と同じである必要があります。 |
| Max | オプションの Number。 フィールドで許容される最大値を指定します。 |
| MaxLength | オプションの Integer。 フィールド値で許可されている、最大文字数を指定します。 この値はクライアント側で検証され、編集フォームはこの値に合わせて調整されます。 ユーザーが MaxLength で設定された文字数を超えて入力しようとすると、エラー メッセージが表示されます。 |
| Min | オプションの Number。 フィールドで許容される最小値を指定します。 |
| Mult | 省略可能 なブール値。 ルックアップ フィールドに複数の値を含める場合は TRUE です。 既定値は FALSE です。 |
| 名前 | 必須の Text。 このフィールドの内部名。 名前は、リストまたは Web サイト内の一連のフィールドに関して一意である必要があります。 SharePoint Foundation は、その一意性を保証するために必要に応じて値を修正します。それ以外の場合、フィールド定義の有効期間中は変更されません。 |
| NegativeFormat | オプションの Text。 負の値を示す方法を指定します。 以下のいずれかの値に設定できます。
|
| ノード | オプションの Text。 XML フォームで使用された場合、この属性は処理命令 (PI) リンクを除くすべてのフィールドで必須であり、昇格されるノードの XPath 式を指定します。 |
| NoEditFormBreak | 省略可能 なブール値。 アイテム作成フォームやアイテム編集フォームのフィールド間に改行が追加されないようにする場合は TRUE。 リッチ テキスト フィールドなどの一部のフィールド型では既定で間隔が追加され、この属性によって余分な間隔を制御できます。 |
| NumLines | オプションの Integer。 編集中に TEXTAREA ブロックに行数を表示することを推奨します。 これはクライアント UI のヒントであり、編集できるテキストの行数に制限は適用されません。 |
| Overwrite | 省略可能 なブール値。 サイト (SPWeb) 上でアクティブ化された新しいフィールドのフィールド ID が既存のフィールドのフィールド ID と同じ場合に、新しいフィールドのフィールド定義で既存のフィールドのフィールド定義を上書きするかどうかを指定します。 新しいフィールドと同じフィールド ID を持つ既存のフィールドを、新しいフィールドで上書きする場合は True、それ以外の場合は false です。 既定値は false です。 注: 既存のフィールドが読み取り専用の場合、またはシールされている場合、この属性が true に設定されていても、アクティブ化されているフィールドによって上書きされることはありません。 |
| OverwriteInChildScopes | 省略可能 なブール値。 サイト コレクションでフィールドを準備中、指定したフィールド定義がそのサイト コレクションの子 Web に既に存在している場合に、そのフィールド定義を上書きするかどうかを示します。 フィールド定義を上書きする場合は True、それ以外の場合は false です。 既定値は false です。 |
| Percentage | 省略可能 なブール値。 値をパーセント値として表示する場合、つまり数値を 100 倍してパーセント記号 (%) を追加して表示する場合は TRUE。 |
| PIAttribute | オプションの Text。 PITarget 属性で指定されたドキュメント処理命令で列の値として使用する属性を指定します。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。 PIAttribute 属性を指定する場合、PITarget 属性も指定する必要があります。 NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties |
| PITarget | オプションの Text。 列の値をこのコンテンツ タイプのドキュメントに格納するドキュメント処理命令を指定します。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。 PIAttribute 属性を指定する場合、PITarget 属性も指定する必要があります。 NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties |
| PrependId | 省略可能 なブール値。 複数の値を持つことができるルックアップ フィールドで使用します。 TRUE を指定して、ターゲット アイテムのアイテム ID と、編集フォームと新しいアイテムのフォームのターゲット フィールドの値を表示します。 |
| プレゼンス | 省略可能 なブール値。 フィールドのユーザー情報が存在する場合は TRUE。 |
| PrimaryKey | 省略可能 なブール値。 フィールドがリストと別のリストとのリレーションシップの主キーである場合は TRUE。 |
| PrimaryPIAttribute | オプションの Text。 XML ドキュメントでのプロパティの昇格および降格のために使用されます。 PrimaryPITarget 属性で指定されたドキュメント処理命令で列の値として使用する代替属性を指定します。 PrimaryPIAttribute 属性を指定する場合、PrimaryPITarget 属性も指定する必要があります。 指定した場合、SharePoint Foundation では、 PITarget 属性と PIAttribute 属性で指定された値の前にこれらの値が使用されます。 NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties |
| PrimaryPITarget | オプションの Text。 列の値をこのコンテンツ タイプのドキュメントに格納する代替のドキュメント処理命令を指定します。 PrimaryPIAttribute 属性を指定する場合、PrimaryPITarget 属性も指定する必要があります。 指定した場合、SharePoint Foundation では、 PITarget 属性と PIAttribute 属性で指定された値の前にこれらの値が使用されます。 NodeNodePIAttributePIAttributePITargetPITargetPrimary PIAttributePrimary PIAttributePrimaryPITargetPrimaryPITargetコンテンツ タイプを使用して XML ドキュメントのプロパティを指定するUsing Content Types to Specify XML Document Properties |
| ReadOnly | 省略可能 なブール値。 TRUE の場合は、フィールドは新規作成フォームや編集フォームに表示されませんが、ビューには含めることができます。 さらに、ReadOnly を TRUE に設定すると、フィールドはサイト列とコンテンツ タイプを管理する [サイトの設定] ページで非表示になります。 Hidden 属性を TRUE に設定すると、フィールドは UI で完全に非表示になります。 この属性を含まない場合、SharePoint Foundation は、この属性が False に設定されているかのように列を扱 います。 |
| ReadOnlyEnforced | 省略可能 なブール値。 ユーザーはフィールドの値を一切変更できず、システムだけが値を変更できることを指定する場合は TRUE。 |
| RelationshipDeleteBehavior | オプションの Text。 参照フィールドの削除の制約を指定します。 詳細については、「 SPRelationshipDeleteBehavior 列挙型」を参照してください。 サイト列では、値に Cascade や Restrict を指定できません。 None (既定) を指定するか、属性を省略することができます。 None 以外の値を指定する場合は、さらに、Indexed 属性に TRUE を指定し、Mult 属性に FALSE を指定する必要があります。 |
| RenderXMLUsingPattern | 省略可能 なブール値。 表示形式を指定するために計算フィールドで使用されます。 TRUE の場合、値は、計算フィールドの基になる最初の非計算フィールドの参照の列値ではなく、計算フィールドの表示パターンに基づいてレンダリングされます。 たとえば、画像ライブラリで、画像サイズ列が幅 x 高さで表される場合、この属性が TRUE に設定されていない場合は、最初のフィールド参照である幅だけが表示されます。 TRUE に設定されている場合は、幅 x 高さの形式で表示されます。 |
| 必須 | 必須 のブール値。 TRUE の場合、フィールドに空の値を割り当ててはいけません。 フォーム投稿に空でないフィールド値が指定されていない場合は、標準の必須フィールド テキストまたは明示的に指定されたメッセージ (つまりタグを使用) <ErrorText> がエラー フォームに表示されます。 この検証はクライアントによってのみ処理されます (データベースでは、すべてのユーザー定義フィールドに対して 常に NULL が許可されます)。 |
| RestrictedMode | 省略可能 なブール値。 Note フィールドで拡張リッチ テキスト形式 (画像、表、ハイパーリンクなど) を使用できないようにし、書式設定されたテキストをこのフィールドに貼り付けることもできないようにする場合は TRUE。 |
| ResultType | オプションの Text。 フィールドから返される値のデータ型を指定します。 |
| RichText | 省略可能 なブール値。 フィールドがリッチ テキスト書式を表示する場合は TRUE。 |
| RichTextMode | オプションの Text。 RichTextMode 列挙型のオプションの 1 つ。 |
| RowOrdinal | オプションの Integer。 フィールドにデータベースの場所を指定します。 |
| 密封 | 省略可能 なブール値。 フィールドに対してこの属性を TRUE に 設定すると、フィールドは移動不可としてマークされます。 [ 列の変更] ページに [削除] ボタンはありません。 ユーザーはフィールドを削除できません。 |
| SeparateLine | 省略可能 なブール値。 フィールド (メモやコメントなど) を別の行にレンダリングするために内部的に使用されます。 この属性は、一般的に使用することを目的としていません。 |
| SetAs | コードから直接使用することは想定されていません。 |
| ShowAddressBookButton | コードから直接使用することは想定されていません。 |
| ShowField | オプションの Text。 Type 属性が "Lookup" の場合、ShowField 属性の値は、確認するターゲット フィールドの内部名を指定します。 値が指定されていない場合は、ターゲット リスト内のレコードの [タイトル] フィールドからハイパーリンク テキストが表示されます。 次のフィールドの種類は、ルックアップ フィールドのターゲットとして使用します: Counter、DateTime、Number、Text。 ルックアップが有効な場合、Computed フィールドの種類をターゲットにできます。 詳細については、SPFieldComputed クラスの EnableLookup プロパティを参照してください。 出力がテキストである場合、Calculated フィールドの種類をターゲットにできます。 詳細については、SPFieldCalculated** クラスの OutputType プロパティを参照してください。 |
| ShowInDisplayForm | 省略可能 なブール値。 フォームにアイテムを表示するためのフィールドを表示する場合は TRUE。 |
| ShowInEditForm | 省略可能 なブール値。 フォームにアイテムを編集するためのフィールドを表示する場合は TRUE。 |
| ShowInFileDlg | 省略可能 なブール値。 この属性は、ドキュメント ライブラリ スキーマ内のフィールドについてのみ有効です。 FALSE の場合、クライアント アプリケーションから保存するときに表示されるフォームを保存するためのプロパティ ダイアログ ボックスに、このフィールドは表示されません。 たとえば、Title フィールドは、ドキュメント ライブラリに保存されるドキュメント内で直接設定されるので、この属性があります。 |
| ShowInListSettings | 省略可能 なブール値。 リストの設定をカスタマイズするためのページに列を表示する場合は TRUE。 |
| ShowInNewForm | 省略可能 なブール値。 FALSE の場合、表示モードが New に設定されているときは、フィールドが Fields 列挙に表示されません。 この設定のフィールドは、リストの既定の [新しいアイテム] ページに表示されません。 この属性は、特に、ドキュメントをドキュメント ライブラリにアップロードするためのページでフィールドを非表示にするために使用されます。 |
| ShowInVersionHistory | 省略可能 なブール値。 リスト アイテムのバージョンを表示するためのページに列を表示する場合は TRUE。 |
| ShowInViewForms | 省略可能 なブール値。 リスト データの表示に使用されるページにフィールドを表示することを指定する場合は TRUE。 |
| 並べ替え可能か | 省略可能 なブール値。 フィールドの値を並べ替えることができる場合は TRUE。 |
| SourceID | オプションの Text。 ユーザー設定フィールドが作成されたリストの GUID など http://schemas.microsoft.com/sharepoint/v3 、フィールドを定義する名前空間が含まれます。 |
| StaticName | オプションの Text。 フィールド コレクション内で一意でない可能性がある、フィールドの内部名が含まれています。 しかし、一意になるように修正される可能性のある Name 属性とは異なり、StaticName 属性の値は、定義したとおりにフィールドに代入されます。 後でこの値をコードで使用して、 TryGetFieldByStaticName メソッドを呼び出してフィールドへの参照を取得できます。 |
| StorageTZ | 日付/時刻値の格納方法を指定します。 StorageTZ が UTC に設定されている場合、日付/時刻は協定世界時 (UTC) として処理されます。 日付/時刻の値が "抽象" 時刻を指すことを示す場合は、日付/時刻が、ローカル タイム ゾーンの変換またはストレージなしでユーザーによって入力されたデータベースに格納されることを意味します。 StorageTZ 属性は省略します。 |
| StripWS | 省略可能 なブール値。 フィールド値の先頭または末尾から空白が削除される場合は TRUE。 |
| SuppressNameDisplay | 省略可能 なブール値。 User フィールドにユーザーの名前を表示する場合は TRUE。 |
| TextOnly | 省略可能 なブール値。 TRUE の場合、フィールドには Text 値のみを格納できます。 |
| Title | オプションの Text。 ユーザー インターフェイスに表示されるフィールドのタイトルを格納します。 |
| Type | 必須の Text。 フィールドのデータ型 (Field 要素が ProjectedFields の子ではない場合)。 注: Microsoft SharePoint Foundation 2010のテクノロジ プレビュー リリースでは、Type 属性は異なる意味を持ち、ProjectedFields の子である場合は使用可能な値 ("Lookup") が 1 つだけです。 この Type の使用方法の詳細については、「ProjectedFields 要素 (ビュー)」を参照してください。 SharePoint Foundation には、既定で次のデータ型が含まれています。
|
| UniqueId | オプションの Text。 コードから直接使用することは想定されていません。 |
| UnlimitedLengthInDocumentLibrary | 省略可能 なブール値。 ドキュメント ライブラリ内でフィールド長を無制限にする場合は TRUE。 |
| URLEncode | 省略可能 なブール値。 空白 などの特殊文字を引用符で囲まれた UTF-8 形式 (文字 ë の場合は %c3%ab など) に変換する場合は TRUE。 |
| URLEncodeAsURL | 省略可能 なブール値。 URLEncode と似ていますが、TRUE を指定すると、エンコードされる文字列は URL のパス コンポーネントとして扱われ、スラッシュ ("/") はエンコードされません。 |
| UserSelectionMode | オプションの Text。 アイテム フォームのユーザー フィールドで、各ユーザーの名前だけを選択できるようにするか、各ユーザーとグループの両方の名前を選択できるようにするかを指定します。 以下のいずれかの値を使用できます。
|
| UserSelectionScope | オプションの Integer。 アイテム フォームのユーザー フィールドでユーザー名を選択する際の範囲を指定します。 値が 0 の場合、SharePoint グループに対する制限はありません。 値が 0 以上の場合、ユーザーの選択は、指定した値と同じ ID を持つ SharePoint グループのメンバーに制限されます。 |
| 表示 | 省略可能 なブール値。 既定のビューにフィールドを追加することを指定する場合は TRUE。 既定値は TRUE です。 |
| Width | オプションの Integer。 ユーザー情報リストのユーザー用に表示される画像の幅をピクセル単位で指定します。 |
| WikiLinking | 省略可能 なブール値。 TRUE を 指定すると、二重角かっこ ([[...]]) の形式で表示される Wiki リンクが HTML リンクに変換され、タグが <a> 使用されます。 |
| Xname | オプションの Text。 追加、削除、または変更されたフィールドを識別するために XML フォーム内部で使用されます。 この属性は、一般的に使用することを目的としていません。 |
子要素
親要素
注釈
重要
ユーザー設定フィールドを定義するときは、フィールドが Microsoft SharePoint Foundation で正しく表示されるように ID、Type、Name、DisplayName、および Group 属性を指定する必要があります。 Microsoft Visual Studio のステートメント入力候補は、実際には 5 つすべてが必要な場合に、これらの属性の最初の 3 つだけが必要であることを誤って示します。
例
次の例は、サイト内の列を 3 つ作成する機能の要素マニフェストを示しています。
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
<Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
Name="Amount"
DisplayName="Amount"
Type="Currency"
Decimals="2"
Min="0"
Required="FALSE"
Group="Financial Columns" />
<Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
Name="CostCenter"
DisplayName="Cost Center"
Type="Choice"
Required="FALSE"
Group="Financial Columns">
<CHOICES>
<CHOICE>Administration</CHOICE>
<CHOICE>Information</CHOICE>
<CHOICE>Facilities</CHOICE>
<CHOICE>Operations</CHOICE>
<CHOICE>Sales</CHOICE>
<CHOICE>Marketing</CHOICE>
</CHOICES>
</Field>
<Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
Name="DateOpened"
DisplayName="Date Opened"
Type="DateTime"
Format="DateOnly"
Required="FALSE"
Group="Financial Columns">
<Default>[today]</Default>
</Field>
</Elements>