Zen ADO.NET Entity Framework データプロバイダー

接続文字列オプション	ADO.NET Entity Framework アプリケーションでのデフォルト値
Parameter Mode	サポートされません。
Statement Cache Mode	ExplicitOnly 値のみサポートされます。

Code First および Model First のサポート

Entity Framework 4.1 以降のプロバイダーは、Model First および Code First の機能をサポートしています。これらの機能のサポートを実装すると、たとえば、長い識別子名の処理方法など、データプロバイダーへの変更が必要とされます。ただし、これらの変更はアプリケーションの変更を必要としません。

Code First および Model First の実装は、型マッピングの変更を必要とします。詳細については、データ型および関数のマッピングを参照してください。

長い識別子名の処理

ほとんどの Zen 識別子の最大長は 20 バイトです。サーバー上で作成するオブジェクトの名前はクラス名とプロパティ名から取られるため、識別子名がこのサイズを超える場合があります。また、制約名は多くの場合、いくつかのオブジェクト名を連結して作成されます。このような場合には、識別子の最大長を超える可能性がさらに大きくなります。

データプロバイダーは、識別子の末尾を整数のハッシュコードに置き換えることにより、識別子をデータベースで許容される識別子の最大長に短縮します。たとえば、文字列 ColumnMoreThanTwentyCharacters は ColumnMor_2873286151 に短縮されます。DB ツールを使用して DB オブジェクトのアクセスや表示を行った場合、作成されたテーブルの名前が、POCO（Plain Old CLR Object）のクラス名とプロパティ名（Code First）、またはエンティティ名とエンティティのプロパティ名（Model First）に基づいて予想される名前とは異なる場合があります。

同じ先頭文字を持つ 2 つの識別子が短縮されると、識別子間の違いが目で見てわかりづらくなることに注意してください。たとえば、テーブルに 2 つのサポートするシーケンス、ColumnMoreThanTwentyCharacters と ColumnMoreThanTwenty1Characters があるとします。これらのシーケンスが短縮された場合、それぞれ ColumnMor_2873286151 と ColumnMor_672399971 に名前が変更されます。

ADO.NET Entity Framework での Code First Migrations の使用

Entity Framework 4.3 以降では Code First Migrations をサポートしています。これは、POCO クラスを削除して再作成しなくても、このクラスを反映するようにデータベーススキーマを更新することを可能にします。

移行は、モデルの変更に従って、データベーススキーマを増分で更新できるようにします。データベースの変更の各セットは、移行として知られるコードファイルで表されます。移行は、通常、タイムスタンプを使用して管理され、データベース内のテーブルは、どの移行が適用されたかを追跡します。

Code First Migrations の実装は型マッピングの変更を必要とします。詳細については、データ型および関数のマッピングを参照してください。

Progress DataDirect Connect for Zen ADO.NET データプロバイダーを使用して Code First Migrations を実装するには、以下の追加設定を実行する必要があります。

プロジェクト内の Pervasive.Data.SQLClient.Entity アセンブリに参照を追加します。

Configuration Class の変更を継承し、Configuration Class のコンストラクターで SQL Generator を登録します。次のことを行います。

•

PervasiveDbMigrationsConfiguration <TContext> から Configuration Class を継承します。たとえば、次のように指定します。

internal sealed class Configuration: PervasiveDbMigrationsConfiguration<%Context Name%>

•

Class Generator を登録します。

パッケージマネージャーコンソールを使用して移行を有効にした後、configuration.cs ファイルの追加設定に加えて、app.config または configuration.cs ファイルのいずれかで接続文字列を指定します。ただし、接続文字列を app.config ファイルに指定する場合は、接続文字列とコンテキストの名前が同じであるようにしてください。

接続文字列を app.config ファイルに指定する場合は、使用するプロバイダーのバージョンに応じて、次の構文を使用して app.config ファイルで SQL Generator を登録します。

<provider invariantName="Pervasive.Data.SqlClient"

type="Pervasive.Data.SqlClient.Entity.PsqlProviderServices, Pervasive.Data.SqlClient.Entity, Version=4.5.0.6, Culture=neutral, PublicKeyToken=c84cd5c63851e072" />

</providers>

configuration.cs で SQL Generator を登録するには、次の構文を使用します。

SetSqlGenerator(PervasiveConnectionInfo.InvariantName, new PervasiveEntityMigrationSqlGenerator());

ADO.NET Entity Framework での列挙型の使用

enum キーワードは、列挙型を宣言するために使用されます。列挙型は、列挙子リストと呼ばれる名前付き定数の集まりで構成される固有の型です。すべての列挙型には基になる型があります。デフォルトでは、列挙要素の基になるすべての型は int32 にマップされます。デフォルトでは、最初の列挙子の値は 0 で、後続の列挙子の値は 1 ずつ増加していきます。たとえば、曜日の列挙型は次のように指定します。

enum Days {MON, TUE, WED, THU, FRI, SAT, SUN};

この列挙型では、MON は 0、TUE は 1、WED は 2 などとなります。列挙子は、デフォルト値をオーバーライドする初期化子を持つことができます。たとえば、次のように指定します。

enum Days {MON=1, TUE, WED, THU, FRI, SAT, SUN};

この列挙型では、要素の並びは 0 ではなく 1 から開始します。列挙型のフィールドの名前は大文字です。これらは定数であるため、慣例により大文字にします。

Microsoft ADO.NET Entity Framework 5.0 以降は列挙型をサポートしています。列挙型の機能を使用するには、.NET Framework 4.5 以降を対象とする必要があります。Visual Studio 2019 の対象はデフォルトで .NET Framework 4.7.2 です。列挙型は 3 つのワークフロー、すなわち、Model First、Code First、および Database First でサポートされています。

Entity Framework では、列挙型の基になる型は次のとおりです。

•

•

•

•

•

デフォルトでは、列挙型は Int32 型です。他の整数型はコロンを使用して指定します。

enum Days : byte{MON=1, TUE, WED, THU, FRI, SAT, SUN};

基になる型は、列挙子ごとに割り当てるストレージの大きさを指定します。ただし、enum 型を整数型に変更するには、明示的なキャストが必要です。enum の実装は型マッピングの変更もサポートしています。詳細については、データ型および関数のマッピングを参照してください。

Entity Framework の一部として、Entity Developer が［モデルエクスプローラー］ウィンドウで新しい Enum ノードを提供することにより、enum 型を完全にサポートしています。Enum プロパティは、他のスカラープロパティと同じように、LINQ クエリや更新などで使用できます。

データ型および関数のマッピング

ADO.NET Entity Framework を使用すると、開発者はリレーショナルストレージスキーマに対して直接プログラミングする代わりに、概念アプリケーションモデルに対してプログラミングすることで、データアクセスアプリケーションを作成できます。

Database First の型マッピング

Database First モデルでは、データプロバイダーはストア中心の型マッピング方式を使用します。このマッピングでは、Zen（ストア）型は、モデルの生成時に使用される EDM 型に影響を与えます。

Database First の型マッピング

次の表は、Zen 型から、Database First モデルで使用されるプリミティブ型へのマッピングを示しています。一部の Zen データ型はいくつかの異なる EDM 型にマップすることができます。デフォルト値は斜体で示されています。

列は次のように定義されています。

•

［Zen 型］列は、ネイティブな型名を示しています。

•

［ストア（SSDL）型］列は、ストアスキーマ定義言語（SSDL）ファイルで使用されるデータ型を示しています。ストレージメタデータスキーマは、EDM で構築されたアプリケーションのデータを保持する、データベースの形式的記述です。

•

［PrimitiveTypeKind］列は、EDM アプリケーションを定義するのに使用されるエンティティのプロパティの、有効な内容を指定するために使用される共通のデータプリミティブを示しています。

Zen 型	ストア（SSDL）型	PrimitiveTypeKind
AUTOTIMESTAMP	DateTime	DateTime
BFLOAT4	BFloat4	Single
BFLOAT8	BFloat8	Double
BIGIDENTITY	Bigint	Int64
BIGINT	Bigint	Int64
BINARY	binary	Byte[]
BIT	Bit	Boolean
CHAR	Char	String
CURRENCY	Currency	Decimal
DATE	Date	DateTime
DATETIME	DateTime	DateTime
DECIMAL	Decimal	Decimal
DOUBLE	Double	Double
FLOAT	Float	Float
IDENTITY	Identity	Int32
INTEGER	Integer	Int32
LONGVARBINARY	LongVarBinary	Byte[]
LONGVARCHAR	LongVarChar	String
MONEY	Money	Decimal
NCHAR	NChar	String
NLONGVARCHAR	NLongVarChar	String
NUMERIC	Decimal	Decimal
NUMERICSA	DecimalSA	Decimal
NUMERICSTS	DecimalSTS	Decimal
NVARCHAR	NVarChar	String
REAL	Real	Single
ROWID	Rowid	Binary
SMALLIDENTITY	SmallIdentity	Int16
SMALLINT	Smallint	Int16
TIME	Time	Time
TIMESTAMP、TIMESTAMP2	DateTime	DateTime
TINYINT	TinyInt	SByte
UBIGINT	UBigInt	UInt64
UNIQUE_IDENTIFIER	Guid	Guid
UINTEGER	UInteger	UInt32
USMALLINT	USmallInt	UInt16
UTINYINT	UTinyInt	Byte
VARCHAR	Varchar	String

Model First の型マッピング

次の表はモデル中心の型マッピングを示しています。このマッピングでは、EDM 単純型は、データベースの作成に使用される Zen（ストア）型に影響を与えます。列は次のように定義されています。

•

［型マッピングに影響を与えるプロパティ値］列は、型マッピングに影響を及ぼす可能性のある、あらゆるプロパティ値を示しています。

•

［Zen 型］列は、ネイティブな型名を示しています。

PrimitiveTypeKind	型マッピングに影響を与えるプロパティ値	ストア（SSDL）型	Zen 型
Binary	FixedLength：TRUE FixedLength：FALSE	Binary LongVarBinary	Binary(n) LongVarBinary
Boolean		Boolean	Bit
Byte		Tinylint_as_byte	TinyInt
DateTime		DateTime	DateTime
Decimal		Decimal	Decimal
Double		Double	Double
Guid		Guid	Guid
Single		Float	Float
SByte		Smallint_as_Sbyte	Smallint
Int16		SmallInt	Smallint
Int32		Integer	Integer
Int64		Bigint	BigInt
String	MaxLength= (1<=n<=8000) Fixed Length=True Unicode=False	Char	Char(n)
	MaxLength= (1<=n<=8000) Fixed Length=False Unicode=False	Varchar	Varchar(n)
	MaxLength= (>8000) Fixed Length=False Unicode=False	LongVarChar	LongVarchar
	MaxLength= (1<=n<=4000) Fixed Length=True Unicode=True	NChar	NChar(n)
	MaxLength= (1<=n<=4000) Fixed Length=False Unicode=True	NVarChar	NVarChar(n)
	MaxLength= (>4000) Fixed Length=False Unicode=True	NLongVarChar	NLongVarChar
Time		Time	Time
DateTimeOffset		DateTime	DateTime

Code First の型マッピング

次の表はモデル中心の型マッピングを示しています。このマッピングでは、CLR 型は、データベースの作成時に使用される Zen（ストア）型に影響を与えます。一部の CLR 型はいくつかの異なる Zen 型にマップすることができます。デフォルト値は斜体で示されています。

列は次のように定義されています。

•

［CLR 型］列は、共通言語ランタイムの型名を示しています。

•

［Zen 型］列は、ネイティブな型名を示しています。

CLR 型	Zen データ型
Byte[ ]	BINARY
Boolean	BIT
Byte	TINYINT
DateTime	DATETIME
Decimal	DECIMAL
Double	DOUBLE
Guid	UNIQUEIDENTIFIER BINARY
Single	FLOAT
Sbyte	SMALLINT
Int16	SMALLINT
Int32	INTEGER
Int64	BIGINT
String1	NCHAR NVARCHAR NLONGVARCHAR
TimeSpan	TIME
DateTimeOffset	DateTime
1 Code First のワークフローでは、エンティティ内の文字列フィールドの長さが指定されていない場合、データプロバイダーは Unicode 型と非 Unicode 型のデフォルトの長さをそれぞれ 2048 バイトと 4096 バイトに設定します。ただし、文字列フィールドの長さが最大許容限度に設定されている場合、つまり、Unicode 型では 4000 バイト、非 Unicode 型では 8000 バイトに設定されている場合、データプロバイダーはそれぞれを 2048 バイトと 4096 バイトにリセットします。その他、文字列フィールドの長さが指定されているすべてのシナリオでは、データプロバイダーは指定された長さを使用します。

EDM 正規関数から Zen 関数へのマッピング

ADO.NET Entity Framework は、エンティティデータモデル（EDM）正規関数を Zen 用 ADO.NET Entity Framework データプロバイダーの対応するデータソース機能に変換します。これによって、全データソースに共通する形式で表現される関数を呼び出すことができます。

これらの正規関数はデータソースから独立しているため、正規関数の引数の型と戻り値の型は、EDM の型の語句で定義されます。Entity SQL クエリで正規関数を使用すると、データソースで適切な関数が呼び出されます。

すべての正規関数には、ヌルが入力された場合の動作とエラー状況が明示的に指定されています。ただし、ADO.NET Entity Framework はこの動作を実行しません。詳細は、http://msdn.microsoft.com/ja-jp/library/bb738626.aspx で入手できます。

集計正規関数

次の表は、EDM 集計正規関数から Zen 関数へのマッピングを示します。

集計正規関数	Zen 関数
Avg(expression)	avg(expression)
BigCount(expression)	count(expression)
Count(expression)	count(expression)
Max(expression)	max(expression)
Min(expression)	min(expression)
StDev(expression)	stdev(expression)
StDevP(expression)	stdevp(expression)
Sum(expression)	sum(expression)
Var(expression)	var(expression)
VarP(expression)	varp(expression)

数学正規関数

次の表は、EDM 数学正規関数から Zen 関数へのマッピングを示します。ただし、処理する列が decimal 値または integer 値のみを含んでいる場合に使用される関数を対象としています。

詳細については、数値関数を参照してください。また、弊社 Web サイトで Zen のバージョン番号を選択し、開発者リファレンス > データアクセス方法 > SQL Engine Reference > SQL 構文リファレンスを参照してください。

数学正規関数	Zen 関数
Abs(value)	abs(value)
Ceiling(value)	ceiling(value)
Floor(value)	floor(value)
Power(value, exponent)	power(value, exponent)
Round(value)	round(numeric_expression1, integer_expression2)
Round(value, digits)	round(value, digits)
Truncate(value, digits)	truncate(value, digits)

日付と時刻の正規関数

次の表は、EDM の日付と時刻の正規関数から Zen 関数へのマッピングを示します。これらの関数は、DATE や TIME などのデータ型から成るデータの生成、処理、および操作を行います。

日付と時刻の正規関数	Zen 関数
AddNanoseconds(expression, number)	dateadd(millisecond, number/1000000)
AddMicroseconds(expression, number)	dateadd(millisecond, number/1000)
AddMilliseconds(expression, number)	dateadd(millisecond, number)
AddSeconds(expression, number)	dateadd(second, number)
AddMinutes(expression, number)	dateadd(minute, number)
AddHours(expression, number)	dateadd(hour, number)
AddDays(expression, number)	dateadd(day, number)
AddMonths(expression, number)	dateadd(month, number)
AddYears(expression, number)	dateadd(year, number)
CreateDateTime(year, month, day, hour, minute, second)	datetimefromparts(year, month, day, hour, minute, second,0)
CreateDateTimeOffset(year, month, day, hour, minute, second, tzoffset)1	datetimeoffsetfromparts(year, month, day, hour, minute, second, tzoffset)
CreateTime(hour, minute, second)1	timefromparts(hour, minute, second, 0, 0)
CurrentDateTime()	now()
CurrentDateTimeOffset()	sysdatetimeoffset()
CurrentUtcDateTime()	current_timestamp()
Day(expression)	datepart(day, expression)
DayOfYear(startexpression, endexpression)	dayofyear(expression)
DiffNanoSeconds(startexpression, endexpression)	datediff(millisecond, startexpression, endexpression)*1000000
DiffMilliSeconds(startexpression, endexpression)	datediff(millisecond, startexpression, endexpression)
DiffMicroSeconds(startexpression, endexpression)	datediff(millisecond, startexpression, endexpression)*1000
DiffSeconds(startexpression, endexpression)	datediff(second, startexpression, endexpression)
DiffMinutes(startexpression, endexpression)	datediff(minute, startexpression, endexpression)
DiffHours(startexpression, endexpression)	datediff(hour, startexpression, endexpression)
DiffDays(startexpression, endexpression)	datediff(day, startexpression, endexpression)
DiffMonths(startexpression, endexpression)	datediff(month, startexpression, endexpression)
DiffYears(startexpression, endexpression)	datediff(year, startexpression, endexpression)
GetTotalOffsetMinutes(DateTime Offset)	datepart(tzoffset, expression)
Year(expression)	datepart(year, expression)
Month(expression)	datepart(month, expression)
Day(expression)	datepart(day, expression)
Hour(expression)	datepart(hour, expression)
Minute(expression)	datepart(minute, expression)
Second(expression)	datepart(second, expression)
Millisecond(expression)	datepart(millisecond, expression)
TruncateTime(expression)	convert(expression, SQL_DATE)
1 Zen v11.30 Update 4（May 2013）が必要です。

ビット単位の正規関数

次の表は、EDM ビット単位の正規関数から Zen 関数へのマッピングを示します。

ビット単位の正規関数	Zen 関数
BitWiseAnd(value1, value2)	bit_and(value1, value2)
BitWiseNot(value)	bit_compliment
BitWiseOr(value1, value2)	bit_or
BitWiseXor(value1, value2)	bit_xor

文字列正規関数

次の表は、EDM 文字列正規関数から Zen 関数へのマッピングを示します。

文字列正規関数	Zen 関数
Concat(string1, string2)	concat(string1, string2)
Contains(string, target)	contains(string, target)
EndsWith(string, target)	endswith(string, target)
IndexOf(target, string2)	instr(target, string2)
Left(string1, length)	left(string1, length)
Length(string)	length(string)
LTrim(string)	ltrim(string)
Trim(string)	trim(BOTH FROM string)
Replace(string1, string2, string3)	replace(string1, string2, string3)
Reverse(string)	reverse(string)
RTrim(string)	rtrim(string)
StartsWith(string, target)	startswith(string, target)
Substring(string, start, length)	INCOMPLETE regexpr_substr(...)
ToLower(string)	lower(string)
ToUpper(string)	upper(string)

その他の正規関数

次の表は、その他の正規関数から Zen 関数へのマッピングを示します。

その他の正規関数	Zen 関数
NewGuid()	newid()

Entity Framework 機能の拡張

ADO.NET Entity Framework は、多くの ADO.NET 機能をマスクし、アプリケーション開発を簡略化することによって、強力な生産性の向上を提供します。ADO.NET データプロバイダーには、パフォーマンスを最適化するように設計された機能が備わっています。

Entity Framework のパフォーマンスの向上

Entity Framework は強力な生産性の向上を提供しますが、一部の開発者は、アプリケーションでのパフォーマンスの最適化を必要とする機能について、Entity Framework が制御をしすぎると考えています。

XML スキーマファイルのサイズの制限

エンティティデータモデル（EDM）を使って大きなモデルを構築すると、非常に効率が悪くなる可能性があります。最適な結果を得るために、モデルのエンティティが 50 から 100 に達している場合は、モデルを分割することを考慮してください。

XML スキーマファイルのサイズは、モデルを生成する基となったデータベースのテーブル、ビュー、またはストアドプロシージャの数にある程度比例します。スキーマファイルのサイズが大きくなるにつれ、メタデータの In-Memory モデルの作成や解析にかかる時間が増えます。これは、ObjectContext インスタンスごとに負担する、1 回限りのパフォーマンスコストです。

このメタデータは EntityConnection 文字列に基づいて、アプリケーションドメインごとにキャッシュされます。つまり、1 つのアプリケーションドメインの複数の ObjectContext インスタンスで同じ EntityConnection 文字列を使用している場合、アプリケーションがメタデータの読み込みに関してコストを負担するのは 1 回だけということです。しかし、モデルのサイズが大きくなる場合や、アプリケーションが長期にわたるものでない場合には、パフォーマンスコストが重要になる可能性があります。

ADO.NET Entity Framework でのストアドプロシージャの使用

ADO.NET Entity Framework でストアドプロシージャを使用するには、関数のマッピングが必要です。このようなストアドプロシージャの呼び出しは複雑で、いくらかのコーディングを必要とします。

機能の提供

Connection オブジェクトには、拡張された統計情報機能を提供するためのプロパティおよびメソッドが含まれています。これらは、ADO.NET データプロバイダーでは標準ですが、ADO.NET Entity Framework レイヤーでは利用できません。代わりに、「擬似」ストアドプロシージャを介して同様の機能を公開します。

この方法では、エンティティデータモデル（EDM）を使用して、ADO.NET の結果に対応する結果を得ます。これは実質的に、擬似ストアドプロシージャから戻されるエンティティおよび関数を提供します。

擬似ストアドプロシージャへのマッピング

次の表は、データプロバイダーの Connection プロパティから対応する擬似ストアドプロシージャへのマッピングを示します。

Connection プロパティ	擬似ストアドプロシージャ
StatisticsEnabled	Psql_Connection_EnableStatistics Psql_Connection_DisableStatistics
Connection メソッド	擬似ストアドプロシージャ
ResetStatistics	Psql_Connection_ResetStatistics
RetrieveStatistics	Psql_Connection_RetrieveStatistics

次の C# コードで示されているように、アプリケーションは ObjectContext を使用してストアドプロシージャコマンドを作成する必要があります。

using (MyContext context = new MyContext())

{

EntityConnection entityConnection = (EntityConnection)context.Connection;

// EntityConnection は基となるストア接続を公開します

DbConnection storeConnection = entityConnection.StoreConnection;

DbCommand command = storeConnection.CreateCommand();

command.CommandText = "Psql_Connection_EnableStatistics";

command.CommandType = CommandType.StoredProcedure;

command.Parameters.Add(new PsqlParameter("cid", 1));

}

bool openingConnection = command.Connection.State == ConnectionState.Closed;

if (openingConnection) { command.Connection.Open(); }

int result;

try

{

result = command.ExecuteNonQuery();

}

finally

{

if (openingConnection && command.Connection.State == ConnectionState.Open) { command.Connection.Close(); }

}

オーバーロードされたストアドプロシージャの使用

オーバーロードされたストアドプロシージャが複数ある場合、Zen Entity Framework データプロバイダーは各ストアドプロシージャに識別子を追加して、SSDL でそれらを識別できるようにします。データプロバイダーは、アプリケーションでストアドプロシージャを呼び出す前に、追加した識別子を削除します。

.NET オブジェクトの使用

ADO.NET Entity Framework データプロバイダーは .NET パブリックオブジェクトをサポートし、それらをシールドオブジェクト（封印されたオブジェクト）として公開します。

詳細については、サポートされる .NET オブジェクトを参照してください。

ADO.NET Entity Framework のプログラミングコンテキストでは、本質的に一部の ADO.NET メソッドおよびプロパティを使用する必要がなくなります。しかし、これらのプロパティおよびメソッドは、標準の ADO.NET アプリケーションでは有用なままです。Visual Studio に組み込まれているオンラインヘルプで、各クラスのパブリックメソッドおよびパブリックプロパティについて説明されています。

ADO.NET Entity データプロバイダーとの、プロパティおよびメソッドの相違点

次の表は、ADO.NET Entity Framework アプリケーションでデータプロバイダーを使用する場合には不要となる、あるいは実装が異なるプロパティおよびメソッドを示しています。

プロパティまたはメソッド	動作
PsqlCommand
AddRowID	サポートされません。ADO.NET Entity Framework は、返される追加データを処理しません。
ArrayBindCount	サポートされません。アプリケーションは、ADO.NET Entity Framework 上でこのバインド数に影響を与えることができません。
ArrayBindStatus	サポートされません。アプリケーションは、ADO.NET Entity Framework 上でこのバインド数に影響を与えることができません。
BindByName	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
CommandTImeout	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
UpdatedRowSource	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
PsqlCommandBuilder
DeriveParameters	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
PsqlConnection
ConnectionTimeout	接続文字列でのみサポートされます。
StatisticsEnabled	StatisticsEnabled または StatisticsDisabled ストアドプロシージャを使用します。ADO.NET Entity Framework アプリケーションでこの関数を使用する方法については、ADO.NET Entity Framework でのストアドプロシージャの使用を参照してください。
DataAdapter
UpdateBatchSize	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
Error
ErrorPosition	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。
SQLState	サポートされません。代わりに、データプロバイダーは ADO.NET Entity Framework プログラミングコンテキストを使用します。

モデルの作成

Entity Framework は、Visual Studio でデータのモデルを作成します。

メモ： ADO.NET Entity Framework データプロバイダーを使って開発するには、バージョン 4.6 の Actian Zen ADO.NET Entity Framework データプロバイダーと一緒に、Microsoft .NET Framework バージョン 4.5.x、4.6.x、4.7.x、または 4.8 と、Visual Studio 2019 以降を使用する必要があります。

Visual Studio で Entity Framework を使用してデータのモデルを作成するには、まず、データベーススキーマが利用可能になっていることを確認してください。

Visual Studio で Entity Framework を使用してデータのモデルを作成するには

Visual Studio で、Windows コンソール、Windows フォームなどの新しい .NETアプリケーションを作成します。

ソリューションエクスプローラーでプロジェクトを右クリックし、［追加］>［新しい項目］をクリックします。

［ADO.NET Entity Data Model］を選択したら、［追加］をクリックします。

Entity Data Model ウィザードが表示されます。Microsoft ADO.NET Entity Framework 6.1（EF 6.1）を構成しているかどうかに基づいて、次のいずれかの操作を行います。

•

EF 6.1 を構成していない場合は、［データベースから生成］を選択して［次へ］をクリックします。

•

EF 6.1 を構成している場合は、［データベースから EF Designer］を選択して［次へ］をクリックします。

［データ接続の選択］ページで［新しい接続］をクリックして、新しい接続を作成します。既存の接続がある場合は、ドロップダウンリストからその接続を選択することができます。

［接続のプロパティ］ウィンドウが表示されます。必要な接続情報を指定して、［OK］をクリックします。

ウィザードが Entity 接続文字列を作成します。

ラジオボタンが選択可能であれば、［はい、重要情報を接続文字列に含めます］を選択して、接続文字列に重要情報を含めるようにします。

［エンティティ接続設定に名前を付けて...に保存］フィールドで、メインのデータアクセスクラスの名前を入力するか、またはデフォルトの名前を受け入れます。

［次へ］をクリックします。

構成されている Entity Framework のバージョンに基づいて、次のいずれかの操作を行います。

•

現在のプロジェクト用に EF5 を構成している場合は、［バージョンの選択］ページで［次へ］をクリックし、デフォルトの［Entity Framework 5.0］で次へ進めます。

メモ：現在のプロジェクトで EF 6.1 を使用するには、ウィザードを終了し、EF 6.1 を構成した後、プロジェクトをリビルドします。EF 6.1 の構成後にプロジェクトをリビルドすると、ウィザードでは［バージョンの選択］ページが表示されず、次の手順へ直接進めるようになります。

•

現在のプロジェクト用に EF 6.1 を構成している場合は、次の手順に進みます。

モデルで使用するデータベースオブジェクトを選択します。

10.

［完了］をクリックします。モデルが生成され、モデルブラウザーで開かれます。

Entity Framework 5 アプリケーションから Entity Framework 6.1 へのアップグレード

下記の手順では、Zen ADO.NET Entity Framework プロバイダーを使用して作成された EF 5 アプリケーションを EF 6.1 アプリケーションにアップグレードします。

メモ： Entity Framework 5 Code First アプリケーションで作成されたオブジェクトがターゲットデータベースに既に含まれている場合は、それらのオブジェクトを削除してから、移行された Entity Framework 6.1 アプリケーションを実行する必要があります。Entity Framework 5.0 は Entity Framework 6.1 とは異なる外部キー制約名を生成するため、それにより、アプリケーションは "テーブルまたはビューは既に存在します" というエラーで失敗します。

重要！ここで示されている手順を指定された順序で実行してください。

machine.config ファイルを更新するには

この手順は次のような理由から必要となります。

Entity Framework Power Tools を使用して、EF 6.1 でマッピングビューを再生成することができます。Entity Framework Power Tools を Zen ADO.NET Entity Framework プロバイダーと連動させるには、.NET Framework 4.0 の machine.config ファイルに Provider の登録エントリを追加する必要があります。

メモ：この手順は、EF 5 アプリケーションを EF 6.1 にアップグレードする場合にのみ必要となります。アップグレード後、machine.config ファイルの編集を元に戻して、以前の内容に戻すことをお勧めします。

以下の手順を続行する前に、すべての Visual Studio ウィンドウを閉じてください。

次の場所にある .NET Framework 4 用の machine.config ファイルを開きます。64 ビットシステムを使用している場合は、2 番目の場所にあるファイルも開きます。

•

%windir%\Microsoft.NET\Framework\v4.0.30319\Config\machine.config

•

%windir%\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config

<configSections></configSections> ノード下に次のエントリを追加します。

<configuration> </configuration> ノード下の </configSections> 閉じるタグより後に、次のエントリを追加します。

変更したファイルを保存して閉じます。

対応するプロジェクトに EF バージョン 6.1.2 をインストールする必要があります。これを行うには、プロジェクトを新しい EF 6.1.x ランタイムにアップグレードする必要があります。次の 2 つの方法のいずれかにより実行できます。

方法 1

プロジェクトを右クリックして、［NuGet パッケージの管理］をクリックします。

［オンライン］タブで、EntityFramework を選択して［インストール］をクリックします。

以前のバージョンの EntityFramework NuGet パッケージが EF 6.1.x にアップグレードされます。

方法 2

EF 6.1.2 をインストールする対応プロジェクトに対し、パッケージマネージャーコンソールから次のコマンドを実行します。

Install-Package EntityFramework -Version 6.1.2

System.Data.Entity.dll へのアセンブリ参照が削除されていることを確認します。

EF6 NuGet パッケージをインストールすると、System.Data.Entity へのすべての参照がプロジェクトから自動的に削除されます。

EF 6.x のコード生成を使用するように Enterprise Framework Designer（EDMX）モデルを変更します。EF Designer で作成されたモデルがある場合は、コード生成テンプレートを更新して、EF6 互換コードを生成する必要があります。

メモ： Visual Studio 2012 以降の場合は、EF 6.x DbContext Generator テンプレートのみ使用できます。

既存のコード生成テンプレートを削除します。
これらのファイルには通常、<edmx ファイル名>.tt や <edmx ファイル名>.Context.tt という名前が付けられており、ソリューションエクスプローラーで .edmx ファイルの下に入れ子になっています。ソリューションエクスプローラーでテンプレートを選択し、Delete キーを使用してそれらを削除することができます。

メモ： Web サイトプロジェクトでは、ソリューションエクスプローラー内のテンプレートは .edmx ファイルの下に入れ子になっているのではなく、並んで存在しています。VB.NET プロジェクトでは、［すべてのファイルを表示］を有効にして、入れ子になったテンプレートファイルを表示できるようにする必要があります。

適切な EF 6.x コード生成テンプレートを追加します。
EF Designer でモデルを開き、デザイン画面を右クリックして［コード生成項目の追加］を選択します。

•

DbContext API（推奨）を使用している場合は、［データ］タブで EF 6.x DbContext Generator を使用できます。
Visual Studio 2012 を使用している場合は、このテンプレートを使用するために EF 6 Tools をインストールする必要があることに注意してください。詳細については、Microsoft の「Entity Framework を取得する」（https://msdn.microsoft.com/ja-jp/library/ee712906(v=vs.113).aspx）を参照してください。

•

ObjectContext API を使用している場合は、［オンライン］タブを選択し、EF 6.x EntityObject Generator を検索する必要があります。

コード生成テンプレートにカスタマイズを適用した場合は、更新されたテンプレートに再適用する必要があります。

使用しているすべてのコア EF 型の名前空間を更新します。

DbContext 型および Code First 型は変更されていません。これは、EF 4.1 以降を使用する多くのアプリケーションでは、何も変更する必要がないことを意味します。

以前は System.Data.Entity.dll にあった ObjectContext などの型は、新しい名前空間に移動されました。つまり、EF6 に対してビルドするには、using ディレクティブまたは import ディレクティブを更新する必要があります。

名前空間の変更に関する一般的な規則は、「System.Data.* 内のすべての型が System.Data.Entity.Core.*.に移動される」ということです。言い換えると、System.Data の後に Entity.Core を挿入するだけです。たとえば、次のようになります。

•

System.Data.EntityException => System.Data.Entity.Core.EntityException

•

System.Data.Objects.ObjectContext => System.Data.Entity.Core.Objects.ObjectContext

•

System.Data.Objects.DataClasses.RelationshipManager => System.Data.Entity.Core.Objects.DataClasses.RelationshipManager

これらの型は、ほとんどの DbContext ベースのアプリケーションでは直接使用されないため、Core 名前空間にあります。System.Data.Entity.dll の一部であった一部の型は、DbContext ベースのアプリケーションでよく使用され、直接使用されるため、Core 名前空間に移動されていません。次のものが該当します。

•

System.Data.EntityState => System.Data.Entity.EntityState

•

System.Data.Objects.DataClasses.EdmFunctionAttribute => System.Data.Entity.DbFunctionAttribute
メモ：このクラスは名前が変更されました。古い名前のクラスは引き続き存在し、動作しますが、現在は不使用とマークされています。

•

System.Data.Objects.EntityFunctions => System.Data.Entity.DbFunctions
メモ：このクラスは名前が変更されました。古い名前のクラスは引き続き存在し、動作しますが、現在は不使用とマークされています。

10.

マッピングビューを再生成します。

以前にマッピングビューを生成した場合は、そのファイルを削除して、マッピングビューを再生成します。マッピングビューの詳細については、https://msdn.microsoft.com/en-us/data/dn469601 を参照してください。

これで、Zen ADO.NET データプロバイダーを使用してビルドされた EF 5 アプリケーションが EF 6.1.2 にアップグレードされました。

メモ：すべての EF 5 アプリケーションが EF 6.1.2 にアップグレードされたら、machine.config ファイルに加えた変更を元に戻し、以前の machine.config ファイルを復元することをお勧めします。

Entity Framework Power Tools は、ビューモデルを使用する EF 5.0 アプリケーションを EF 6.1 アプリケーションに移行するためのより簡単な方法を提供します。テスト中、Entity Framework Power Tools が Zen Entity Framework プロバイダーで正常に機能することがわかりました。

メモ： Entity Framework Power Tools は、Zen ADO.NET Entity Framework データプロバイダーでは認定済みのサポートされているツールではありません。

詳細情報

ADO.NET および Entity Framework の追加情報については、以下を参照してください。

•

Programming Entity Framework by Julie Lerman は、ADO.NET Entity Framework の使い方の網羅的な議論を提供しています。

•

ADO.NET Entity Framework では、Entity Framework を紹介するほか、多くの詳細にわたる項目へのリンクを提供しています。

•

接続文字列（Entity Framework）では、Entity Framework による接続文字列の使い方について説明します。接続文字列には、基となる ADO.NET データプロバイダーへの接続に使用する情報が含まれているほか、必要なエンティティデータモデルのマッピングおよびメタデータに関する情報も含まれています。

•

Entity Data Model ツールでは、EDM を使用してアプリケーションを視覚的に構築するためのツールについて説明します。個別のツールとして、Entity Data Model ウィザード、ADO.NET Entity Data Model デザイナー（エンティティデザイナー）、およびモデルの更新ウィザードがあります。これらのツールは共同して、エンティティデータモデルを生成、編集、および更新することができます。

•

LINQ to Entities を使用すると、開発者はビジネスロジックの構築に使用された言語と同じ言語のデータベースに対するクエリを作成できるようになります。