EntityContainer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
概念モデルのエンティティ コンテナーを表します。 EntityContainer は、エンティティ セットとアソシエーション セットの論理的なグループです。
public ref class EntityContainer sealed : System::Data::Metadata::Edm::GlobalItem
public sealed class EntityContainer : System.Data.Metadata.Edm.GlobalItem
type EntityContainer = class
inherit GlobalItem
Public NotInheritable Class EntityContainer
Inherits GlobalItem
- 継承
例
次のコード サンプルでは、接続からメタデータ ワークスペースを取得した後、そのメタデータ ワークスペースを使用して、指定されたデータ モデルのエンティティ コンテナーに関する情報を取得します。 メタデータ ワークスペースは、メタデータの取得をサポートするランタイム サービス コンポーネントです。
このコード サンプルでは、CSpace と SSpace を使用して、モデルを指定します。 CSpace は、概念モデルの既定の名前を表します。 SSpace は、ストレージ モデルの既定の名前を表します。
メソッドは GetEntityContainers
エンティティ コンテナーのコレクションを取得し、コレクションを反復処理して、指定されたコンテナー内の各エンティティ セットと関連付けセットを取得します。 このコード サンプルでは 、AdventureWorks モデルを使用します。
using System;
using System.Data;
using System.Data.EntityClient;
using System.Data.Metadata.Edm;
using System.Collections.ObjectModel;
class GetEntityContainerExample
{
static void Main()
{
try
{
// Establish a connection to the underlying data provider by
// using the connection string specified in the config file.
using (EntityConnection connection =
new EntityConnection("Name=AdventureWorksEntities"))
{
// Open the connection.
connection.Open();
// Access the metadata workspace.
MetadataWorkspace workspace =
connection.GetMetadataWorkspace();
// Get the entity containers in the conceptual model.
GetEntityContainers(workspace, DataSpace.CSpace);
// Get the entity containers in the storage model.
GetEntityContainers(workspace, DataSpace.SSpace);
}
}
catch (MetadataException exceptionMetadata)
{
Console.WriteLine("MetadataException: {0}",
exceptionMetadata.Message);
}
catch (System.Data.MappingException exceptionMapping)
{
Console.WriteLine("MappingException: {0}",
exceptionMapping.Message);
}
}
public static void GetEntityContainers(
MetadataWorkspace workspace, DataSpace model)
{
// Get a collection of the entity containers.
ReadOnlyCollection<EntityContainer> containers =
workspace.GetItems<EntityContainer>(model);
// Iterate through the collection to get each entity container.
foreach (EntityContainer container in containers)
{
Console.WriteLine("EntityContainer Name: {0} ",
container.Name);
// EntitySetBase is a super type for
// EntitySets and RelationshipSets.
// Iterate through the collection to get each EntitySetBase.
foreach (EntitySetBase baseSet in container.BaseEntitySets)
{
// Check if this instance is an EntitySet.
if (baseSet is EntitySet)
{
Console.WriteLine(
" EntitySet Name: {0} , EntityType Name: {1} ",
baseSet.Name, baseSet.ElementType.FullName);
}
// RelationshipSet is a super type for AssociationSet.
// Check if this instance is an AssociationSet.
if (baseSet is AssociationSet)
{
Console.WriteLine(
" AssociationSet Name: {0} , " +
"AssociationType Name: {1} ",
baseSet.Name, baseSet.ElementType.FullName);
// Get the AssociationSet.
AssociationSet associationSet =
baseSet as AssociationSet;
// Iterate through the collection to get
// each AssociatedSetEnd.
foreach (AssociationSetEnd end in
associationSet.AssociationSetEnds)
{
Console.WriteLine(
" EntitySet Name: {0} , Name: {1} ",
end.EntitySet, end.Name);
}
}
}
}
}
}
Imports System
Imports System.Collections.ObjectModel
Imports System.Data
Imports System.Data.EntityClient
Imports System.Data.Metadata.Edm
Class GetEntityContainerExample
Public Shared Sub Main()
Try
' Establish a connection to the underlying data provider by
' using the connection string specified in the config file.
Using connection As EntityConnection = _
New EntityConnection("Name=AdventureWorksEntities")
' Open the connection.
connection.Open()
' Access the metadata workspace.
Dim workspace As MetadataWorkspace = _
connection.GetMetadataWorkspace
' Get the entity containers in the conceptual model.
GetEntityContainers(workspace, DataSpace.CSpace)
' Get the entity containers in the storage model.
GetEntityContainers(workspace, DataSpace.SSpace)
End Using
Catch exceptionMetadata As MetadataException
Console.WriteLine("MetadataException: {0}", _
exceptionMetadata.Message)
Catch exceptionMapping As MappingException
Console.WriteLine("MappingException: {0}", _
exceptionMapping.Message)
End Try
End Sub
Public Shared Sub GetEntityContainers( _
ByVal workspace As MetadataWorkspace, ByVal model As DataSpace)
' Get a collection of the entity containers.
Dim containers As ReadOnlyCollection(Of EntityContainer) = _
workspace.GetItems(Of EntityContainer)(model)
' Iterate through the collection to get each entity container.
Dim container As EntityContainer
For Each container In containers
Console.WriteLine("EntityContainer Name: {0} ", container.Name)
' EntitySetBase is a super type for
' EntitySets and RelationshipSets.
' Iterate through the collection to get each EntitySetBase.
Dim baseSet As EntitySetBase
For Each baseSet In container.BaseEntitySets
' Check if this instance is an EntitySet.
If TypeOf baseSet Is EntitySet Then
Console.WriteLine( _
" EntitySet Name: {0} , EntityType Name: {1} ", _
baseSet.Name, baseSet.ElementType.FullName)
End If
' RelationshipSet is a super type for AssociationSet.
' Check if this instance is an AssociationSet.
If TypeOf baseSet Is AssociationSet Then
Console.WriteLine( _
" AssociationSet Name: {0} , " + _
"AssociationType Name: {1} ", _
baseSet.Name, baseSet.ElementType.FullName)
' Get the AssociationSet.
Dim associationSet As AssociationSet = _
TryCast(baseSet, AssociationSet)
' Iterate through the collection to get
' each AssociatedSetEnd.
Dim endMember As AssociationSetEnd
For Each endMember In associationSet.AssociationSetEnds
Console.WriteLine( _
" EntitySet Name: {0} , Name: {1} ", _
endMember.EntitySet, endMember.Name)
Next
End If
Next
Next
End Sub
End Class
注釈
概念レベルにおける EntityContainer クラスは、ストレージ メタデータ スキーマのデータベース オブジェクトにマップされるコンテナーを表します。 ストレージ レベルにおける EntityContainer クラスは、モデル上に構築されたアプリケーションのデータを保存するテーブルやキーのリレーションシップの記述を表します。 概念モデルのエンティティ コンテナーの詳細については、「 エンティティ コンテナー」を参照してください。
プロパティ
BaseEntitySets |
この EntityContainer に含まれているエンティティ セットとアソシエーション セットの一覧を取得します。 |
BuiltInTypeKind |
この EntityContainer の組み込み型種別を取得します。 |
Documentation |
この型に関連付けられているドキュメントを取得または設定します。 (継承元 MetadataItem) |
FunctionImports |
EdmFunction の要素のコレクションを指定します。 各関数には、データベースに存在するストアド プロシージャ、またはエンティティとそのプロパティにマップされている同等 |
MetadataProperties |
現在の型のプロパティの一覧を取得します。 (継承元 MetadataItem) |
Name |
この EntityContainer の名前を取得します。 |
メソッド
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetEntitySetByName(String, Boolean) |
指定されたエンティティ セット名を使用して、EntitySet オブジェクトを返します。 |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetRelationshipSetByName(String, Boolean) |
指定されたリレーションシップ セット名を使用して、RelationshipSet オブジェクトを返します。 |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
この EntityContainer の名前を返します。 |
TryGetEntitySetByName(String, Boolean, EntitySet) |
指定されたエンティティ セット名を使用して、EntitySet オブジェクトを返します。 |
TryGetRelationshipSetByName(String, Boolean, RelationshipSet) |
指定されたリレーションシップ セット名を使用して、RelationshipSet オブジェクトを返します。 |
適用対象
.NET