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>