EntityContainer 元素 (CSDL)

EntityContainer 元素定义单一商业智能数据模型中的实体集合。 在应用程序中,EntityContainer 表示一个数据模型,其中可能包含多个其列按关系链接起来的表以及计算、度量值和 KPI。

EntityContainer 必须指定数据模型中包含的每种实体类型。 有关这些模型实体的信息是通过列出此类型的 Entity 元素的子实体指定的。 有关详细信息,请参阅 EntityType 元素 (CSDL)

一个 EntityContainer 元素可以包含以下元素:

  • EntitySet 元素

  • AssociationSet 元素

诸如排序规则和语言等属性是在 EntityContainer(而非各个对象)的级别定义的。 但是,模型内的列和文本属性在其他语言中可能具有标题或翻译。

适用的属性

下表列出了可在 EntityContainer 元素上找到的属性。

属性名称

是否必需

Name

数据模型的名称。

Caption

数据库或数据模型的说明。

Culture

一个字符串,该字符串包含请求的 LCID。

CompareOptions

模型的特定于语言的排序和字符串比较选项。

CompareOptions 属性定义应用于数据模型的排序规则属性。 CompareOptions 定义的属性派生自在模型设计时在 Analysis Services 数据库中设置的排序顺序、区分假名和区分大小写的设置。 下表描述了作为 CompareOptions 属性的一部分包含的值。

属性名称

是否必需

IgnoreCase

布尔值,指示是否在数据模型中启用了该选项。

IgnoreNonSpace

布尔值,指示是否在数据模型中启用了该选项。

IgnoreKanaType

布尔值,指示是否在数据模型中启用了排序选项。

IgnoreWidth

布尔值,指示是否在数据模型中启用了排序选项。

下表显示 Analysis Services 中的排序选项以及它们如何与 .NET 排序选项进行比较。

Windows 排序样式

.Net CompareOptions

二进制 (_BIN) 1

Ordinal

二进制-码位 (_BIN2) 1

Ordinal

区分大小写 (_CS)

IgnoreCase

区分重音 (_AS)

IgnoreNonSpace

区分假名 (_KS)

IgnoreKanaType

区分全半角 (_WS)

IgnoreWidth

请注意不支持以下 .NET 设置:

  • IgnoreSymbols

  • OrdinalIgnoreCase

  • StringSort

示例

以下示例表示一个简单数据模型,其中包含三个表以及一针对 Geography 键的一个关系。 EntityContainer 上的 Culture 属性表示服务器的语言。

Namespace="SimpleModel">
          <EntityContainer Name="SimpleModel">
            <EntitySet Name="DimCustomer" EntityType="SimpleModel.DimCustomer">
              <bi:EntitySet />
            </EntitySet>
            <EntitySet Name="DimDate" EntityType="SimpleModel.DimDate">
              <bi:EntitySet />
            </EntitySet>
            <EntitySet Name="DimGeography" EntityType="SimpleModel.DimGeography">
              <bi:EntitySet />
            </EntitySet>
            <AssociationSet Name="DimCustomer_DimGeography_GeographyKey" Association="SimpleModelDB.DimCustomer_DimGeography_GeographyKey">
              <End EntitySet="DimCustomer" />
              <End EntitySet="DimGeography" />
              <bi:AssociationSet />
            </AssociationSet>
            <bi:EntityContainer Culture="en-US">
              <bi:CompareOptions IgnoreCase="true" />
            </bi:EntityContainer>
          </EntityContainer>