Documentation 要素 (CSDL)

概念スキーマ定義言語 (CSDL) の Documentation 要素は、親要素で定義されたオブジェクトに関する情報の提供に使用できます。 .edmx ファイルでは、Documentation 要素が、Entity Data Model デザイナーのデザイン画面にオブジェクト (エンティティ、アソシエーション、プロパティなど) として表示される要素の子である場合、Documentation 要素の内容がそのオブジェクトの Visual Studio [プロパティ] ウィンドウに表示されます。

The Documentation element can have the following child elements (in the order listed):

  • Summary: 親要素の簡単な説明 (0 個または 1 個の要素)。

  • LongDescription: 親要素の詳細な説明 (0 個または 1 個の要素)。

  • annotation 要素 (0 個以上の要素)。

適用可能な属性

Documentation 要素には、任意の数の annotation 属性 (カスタム XML 属性) を適用できます。 However, custom attributes may not belong to any XML namespace that is reserved for CSDL. カスタム属性の完全修飾名は一意である必要があります。

The following example shows the Documentation element as a child element of an EntityType element. 次のスニペットが .edmx ファイルの CSDL の内容に含まれていた場合、Customer エンティティ型をクリックすると、Summary 要素と LongDescription 要素の内容が、Visual Studio [プロパティ] ウィンドウに表示されます。

<EntityType Name="Customer">
   <Documentation>
     <Summary>Summary here.</Summary>
     <LongDescription>Long description here.</LongDescription>
   </Documentation>
   <Key>
     <PropertyRef Name="CustomerId" />
   </Key>
   <Property Type="Int32" Name="CustomerId" Nullable="false" />
   <Property Type="String" Name="Name" Nullable="false" />
</EntityType>

参照

概念

エンティティ フレームワークの概要
CSDL 仕様
EntityContainer 要素 (CSDL)

その他のリソース

CSDL、SSDL、および MSL 仕様
ADO.NET Entity Data Model Tools
.edmx File Overview