共通のスキーマ コレクション (ADO.NET)

共通のスキーマ コレクションとは、それぞれの .NET Framework マネージ プロバイダーにより実装されるスキーマ コレクションのことです。.NET Framework マネージ プロバイダーでは、引数を指定しないで、またはスキーマ コレクション名に "MetaDataCollections" を指定して GetSchema メソッドを呼び出すことにより、サポートされるスキーマ コレクションの一覧を決定します。これにより、サポートされるスキーマ コレクションの一覧、それぞれがサポートする制限数、および使用する識別子部分の数と共に、DataTable が返されます。これらのコレクションは、必要なすべての列を表現します。プロバイダーでは、任意で列を追加できます。たとえば、SqlClient と OracleClient は、ParameterName を制限のコレクションに追加します。

プロバイダーでは必要な列の値を特定できない場合、null を返します。

GetSchema メソッドの使用に関する詳細については、「GetSchema とスキーマ コレクション (ADO.NET)」を参照してください。

MetaDataCollections

このスキーマ コレクションは、データベースに接続するために現在使用されている、.NET Framework マネージ プロバイダーによりサポートされるすべてのスキーマ コレクションに関する情報を公開します。

列名	データ型	説明
CollectionName	string	コレクションを返すために GetSchema メソッドに渡すコレクションの名前。
NumberOfRestriction	int	コレクションに対して指定できる制限の数。
NumberOfIdentifierParts	int	複合識別子部分とデータベース オブジェクト名部分の数。たとえば、SQL Server の場合は、テーブルに 3 つ、列に 4 つになります。Oracle の場合は、テーブルに 2 つ、列に 3 つになります。

DataSourceInformation

このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続しているデータ ソースに関する情報を公開します。

ColumnName	DataType	説明
CompositeIdentifierSeparatorPattern	string	複合識別子内の複合セパレーターと一致する正規表現。たとえば、"\." (SQL Server の場合) や、"@|\." (Oracle の場合) のように指定します。 複合識別子は、通常、データベース オブジェクト名で使用されます。たとえば、pubs.dbo.authors または pubs@dbo.authors のようになります。 SQL Server の場合、"\." という正規表現を使用します。OracleClient の場合、"@|\." を使用します。 ODBC の場合、Catalog_name_seperator を使用します。 OLE DB の場合、DBLITERAL_CATALOG_SEPARATOR または DBLITERAL_SCHEMA_SEPARATOR を使用します。
DataSourceProductName	string	"Oracle" や "SQLServer" など、プロバイダーによってアクセスされる製品の名前。
DataSourceProductVersion	string	プロバイダーによりアクセスされる製品のバージョンを、Microsoft の形式ではなく、データ ソースのネイティブ形式で表します。 場合によっては、DataSourceProductVersion と DataSourceProductVersionNormalized は同じ値になります。OLE DB と ODBC の場合、これらの値は、元になるネイティブ API 内の同じ関数呼び出しに割り当てられているので、常に同じ値になります。
DataSourceProductVersionNormalized	string	String.Compare() を使用して比較できるような、データ ソースの正規化されたバージョン。この形式は、バージョン 10 がバージョン 1 とバージョン 2 の間に並べ替えられることがないように、プロバイダーのすべてのバージョンで一貫しています。 たとえば、Oracle プロバイダーは、正規化されたバージョンで "nn.nn.nn.nn.nn" という形式を使用します。このため、Oracle 8i データ ソースは、"08.01.07.04.01" を返します。SQL Server では、一般的な Microsoft 形式である "nn.nn.nnnn" を使用します。 場合によっては、DataSourceProductVersion と DataSourceProductVersionNormalized は同じ値になります。OLE DB と ODBC の場合、これらの値は、元になるネイティブ API 内の同じ関数呼び出しに割り当てられているので、常に同じ値になります。
GroupByBehavior	GroupByBehavior	GROUP BY 句の列と SELECT リストの集計以外の列間のリレーションシップを指定します。
IdentifierPattern	string	識別子と一致し、その識別子の一致した値がある正規表現。たとえば "[A-Za-z0-9_#$]" になります。
IdentifierCase	IdentifierCase	引用符で囲まれていない識別子が、大文字と小文字を区別して扱われるかどうかを示します。
OrderByColumnsInSelect	bool	ORDER BY 句の列が SELECT リストになければならないかどうかを示します。値が true である場合、SELECT リストになければならないことを示します。値が false である場合、SELECT リストにある必要がないことを示します。
ParameterMarkerFormat	string	パラメーターを書式設定する方法を表す書式文字列。 名前付きパラメーターがデータ ソースでサポートされている場合、この文字列内の最初のプレースホルダーは、パラメーター名が書式設定される場所である必要があります。 たとえば、データ ソースが名前に ":" というプレフィックスが付いたパラメーターを要求している場合、これは ":{0}" になります。これを "p1" のパラメーター名で書式設定すると、結果の文字列は ":p1" になります。 データ ソースが "@" というプレフィックスが付いたパラメーターを要求しているが、既に名前に含まれている場合、"{0}" になります。"@p1" というパラメーターを書式設定した結果は、単に "@p1" になります。 名前付きパラメーターを要求せず、"?" 文字の使用を要求するデータ ソースの場合、書式文字列は、パラメーター名を無視する "?" として指定できます。OLE DB の場合、"?" を返します。
ParameterMarkerPattern	string	パラメーター マーカーと一致する正規表現。パラメーター名の一致する値になります (一致する値がある場合)。 たとえば、パラメーター名に "@" という前置文字が含まれている、名前付きパラメーターがサポートされている場合、"(@[A-Za-z0-9_$#]*)" となります。 ただし、前置文字として ":" が付いた名前付きパラメーターがサポートされていて、":" がパラメーター名の一部になっていない場合、":([A-Za-z0-9_$#]*)" となります。 もちろん、データ ソースが名前付きパラメーターをサポートしない場合は、単に "?" になります。
ParameterNameMaxLength	int	パラメーター名の文字の最大長。Visual Studio では、パラメーター名がサポートされている場合、最大長の最小値は 30 文字になります。 データ ソースが名前付きパラメーターをサポートしない場合、このプロパティは 0 を返します。
ParameterNamePattern	string	有効なパラメーター名と一致する正規表現。異なるデータ ソースでは、パラメーター名として使用できる文字に関して、規則が異なります。 Visual Studio では、パラメーター名がサポートされている場合、文字 "\p{Lu}\p{Ll}\p{Lt}\p{Lm}\p{Lo}\p{Nl}\p{Nd}" が、パラメーター名として有効な、サポートされる最小限の文字のセットです。
QuotedIdentifierPattern	string	引用符で囲まれた識別子と一致し、引用符を除いた識別子自体の一致する値のある正規表現。たとえば、データ ソースが引用符で囲まれた識別子を識別するために、二重引用符を使用した場合、"(([^\"]|\"\")*)" になります。
QuotedIdentifierCase	IdentifierCase	引用符で囲まれた識別子が、大文字と小文字を区別して扱われるかどうかを示します。
StatementSeparatorPattern	string	ステートメント区切り文字と一致する正規表現。
StringLiteralPattern	string	文字列リテラルと一致し、リテラル自体の一致する値のある正規表現。たとえば、データ ソースが文字列を識別するために単一引用符を使用した場合、"('([^']|'')*')"' になります。
SupportedJoinOperators	SupportedJoinOperators	データ ソースでサポートされる SQL の JOIN ステートメントの種類を指定します。

DataTypes

このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続されているデータベースでサポートされているデータ型に関する情報を公開します。

列名	データ型	説明
TypeName	string	プロバイダー固有のデータ型の名前。
ProviderDbType	int	パラメーターの型を指定するときに使用する必要のある、プロバイダー固有の型の値。たとえば、SqlDbType.Money または OracleType.Blob になります。
ColumnSize	long	数値以外の列またはパラメーターの長さは、最大長か、プロバイダーによりこの型に定義された長さのいずれかを参照します。 文字データの場合、これは、最大長か、データ ソースにより定義されている単位で定義された長さです。Oracle には、長さを指定してから、一部の文字データ型の実際の格納サイズを指定するという概念があります。これは、Oracle の単位で長さのみを定義します。 日時のデータ型の場合、これは (秒の小数部構成要素の最大有効桁数を前提として) 文字列表現の長さです。 データ型が数値である場合、これは、データ型の最大有効桁数の上限です。
CreateFormat	string	CREATE TABLE などのデータ定義ステートメントに、この列を追加する方法を示す書式文字列。CreateParameter 配列の各要素は、書式文字列内で "パラメーター マーカー" で表される必要があります。 たとえば、SQL データ型の DECIMAL には Precision と Scale が必要です。この場合、書式文字列は "DECIMAL({0},{1})" になります。
CreateParameters	string	このデータ型の列を作成する場合に指定する必要のある作成パラメーター。各作成パラメーターは、指定される順序で、コンマで区切られた一覧として文字列内に示されます。 たとえば、SQL データ型の DECIMAL には Precision と Scale が必要です。この場合、作成パラメーターには、"precision, scale" という文字列が含まれる必要があります。 precision を 10、scale を 2 として DECIMAL 列を作成するためのテキスト コマンド内では、CreateFormat 列の値は DECIMAL({0},{1}) になり、完全な型指定は DECIMAL(10,2) になります。
DataType	string	データ型の .NET Framework 型の名前。
IsAutoincrementable	bool	true の場合、このデータ型の値で自動インクリメントが行われます。 false の場合、このデータ型の値で自動インクリメントは行われません。 このデータ型の 1 つの列で自動インクリメントが行われるかどうかを示しているだけであり、この型のすべての列で自動インクリメントが行われるわけではないことに注意してください。
IsBestMatch	bool	true の場合、データ ストア内のすべてのデータ型と、DataType 列の値により指定されている .NET Framework データ型との間で、最も一致するデータ型になります。 false の場合、データ型は、最も一致するデータ型ではありません。 DataType 列の値が同じ行のセットでは、1 行だけで BestMatch 列が true に設定されます。
IsCaseSensitive	bool	true の場合、データ型は文字型であり、大文字と小文字が区別されます。 false の場合、データ型は文字型ではなく、大文字と小文字は区別されません。
IsFixedLength	bool	true の場合、データ定義言語 (DDL) により作成されたこのデータ型の列は、固定長になります。 false の場合、DDL により作成されたこのデータ型の列は、可変長になります。 DBNull.Value の場合、プロバイダーがこのフィールドを固定長の列または可変長の列のどちらで割り当てるかは不明です。
IsFixedPrecisionScale	bool	true の場合、データ型には、固定有効桁数と小数点以下桁数があります。 false の場合、データ型には、固定有効桁数と小数点以下桁数がありません。
IsLong	bool	true の場合、データ型には、非常に長いデータが含まれます。非常に長いデータの定義は、プロバイダーによって異なります。 false の場合、データ型には、非常に長いデータは含まれません。
IsNullable	bool	true の場合、データ型は null に設定できます。 false の場合、データ型は null に設定できません。 DBNull.Value の場合、データ型を null に設定できるかどうかは不明です。
IsSearchable	bool	true の場合、データ型は、LIKE 述語を除く任意の演算子と共に WHERE 句で使用できます。 false の場合、データ型は、LIKE 述語を除く任意の演算子と共に WHERE 句で使用できません。
IsSearchableWithLike	bool	true の場合、データ型は、LIKE 述語と共に使用できます。 false の場合、データ型は、LIKE 述語と共に使用できません。
IsUnsigned	bool	true の場合、データ型は符号なしになります。 false の場合、データ型は符号付きになります。 DBNull.Value の場合、データ型に適用されません。
MaximumScale	short	型インジケーターが数値型である場合、小数点の右側にとることができる最大桁数になります。それ以外の場合は DBNull.Value になります。
MinimumScale	short	型インジケーターが数値型である場合、小数点の右側にとることができる最小桁数になります。それ以外の場合は DBNull.Value になります。
IsConcurrencyType	bool	true の場合、データ型は、行が変更されるたびにデータベースにより更新され、列の値がすべての前の値とは異なります。 false の場合、行が変更されるたびにデータ型がデータベースにより更新されることはありません。 DBNull.Value の場合、データベースでは、この型のデータ型をサポートしません。
IsLiteralsSupported	bool	true の場合、データ型は、リテラルとして表現できます。 false の場合、データ型は、リテラルとして表現できません。
LiteralPrefix	string	指定されたリテラルに適用されるプレフィックス。
LitteralSuffix	string	指定されたリテラルに適用されるサフィックス。
NativeDataType	String	NativeDataType は、データ型の OLE DB 型を公開するための OLE DB 固有の列です。

制限事項

このスキーマ コレクションは、データベースへの接続に現在使用されている、.NET Framework マネージ プロバイダーでサポートされる制限に関する情報を公開します。

列名	データ型	説明
CollectionName	string	これらの制限を適用するコレクションの名前。
RestrictionName	string	コレクション内の制限の名前。
RestrictionDefault	string	無視されます。
RestrictionNumber	int	この特定の制限が収まっているコレクションの制限内の実際の位置。

ReservedWords

このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続されているデータベースにより予約されている予約語に関する情報を公開します。

列名	データ型	説明
ReservedWords	string	プロバイダー固有の予約語。

参照

概念

GetSchema とスキーマ コレクション (ADO.NET)

その他の技術情報

データベース スキーマ情報の取得 (ADO.NET)