Field 要素 (リスト)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
SharePoint Web サイトのリスト インフラストラクチャで使用される内部データ型を定義します。 フィールドは、ユーザーがリストに追加できる列、つまり情報の属性です。
<Field
Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
AllowDeletion = "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" ColName2 = "Text"
Commas = "TRUE" | "FALSE"
Customization = "Text"
Decimals = "Integer"
Description = "Text"
Dir = "Text"
Direction = "Text"
DisplaceOnUpgrade = "TRUE" | "FALSE"
DisplayImage = "Text"
DisplayName = "Text"
DisplayNameSrcField = "Text"
DisplaySize = "Integer"
Div = "Number"
EnableLookup = "TRUE" | "FALSE"
EnforceUniqueValues = "TRUE" | "FALSE"
ExceptionImage = "Text"
FieldRef = "Text"
FillInChoice = "TRUE" | "FALSE"
Filterable = "TRUE" | "FALSE"
FilterableNoRecurrence = "TRUE" | "FALSE"
ForcedDisplay = "Text"
ForcePromoteDemote = "TRUE" | "FALSE"
Format = "Text"
FromBaseType = "TRUE" | "FALSE"
Group = "Text"
HeaderImage = "Text"
Height = "Integer"
Hidden = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
ID = "Text" Id = "Text"
IMEMode = "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"
LinkToItemAllowed = "Text"
List = "Text"
ListItemMenu = "TRUE" | "FALSE"
ListItemMenuAllowed = "Text"
Max = "Number"
MaxLength = "Integer"
Min = "Number"
Mult = "TRUE" | "FALSE"
Name = "Text"
NegativeFormat = "MinusSign" | "Parens"
Node = "Text"
NoEditFormBreak = "TRUE" | "FALSE"
NumLines = "Integer"
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 = "Text"
RenderXMLUsingPattern = "TRUE" | "FALSE"
Required = "TRUE" | "FALSE"
RestrictedMode = "TRUE" | "FALSE"
ResultType = "Text"
RichText = "TRUE" | "FALSE"
RichTextMode = "Text"
RowOrdinal = "Integer"
Sealed = "TRUE" | "FALSE"
SeparateLine = "TRUE" | "FALSE"
SetAs = "Text"
ShowAddressBookButton = "TRUE" | "FALSE"
ShowAlways = "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"
Version = "Text"
Viewable = "TRUE" | "FALSE"
WebId = "Text"
Width = "Integer"
WikiLinking = "TRUE" | "FALSE"
XName = "Text">
</Field>
要素と属性
次のセクションでは、属性、子要素、および親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| 集計 |
オプションの Text。 XPath 式によって返される値または要素のコレクションに適用する関数を指定するために、XML フォームの集計フィールドで使用されます。 Node 属性を使用して、値のコレクションを返す XPath 式を指定する場合は、返された値セットに対するアクションを指定する Aggregation 属性も含めることができます。 このアクションには、集計関数またはコレクション内の特定の要素の表示を指定できます。 以下のいずれかの値を使用できます。 - 合計 値を追加します。 - カウント 値の数をカウントします。 - 平均 値の平均を見つけます。 - 分 最小値を見つけます。 - 最大 最大値を見つけます。 - マージ 値をマージします。 - プレーン テキスト ノードテキストコンテンツをプレーンテキストに変換します。 - まずは プロパティの昇格と降格をコレクション内の最初の要素に適用します。 - 前の プロパティの昇格と降格をコレクション内の最後の要素に適用します。 Node、PIAttribute、PITarget、PrimaryPIAttribute、および PrimaryPITarget 属性を使用して、XML ドキュメントでプロパティを昇格および降格する方法の詳細については、「Using Content Types to Specify XML Document Properties」を参照してください。 |
| AllowDeletion |
省略可能 なブール値。 フィールドを削除できる場合は 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 で許容される文字のみを含む列名を生成します。 |
| ColName2 |
オプションの Text。 |
| コンマ (,) |
省略可能 なブール値。 カンマが千の位の区切りとして使用される場合は TRUE。 |
| カスタマイズ |
オプションの Text。 |
| 小数 |
オプションの Integer。 表示する小数点以下の桁数を指定します。 表示される値は、表示精度に切り上げられます。たとえば、小数点以下 1 桁に丸めると、1.05 は 1.1 として表示されます。 |
| 説明 |
オプションの Text。 フィールドの説明が指定されている場合に、リストの編集フォームに表示される説明を提供します。 既定では、Microsoft SharePoint Foundation のフィールドには説明がありません。 |
| Dir |
オプションの Text。 双方向読み取り順序をサポートするフィードについてテキストの方向を指定します。 LTR (左から右)、RTL (右から左)、none のどちらかの値を使用できます。 |
| 方向 |
オプションの Text。 |
| DisplaceOnUpgrade |
省略可能 なブール値。 フィールドのフィールド定義が既に存在する場合、そのフィールド定義で指定されている値でフィールドのプロパティを強制的に更新するには、TRUE に設定します。 |
| DisplayImage |
オプションの Text。 列に表示されるアイコンの名前を指定します。 |
| DisplayName |
オプションの Text。 フィールドの表示名です。 テキストサイズやスペースの使用に制限はありません。 表示名は、ユーザーが編集でき、最初にフィールドを作成した後に変更できます。 フィールドがテーブル ビューに表示される場合には、この名前は列見出しとして使用され、フィールドがフォームに表示される場合には、フォーム ラベルとして使用されます。 FieldName/> タグは<、指定された場合は表示名を返します。それ以外の場合は、既定で Name 属性が返されます。 |
| DisplayNameSrcField |
オプションの Text。 一般的に、別のフィールドと同じ名前である必要がある計算フィールドで使用されます。 ソース フィールドが変更され、表示名がユーザーによって変更された場合、このフィールドの表示名も変更されます。 この文字列は、他のフィールドの名前を参照します。 |
| DisplaySize |
オプションの Integer。 |
| 部 |
オプションの Number。 数値を表示する前に除算で使用される倍率。 表示番号は (N * Mult / DivDecimals で指定された数値に切り上げられます)。 |
| EnableLookup |
省略可能 なブール値。 フィールドで参照値を有効にする場合は TRUE。 |
| EnforceUniqueValues |
省略可能 なブール値。 |
| ExceptionImage |
オプションの Text。 例外に使用するイメージ ファイルの名前を指定するために、Recurrence フィールド型で使用されます。 |
| Fieldref |
オプションの Text。 参照フィールドなど、このフィールドが参照する別のフィールドの名前を指定します。 |
| FillInChoice |
省略可能 なブール値。 フィールドでユーザーが列の値を入力することが許可されている場合は TRUE。 |
| フィルター処理可能 |
省略可能 なブール値。 フィールドをフィルタ処理できる場合は TRUE。 |
| FilterableNoRecurrence |
省略可能 なブール値。 定期的なイベントを展開しないビューでフィールドに対してフィルタを作成できる場合は TRUE。 Filterable が TRUE である場合は、FilterableNoRecurrence の設定に関係なく、すべてのビューでフィールドをフィルタ処理することができます。 |
| ForcedDisplay |
オプションの Text。 実際のフィールド値の代わりに表示するテキストを指定します。 この属性は、アンケートでユーザー名が表示されることを防止するために使用されます。 |
| ForcePromoteDemote |
省略可能 なブール値。 |
| 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 を指定します。 |
| Id |
オプションの Text。 |
| IMEMode |
オプションの Text。 フィールドに対して使用する入力システム (IME) のモード バイアスを指定します。 IME を使用すると、ある文章入力システムで使用する文字数が特定のキーボードでエンコードできる文字数よりも多い場合に、言語に応じてキーストロークを変換することができます。 以下のいずれかの値を使用できます。 - 自動 使用されていません。 この IME モードを指定するには、 IMEMode プロパティの値を空の文字列 ( "") に設定します。 - アクティブ すべての文字は IME を介して入力されますが、ユーザーは IME を非アクティブ化できます。 - 非 アクティブ ユーザーは IME をアクティブ化できますが、文字は IME なしで入力されます。 |
| Indexed |
省略可能 なブール値。 ビューのフィルターで使用するために列にインデックスを付ける場合は TRUE。 |
| IsolateStyles |
省略可能 なブール値。 RichText 属性が TRUE であり、RichTextMode 属性が FullHtml である Text フィールドの場合、この属性は、フィールドが含まれているページのレンダリングの妨げとならないように、サーバーがフィールドの HTML を書き換えることを指定します。 |
| IsRelationship |
省略可能 なブール値。 値の検索先であるリストからフィールドが探索可能の場合は 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 です。 |
| LinkToItem |
省略可能 なブール値。 |
| LinkToItemAllowed |
オプションの Text。 |
| List |
オプションの Text。 リストの内部名を指定します。 |
| ListItemMenu |
省略可能 なブール値。 |
| ListItemMenuAllowed |
オプションの Text。 |
| Max |
オプションの Number。 フィールドで許容される最大値を指定します。 |
| MaxLength |
オプションの Integer。 フィールド値で許可されている、最大文字数を指定します。 この値はクライアント側で検証され、編集フォームはこの値に合わせて調整されます。 ユーザーが MaxLength で設定された文字数を超えて入力しようとすると、エラー メッセージが表示されます。 |
| Min |
オプションの Number。 フィールドで許容される最小値を指定します。 |
| Mult |
省略可能 なブール値。 数値を表示する前に乗算で使用される倍率。 |
| 名前 |
必須の Text。 フィールドの名前。 これはフィールドの内部名であり、フィールド定義が有効である間は変更されないことが保証されています。 リスト内の一連のフィールドで一意である必要があります。 この名前は、ユーザー定義のフィールド名に基づいて自動的に生成されます。 |
| NegativeFormat |
オプションの Text。 負の値を示す方法を指定します。 以下のいずれかの値に設定できます。 - MinusSign プレフィックスとしてマイナス記号を使用します。 - 括弧 かっこで囲みます。 |
| ノード |
オプションの Text。 XML フォームで使用された場合、この属性は処理命令 (PI) リンクを除くすべてのフィールドで必須であり、昇格されるノードの XPath 式を指定します。 |
| NoEditFormBreak |
省略可能 なブール値。 アイテム作成フォームやアイテム編集フォームのフィールド間に改行が追加されないようにする場合は TRUE。 リッチ テキスト フィールドなどの一部のフィールド型では既定で間隔が追加され、この属性によって余分な間隔を制御できます。 |
| NumLines |
オプションの Integer。 編集中に TEXTAREA ブロックに行数を表示することを推奨します。 これはクライアント UI のヒントであり、編集できるテキストの行数に制限は適用されません。 |
| 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 |
省略可能 なブール値。 Issue Tracking リストで使用され、関連する問題項目のコレクション ID を [編集] フォームと [新しいアイテム] フォームに表示するために TRUE を指定します。 |
| プレゼンス |
省略可能 なブール値。 フィールドのユーザー情報が存在する場合は 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。 フィールドの削除動作を指定します。 Cascade、Restrict、None のいずれかの値を使用できます。 |
| RenderXMLUsingPattern |
省略可能 なブール値。 表示形式を指定するために計算フィールドで使用されます。 TRUE の場合、値は、計算フィールドの基になる最初の非計算フィールドの参照の列値ではなく、計算フィールドの表示パターンに基づいてレンダリングされます。 たとえば、画像ライブラリで、画像サイズ列が幅 x 高さで表される場合、この属性が TRUE に設定されていない場合は、最初のフィールド参照である幅だけが表示されます。 TRUE に設定されている場合は、幅 x 高さの形式で表示されます。 |
| 必須 |
省略可能 なブール値。 TRUE の場合、フィールドに空の値を割り当ててはいけません。 フォーム投稿に空でないフィールド値が指定されていない場合は、標準の必須フィールド テキストまたは明示的に指定されたメッセージ (つまり、ErrorText> タグを使用) <がエラー フォームに表示されます。 この検証はクライアントによってのみ処理されます (データベースでは、すべてのユーザー定義フィールドに対して 常に NULL が許可されます)。 |
| RestrictedMode |
省略可能 なブール値。 Note フィールドで拡張リッチ テキスト形式 (画像、表、ハイパーリンクなど) を使用できないようにし、書式設定されたテキストをこのフィールドに貼り付けることもできないようにする場合は TRUE。 |
| ResultType |
オプションの Text。 フィールドから返される値のデータ型を指定します。 |
| RichText |
省略可能 なブール値。 フィールドがリッチ テキスト書式を表示する場合は TRUE。 |
| RowOrdinal |
オプションの Integer。 フィールドにデータベースの場所を指定します。 |
| 密封 |
省略可能 なブール値。 Schema.xml ファイルで、リストのフィールドについてこの属性を TRUE に設定すると、Change Column ページでフィールドが移動できないフィールドとしてマークされます。 |
| SeparateLine |
省略可能 なブール値。 個別の行でのフィールドのレンダリング (たとえば、Notes または Comment) をサポートするために内部で使用されます。 この属性は、一般的に使用することを目的としていません。 |
| SetAs |
コードから直接使用することは想定されていません。 |
| ShowAddressBookButton |
コードから直接使用することは想定されていません。 |
| ShowAlways |
省略可能 なブール値。 |
| ShowField |
オプション。 ShowField 属性は、表示するフィールド名に設定できます。 既定では、外部リスト内に含まれるレコードの Title フィールドのハイパーリンク テキストが表示されます。 ただし、ShowField 属性を使用してこの動作を無効にし、外部リストの別のフィールドを表示できます。 ShowField 属性のターゲットとして使用できるデータ型は、Text、Choice、および Counter です。 ルックアップ フィールドの場合、このパラメーターは内部フィールド名に設定する必要があります。表示名に設定してもエラーは発生しませんが、フィールドが壊れます。 |
| ShowInDisplayForm |
省略可能 なブール値。 フォームにアイテムを表示するためのフィールドを表示する場合は TRUE。 |
| ShowInEditForm |
省略可能 なブール値。 フォームにアイテムを編集するためのフィールドを表示する場合は TRUE。 |
| ShowInFileDlg |
省略可能 なブール値。 この属性は、ドキュメント ライブラリ スキーマ内のフィールドについてのみ有効です。 FALSE の場合、クライアント アプリケーションから保存するときに表示されるフォームを保存するためのプロパティ ダイアログ ボックスに、このフィールドは表示されません。 たとえば、Title フィールドは、ドキュメント ライブラリに保存されるドキュメント内で直接設定されるので、この属性があります。 |
| ShowInListSettings |
省略可能 なブール値。 リストの設定をカスタマイズするためのページに列を表示する場合は TRUE。 |
| ShowInNewForm |
省略可能 なブール値。 FALSE の場合、表示モードが New に設定されているときは、フィールドが Fields 列挙に表示されません。 この設定のフィールドは、リストの既定の [新しいアイテム] ページに表示されません。 この属性は、特に、ドキュメントをドキュメント ライブラリにアップロードするためのページでフィールドを非表示にするために使用されます。 |
| ShowInVersionHistory |
省略可能 なブール値。 リスト アイテムのバージョンを表示するためのページに列を表示する場合は TRUE。 |
| ShowInViewForms |
省略可能 なブール値。 リスト データの表示に使用されるページにフィールドを表示することを指定する場合は TRUE。 |
| 並べ替え可能か |
省略可能 なブール値。 フィールドの値を並べ替えることができる場合は TRUE。 |
| SourceID |
オプションの Text。 などのフィールドを定義する名前空間、またはユーザー設定フィールド http://schemas.microsoft.com/sharepoint/v3が作成されたリストの GUID が含まれます。 |
| StaticName |
オプションの Text。 フィールドの内部名を格納します。 |
| 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 データ型に対応します。 - 参照Choice フィールドとよく似た動作をしますが、使用可能なオプションは、ハードコーディングされた値の選択ではなく、別のリストから取得される点が異なります。 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 フィールドは として <A HREF="URL">Description</A>表示されます。 説明が指定されていない場合は、 として <A HREF="URL">URL</A>表示されます。 これは、リンク先が移動したときにリンクを修正することによって、サーバー上でローカルであるすべての URL を更新できるようにするためです。 URL フィールドを含むレコードが削除された場合、対応する参照先レコードも URL テーブルから削除されます。 このフィールドは、並べ替えおよびグループ化を行うことができます (並べ替えは、URL の内容ではなく、テキストの説明に従って定義されます。 説明が指定されていない場合は、空白の場合と同様に並べ替えが行われます)。 (並べ替えは、URL の内容ではなく、テキストの説明に従って定義されます。説明が指定されていない場合は、空白と同じように並べ替えられます)。 Type が URL の場合、 LinkType 属性を使用してリンクの種類を指定できます。 nvarchar SQL データ型に対応し、SPFieldUrl クラスによって表されます。- ユーザー UserInfo データベース テーブルを参照する ルックアップ フィールド。 int SQL データ型に対応し、SPFieldUser クラスによって表されます。 - UserMulti 複数の値を含めることができる ユーザー フィールド。 親型: LookupMulti。 - WorkflowEventTypeSPWorkflowHistoryEventType 列挙型で表されるワークフロー イベントの種類を指定します。 親型: 整数。 - WorkflowStatusSPWorkflowStatus 列挙で表されるワークフローの状態を指定します。 nvarchar SQL データ型に対応します。 |
| UniqueId |
オプションの Text。 コードから直接使用することは想定されていません。 |
| UnlimitedLengthInDocumentLibrary |
省略可能 なブール値。 ドキュメント ライブラリ内でフィールド長を無制限にする場合は TRUE。 |
| URLEncode |
省略可能 なブール値。 空白 などの特殊文字を引用符で囲まれた UTF-8 形式に変換する場合は TRUE (文字 %c3%abëなど)。 |
| URLEncodeAsURL |
省略可能 なブール値。 URLEncode と同様ですが、エンコードする文字列が URL のパス コンポーネントであることを指定する場合は TRUE で、スラッシュ (/) がエンコードされないようにします。 |
| UserSelectionMode |
オプションの Text。 アイテム フォームのユーザー フィールドで、各ユーザーの名前だけを選択できるようにするか、各ユーザーとグループの両方の名前を選択できるようにするかを指定します。 以下のいずれかの値を使用できます。 0 - 各ユーザーの名前だけを選択できます。 1 - 各ユーザーとグループの両方の名前を選択できます。 |
| UserSelectionScope |
オプションの Integer。 アイテム フォームのユーザー フィールドでユーザー名を選択する際の範囲を指定します。 値が 0 の場合、SharePoint グループに対する制限はありません。 値が 0 以上の場合、ユーザーの選択は、指定した値と同じ ID を持つ SharePoint グループのメンバーに制限されます。 |
| バージョン |
オプションの Text。 |
| 表示 |
省略可能 なブール値。 既定のビューにフィールドを追加することを指定する場合は TRUE。 既定値は TRUE です。 |
| WebId |
オプションの Text。 |
| Width |
オプションの Integer。 ユーザー情報リストのユーザー用に表示される画像の幅をピクセル単位で指定します。 |
| WikiLinking |
省略可能 なブール値。 二 重かっこ ([[…]]) の形式で表示される Wiki リンクを HTML リンクに変換し、タグを <A> 使用するように指定する場合は TRUE。 |
| Xname |
オプションの Text。 追加、削除、または変更されたフィールドを識別するために XML フォーム内部で使用されます。 この属性は、一般的に使用することを目的としていません。 |
子要素
- 選択肢
- カスタマイズ
- Default
- DefaultFormula
- DisplayBidiPattern
- DisplayPattern
- FieldRefs
- 式
- FormulaDisplayNames
- マッピング
- 検証
親要素
Occurrences
- 最小 : 0
- 最大: 親が Fields の場合は制約なし。 親が ProjectedFields の場合、最大値は、クエリ対象のプライマリ リスト内の許可されるフィールドの最大数と、リストに既に含まれているフィールドの数の差です。
注釈
既定の SharePoint Foundation フィールド型に基づくリスト定義のユーザー設定フィールド定義を作成するには、Schema.xml ファイル内の Field (List - Definition) 要素を使用します。
既定のフィールドの種類に基づいて、サイト コレクション内の Web サイトとリスト間で再利用できるプラグ可能な機能としてユーザー設定フィールド定義を作成するには、 Field (Field) 要素を使用してカスタム サイト列を定義します。
特別なデータ入力規則とフィールド レンダリングを適用したカスタム クラスを実装するcustom field typeを作成するには、Field (Field Types) 要素を使用します。
フィールドは、ビュー定義から参照することも、要素をレンダリングする計算フィールドの式から参照することもできます。 ビューでの表示用に書式設定されたフィールド値を返す場合は、Field 要素 (ビュー) を使用し、フィールドの生データ値を返す場合は、Column Element 要素 (ビュー) を使用します。
フィールドを参照するための構文は、次のとおりです。
<Field Name="FieldName"/>
既定では、フィールドは、前のテーブルで指定したフィールド定義の既定の属性でレンダリングされます。 フィールド属性は、 FieldRef 属性の CAML マークアップでオーバーライドできます。これは、フィールド自体に対して指定された定義をオーバーライドします (フィールドの Type 属性は変更できません)。
フィールドのユーザー定義の表示名を表示するには、 を使用 <Property Select="DisplayName"/>できます。
Fields 要素の列挙内では、Name 属性を省略できます。 一部のフィールド参照では、 を使用して <Column/>、フィールドに格納されている生データにアクセスできます。
フォームやオーサリング UI の特定の側面からのフィールドの一部のプロパティは、 Property 要素 (例: <Property Select="Description"/> または <Property Select="Type"/>) を使用してレンダリングできます。 これらの要素は、単にフィールド属性または子要素 (Property) の値を名前で取得します。
上記の型に加えて、次の定義済みフィールドが Field 要素と共に使用されます。
| 名前 | 説明 |
|---|---|
| Created |
アイテムが作成された時刻 (UTC) を示す DateTime 値を格納するフィールド。 |
| CreatedBy |
UserInfo テーブルを参照し、アイテムを作成したユーザーを示す Lookup 値を格納するフィールド。 |
| Edit |
アイテムを編集するためのフォームへのハイパーリンクを格納する計算フィールド (追加のスキーマなし)。 このフィールドは、アイテムを編集するためのページと、アイテムを識別するための ID フィールドを参照します。 |
| ID |
各リスト内の各アイテムに関連付けられた Counter フィールド型。 この ID は、編集時に URL や POST フォーム内のリスト アイテムを一意に識別します。 Cmd=Save コマンドで ID 属性の値として New を指定すると、現在のアイテムを編集するのではなく、アイテムが作成されます。 |
| Modified |
アイテムが最後に変更された時刻 (UTC) を指定する DateTime 値を含むフィールド。 [変更時刻] は、[バージョン] フィールドの一種としても使用されます。 アイテムの最終変更日は、既存のアイテムが編集されるときに常に転記されます。 現在の変更日と一致しない場合、サーバーは編集に失敗し、エラーをユーザーに返し、サーバー上の現在のデータへのリンク (新しいウィンドウで開きます) を指定して、投稿された値を古いフォームから新しいフォームにコピーできるようにします。 |
| ModifiedBy |
UserInfo テーブルを参照し、アイテムを最後に変更したユーザーを示す Lookup 値を格納するフィールド。 |
| Title |
各アイテムの汎用の表示名。 リストによって表示名が異なっている場合でも、内部フィールド名は Title で同じです。 このタイトルは、リストへの Lookup フィールドで表示される既定のテキストです。 |
| LinkTitle |
タイトル テキストを含むアイテムへのハイパーリンクを表示し、アイテムへの URL (および新しいアイコン参照) を生成する計算フィールド。 このフィールドには追加のストレージはありません。UI のレンダリングには ID フィールドと Title フィールドに依存します。 |
注:
Fields 列挙で返されるフィールドは、表示モードの影響を受けます。 Hidden 属性を使用してマークされているフィールドは返されません。 ReadOnly 属性を使用してマークされているフィールドは、フォームがレンダリングされている場合 (Fields が ListForm 要素内から呼び出される場合) は返されません。 ShowInNewForm 属性を使用してマークされているフィールドは、NEW または PREVIEWNEW 表示モードでは返されません。 ShowInFileDlg 属性を使用してマークされているフィールドは、NewForm ダイアログ フォームをレンダリングするときには返されません。
例
次の例では 、 Field 要素を使用して、Area list という名前のリストのオプションを指定します。
<Field Type="Choice" BaseType="Text" Name="Area">
<CHOICES>
<CHOICE>Views</CHOICE>
<CHOICE>Site Design</CHOICE>
<CHOICE>Layouts</CHOICE>
<CHOICE>Schema Design</CHOICE>
<CHOICE>Fields</CHOICE>
<CHOICE>Forms</CHOICE>
<CHOICE>Projects</CHOICE>
<CHOICE>Inter-Team Issues</CHOICE>
<CHOICE>Schedule</CHOICE>
<CHOICE>Spec</CHOICE>
<CHOICE>Headcount</CHOICE>
<CHOICE>Misc</CHOICE>
</CHOICES>
</Field>