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 属性も含めることができます。 このアクションには、集計関数またはコレクション内の特定の要素の表示を指定できます。

以下のいずれかの値を使用できます。

  • sum: 値を追加します。
  • count: 値の数をカウントします。
  • average: 値の平均を見つけます。
  • min: 最小値を見つけます。
  • max: 最大値を見つけます。
  • merge: 値をマージします。
  • plaintext: ノードテキストコンテンツをプレーンテキストに変換します。
  • first: プロパティの昇格と降格をコレクション内の最初の要素に適用します。
  • last: プロパティの昇格と降格をコレクション内の最後の要素に適用します。

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。 カレンダーの種類を指定します。 指定できる値は次のとおりです。
  • 16:坂時代
  • 15: 中国の月
  • 14: 韓国と日本の月
  • 12: グレゴリオ暦フランス語
  • 11: グレゴリオ暦表記の英語
  • 10: グレゴリオ暦アラビア語
  • 9: グレゴリオ暦中東フランス語
  • 8: ヘブライ語 (月)
  • 7: タイ語
  • 6: ヒジュラ語 (アラビア月)
  • 5: 韓国の實雲時代
  • 4: 台湾時代
  • 3: 日本の天皇時代
  • 1: グレゴリオ暦
  • 0: 型が指定されていない
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。 数値について使用する表示形式を指定します。

日付/時刻フィールドの場合は、以下の値を指定できます。

  • DateOnly: 日付部分のみを表示 (および編集を許可) します (編集されたすべての値の時刻部分は午前 12:00 に設定されます)。
  • DateTime: 日付と時刻の両方を表示および編集します (既定値)。
  • ISO8601: 協定世界時 (UTC) 形式に変換された ISO8601 時刻形式の日付と時刻を表示します。YYYY-MM-DDTHH:MM:SSZ。 これは、2007 Microsoft Office システムのドキュメント プロパティと、 新規 フォームと 編集 フォームとサーバーの間の SharePoint Foundation で使用される標準のインターチェンジ形式に使用される形式です。
  • ISO8601Basic: YYYYMMDDTHHMMSSZ という省略形の 8601 日付/時刻形式を使用します。 これは、vCard/iCal で使用される形式です。

[選択肢] フィールドの場合、この属性は ドロップダウン (既定値) に設定できます。ドロップダウン選択を使用して編集オプションを提供するか、ラジオ ボタンのグループを使用してオプションを提供する RadioButtons に設定できます。

URL フィールドの場合、この属性は ハイパーリンク (既定値) に設定できます。URL は通常 <a> のタグとして表示されます。また、 URL は として <img src="url" alt="Description" />表示される Image に設定できます。
FromBaseType 省略可能 なブール値。 この属性は、 Sealed 属性を優先して非推奨になっています。
グループ オプションの Text。 フィールドが属する列グループを指定します。
HeaderImage オプションの Text。 フィールドのヘッダーとして使用する画像ファイルの名前を指定します。
Height オプションの Integer。 ユーザー情報リストのユーザー用に表示されるイメージの高さをピクセル単位で指定します。
Hidden 省略可能 なブール値。 TRUE の場合、フィールドはユーザー インターフェイスにまったく表示されません。 ReadOnly を TRUE に設定した場合は、フィールドは新規作成フォームや編集フォームに表示されませんが、ビューには含めることができます。
Htmlencode 省略可能 なブール値。 埋 め込まれた文字をブラウザーにテキストとして表示するように変換する場合は TRUE。HTML タグと混同される可能性のある文字は、エンティティに変換されます。
ID 必須の Text。 フィールドを一意に識別します。 値は、中かっこ ({}) に含まれる GUID の文字列表現である必要があります。
IMEMode オプションの Text。 フィールドに対して使用する入力システム (IME) のモード バイアスを指定します。 IME を使用すると、ある文章入力システムで使用する文字数が特定のキーボードでエンコードできる文字数よりも多い場合に、言語に応じてキーストロークを変換することができます。

以下のいずれかの値を使用できます。

  • auto: 使用されていません。 この IME モードを指定するには、IMEMode プロパティの値を空の文字列 ("") に設定します。
  • active: すべての文字は IME を介して入力されますが、ユーザーは IME を非アクティブ化できます。
  • 非アクティブ: ユーザーは 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。 負の値を示す方法を指定します。 以下のいずれかの値に設定できます。
  • MinusSign: プレフィックスとしてマイナス記号を使用します。
  • Parens: かっこで囲みます。
ノード オプションの 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 には、既定で次のデータ型が含まれています。

  • AllDayEvent: 終日イベントを指定します。 ビット SQL データ型に対応します。
  • 添付ファイル: 添付ファイルの URL を格納します。 ビット SQL データ型に対応します。
  • ブール値: TRUE/FALSE 値を格納するために使用されます (データベースに 0 または 1 として格納されます)。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 ビット SQL データ型に対応し、SPFieldBoolean クラスによって表されます。
  • 計算: 他の列に基づいて値が計算されるフィールドを指定します。 SQL_VARIANT SQL データ型に対応し、SPFieldCalculated** クラスによって表されます。
  • 選択肢: ユーザーは、フィールドにデータを入力するために使用できる値の事前設定されたセットを指定できます。 選択肢フィールドでは、BaseType 属性と Format 属性を使用できます。 BaseType 属性と Format 属性は、選択フィールドに使用できます。 選択オプションの値を指定すると、その値がフィールドの送信される選択値として使用されます。 値を指定しない場合は、その選択肢が選択肢のテキスト値として送信されます。 いずれの場合も、選択肢のテキスト値が UI に表示されます (ドロップダウン リストやラジオ ボタンのテキスト)。 編集用の UI に選択肢が表示される順序は、常に、CHOICES 要素内でアイテムを指定した順序です。 編集 UI に選択肢が表示される順序は、常に CHOICES 要素内で項目が指定される順序です。 MultiChoice 型を使用して、チェック ボックスを実装し、ユーザーが複数の値を選択できるようにする Choice フィールドを指定します。 nvarchar SQL データ型に対応し、SPFieldChoice クラスを表します。
  • 計算: 内容の別のフィールドに依存するフィールドを指定します。 たとえば、 LinkTitleNoMenu フィールドは、タイトル フィールドの値をハイパーリンクで囲みます。 SPFieldComputed クラスによって表されます。
  • ContentTypeId: コンテンツ タイプ ID が含まれます。 コンテンツ タイプ ID の形式の詳細については、「Content Type IDs」を参照してください。 varbinary SQL データ型に対応します。
  • カウンター: 一般に、内部 ID フィールドにのみ使用されます。 Counter 型は常に読み取り専用であり、フォーム ポストを通じて設定することはできません。 Counter 型は常に読み取り専用であり、フォーム投稿を使用して設定することはできません。 int int SQL データ型に対応します。
  • CrossProjectLink: SharePoint リスト内のイベントを会議ワークスペース サイトに接続するために使用されます。は、アイテムの会議ワークスペース サイトを作成するために [新規] フォームおよび [アイテムの編集] フォームで使用されるチェック ボックスのフィールドの種類を指します。 ビット SQL データ型に対応し、SPFieldCrossProjectLink クラスによって表されます。
  • 通貨: 通貨値の入力を許可します。 各通貨フィールドは、特定のロケールの通貨に関連付けられています。 特定のロケールの通貨を指定するには、LCID 属性を使用します。 LCID 属性を使用して、特定のロケールの通貨を示します。 Decimals、Max、Min の各属性は、通貨の種類に使用できます。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 FLOAT SQL データ型に対応し、SPFieldCurrency クラスによって表されます。
  • DateTime: 完全修飾日付または時刻の保存を許可します。 Format 属性を使用して日付の書式設定を指定し、StorageTZ 属性を使用して日付/時刻値の格納方法を決定します。 表示モードでは、日付の形式の順序は地域の設定から継承されます ("M/D/Y" または "D/M/Y")。 編集モード (または Default 要素の値の新規モード) では、日付と時刻はユニバーサル形式 M/D/Y hh:mm am/pm でレンダリングされます。 datetime datetime SQL データ型に対応し、SPFieldDateTime クラスを表します。
  • ファイル: ファイルが含まれています。 uniqueidentifier SQL データ型に対応します。
  • GridChoice: アンケートの評価スケールが含まれています。 ntext SQL データ型に対応し、SPFieldRatingScale クラスによって表されます。
  • Guid: グローバル一意識別子 (GUID) を許可します。 uniqueidentifier SQL データ型に対応します。
  • 整数: 正または負の整数値を使用できます。 コンマと NegativeFormat 属性は、整数の書式設定を指定するために使用されます。 int SQL データ型に対応します。
  • 参照: [選択 ] フィールドとよく似た動作をしますが、使用可能なオプションは、ハードコーディングされた値の選択ではなく、別のリストから取得される点が異なります。 List 属性と ShowField 属性は、ルックアップ フィールドに使用できます。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 int int SQL データ型に対応し、SPFieldLookup クラスによって表されます。
  • LookupMulti: 複数の値を含めることができる ルックアップ フィールド。 親型: 参照。
  • ModStat: コンテンツの承認状態が含まれます。 使用可能な値には、 承認済み (既定値)、 拒否済み、 保留中 (それぞれ 0、1、または 2 としてデータベースに格納) が含まれます。 int SQL データ型に対応します。
  • MultiChoice: チェック ボックスを実装し、ユーザーが複数の値を選択できるようにする [選択 ] フィールドを指定します。 ntext SQL データ型に対応し、SPFieldMultiChoice クラスによって表されます。
  • MultiColumn: 複数の値を含むフィールドをエミュレートする Note フィールド。 複数列のフィールド型の例については、「 ユーザー設定フィールド型の定義」を参照してください。 複数列フィールドの詳細については、「 カスタム マルチ列フィールド クラス」を参照してください。 親型: 注。
  • 注: ユーザーが複数行のテキストを入力できるようにします。 すべてのテキストは、HTML マークアップを含まない標準の ASCII 文字として定義されます。 HTML マークアップや URL のように見えるものはすべて、標準テキストに見えるように引用符で囲まれます (たとえば、Server.HTMLEncode)。 この形式を編集するためのコントロールは、単純な TEXTAREA ブロックです。 表示する行数を指定するには、NumLines 属性を使用します。 ntext ntext SQL データ型に対応し、SPFieldMultiLineText クラスによって表されます。
  • 数値: 浮動小数点数を入力できます。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 入力された数値は、小数点と桁区切りの現在のロケール設定に従って解析されます。 負の数値は、かっこで囲むか、負の記号を使用して示すことができます。 数値の書式設定を指定するには、 Number 属性と組み合わせて次の属性を使用できます。 Decimals、 Div、 Max、 Min、 Mult、 Percentage です。 FLOAT SQL データ型に対応し、SPFieldNumber クラスによって表されます。
  • PageSeparator: アンケート リストに改ページを挿入します。 SPFieldPageSeparator クラスによって表されます。
  • 繰り返し: イベント リスト内のアイテムの繰り返しパターンを編集および定義するために使用されます。 ビット SQL データ型に対応します。
  • テキスト: 編集ボックスに入力された 1 行のテキスト。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 nvarchar nvarchar SQL データ型に対応し、SPFieldText クラスによって表されます。
  • ThreadIndex: メッセージ交換スレッド内のメッセージの相対位置を示す ID を格納します。 varbinary SQL データ型に対応します。
  • スレッド: スレッド フィールド型は、 スレッド ディスカッションのようなビューの作成と表示で使用されます。 フォーム内の標準の編集可能フィールドとしても、ビュー内の通常の列としても表示されません。 (フォームの標準編集可能フィールドとして表示されることも、ビューの通常の列として表示されることもありません。スレッド フィールドに対して並べ替えが実行されると、親子関係のすべてのレコードの事前注文トラバーサルが返されます。 varchar varchar SQL データ型に対応します。
  • URL: フリーフォーム ハイパーリンクを作成するために使用します。 URL フィールドが [説明] として表示されます。 説明が指定されていない場合は、 URL として表示されます。 これは、リンク先が移動したときにリンクを修正することによって、サーバー上でローカルであるすべての URL を更新できるようにするためです。 URL フィールドを含むレコードが削除された場合、対応する参照先レコードも URL テーブルから削除されます。 このフィールドは、並べ替えおよびグループ化を行うことができます (並べ替えは、URL の内容ではなく、テキストの説明に従って定義されます。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 (並べ替えは、URL の内容ではなく、テキストの説明に従って定義されます。説明が指定されていない場合は、空白と同じように並べ替えられます)。 Type が URL の場合、 LinkType 属性を使用してリンクの種類を指定できます。 nvarchar SQL データ型に対応し、SPFieldUrl クラスによって表されます。
  • ユーザー: UserInfo データベース テーブルを参照する ルックアップ フィールド。 int SQL データ型に対応し、SPFieldUser クラスによって表されます。
  • UserMulti: 複数の値を含めることができる ユーザー フィールド。 親型: LookupMulti。
  • WorkflowEventType:SPWorkflowHistoryEventType 列挙で表されるワークフロー イベントの種類を指定します。 親型: 整数。
  • WorkflowStatus: SPWorkflowStatus 列挙で表されるワークフローの状態を指定します。 nvarchar SQL データ型に対応します。
UniqueId オプションの Text。 コードから直接使用することは想定されていません。
UnlimitedLengthInDocumentLibrary 省略可能 なブール値。 ドキュメント ライブラリ内でフィールド長を無制限にする場合は TRUE。
URLEncode 省略可能 なブール値。 空白 などの特殊文字を引用符で囲まれた UTF-8 形式 (文字 ë の場合は %c3%ab など) に変換する場合は TRUE。
URLEncodeAsURL 省略可能 なブール値。 URLEncode と似ていますが、TRUE を指定すると、エンコードされる文字列は URL のパス コンポーネントとして扱われ、スラッシュ ("/") はエンコードされません。
UserSelectionMode オプションの Text。 アイテム フォームのユーザー フィールドで、各ユーザーの名前だけを選択できるようにするか、各ユーザーとグループの両方の名前を選択できるようにするかを指定します。 以下のいずれかの値を使用できます。
  • 0: 個人の名前のみを選択できます。
  • 1: 個人とグループの両方の名前を選択できます。
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>

関連項目