OleDbDataReader.GetSchemaTable Methode

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-rc.2.24473.5

Quelle:

OleDbDataReader.cs

Gibt eine DataTable zurück, die die Spaltenmetadaten des OleDbDataReader beschreibt.

public:
 override System::Data::DataTable ^ GetSchemaTable();

public override System.Data.DataTable? GetSchemaTable ();

override this.GetSchemaTable : unit -> System.Data.DataTable

Public Overrides Function GetSchemaTable () As DataTable

Gibt zurück

DataTable

Eine DataTable, die die Spaltenmetadaten beschreibt.

Ausnahmen

InvalidOperationException

Der OleDbDataReader ist geschlossen.

Hinweise

Die GetSchemaTable -Methode wird der OLE DB-Methode IColumnsRowset::GetColumnsRowset zugeordnet und gibt Metadaten zu jeder Spalte in der folgenden Reihenfolge zurück:

DataReader-Spalte	OLE DB-Spalten-ID	BESCHREIBUNG
ColumnName	DBCOLUMN_NAME	Der Name der Spalte; Dies ist möglicherweise nicht eindeutig. Wenn sie nicht bestimmt werden kann, wird ein NULL-Wert zurückgegeben. Dieser Name gibt den aktuellen Stand der Umbenennung der Spalte im aktuellen Ansichts- oder Befehlstext wieder.
ColumnOrdinal	DBCOLUMN_NUMBER	Die nullbasierte Ordnungszahl der Spalte. Diese Spalte kann keinen NULL-Wert enthalten.
ColumnSize	DBCOLUMN_COLUMNSIZE	Die maximal mögliche Länge eines Werts in der Spalte. Für Spalten, die einen Datentyp mit fester Länge verwenden, ist dies die Größe des Datentyps.
NumericPrecision	DBCOLUMN_PRECISION	Wenn DbType ein numerischer Datentyp ist, ist dies die maximale Genauigkeit der Spalte. Die Genauigkeit von Spalten mit dem Datentyp DBTYPE_DECIMAL oder DBTYPE_NUMERIC hängt von der Definition der Spalte ab. Wenn DbType kein numerischer Datentyp ist, ist dies ein NULL-Wert.
NumericScale	DBCOLUMN_SCALE	Wenn DbType DBTYPE_DECIMAL oder DBTYPE_NUMERIC ist, ist dies die Anzahl der Ziffern rechts neben dem Dezimaltrennzeichen. Andernfalls ist dies ein NULL-Wert.
DataType	Keine	Wird dem .NET Framework Typ der Spalte zugeordnet.
ProviderType	DBCOLUMN_TYPE	Der Zähler des Datentyps der Spalte. Wenn der Datentyp der Spalte von Zeile zu Zeile variiert, muss dies DBTYPE_VARIANT sein. Diese Spalte kann keinen NULL-Wert enthalten.
IsLong	DBCOLUMNFLAGS_ISLONG	Der Anbieter legt DBCOLUMNFLAGS_ISLONG fest, wenn die Spalte ein Binary Long Object (BLOB) enthält, das sehr lange Daten enthält. Die Definition dessen, was als sehr umfangreiche Daten gilt, ist anbieterspezifisch. Die Einstellung dieses Flags entspricht dem Wert der IS_LONG Spalte im PROVIDER_TYPES Rowset für den Datentyp.
AllowDBNull	DBCOLUMNFLAGS_ISNULLABLE	Der Anbieter legt DBCOLUMNFLAGS_ISNULLABLE fest, ob der Consumer die Spalte auf einen NULL-Wert festlegen kann oder ob der Anbieter nicht ermitteln kann, ob der Consumer die Spalte auf einen NULL-Wert festlegen kann. Eine Spalte kann NULL-Werte enthalten, auch wenn sie nicht auf einen NULL-Wert festgelegt werden kann.
IsReadOnly	DBCOLUMNFLAGS_WRITE	true , wenn die Spalte nicht geändert werden kann; andernfalls false. Die Spalte wird als schreibbar angenommen, wenn der Anbieter entweder das DBCOLUMNFLAGS_WRITE- oder DBCOLUMNFLAGS_WRITEUNKNOWN-Flag festgelegt hat.
IsRowVersion	DBCOLUMNFLAGS_ISROWID	Der Anbieter legt DBCOLUMNFLAGS_ISROWID fest, wenn die Spalte einen persistenten Zeilenbezeichner enthält, in den nicht geschrieben werden kann, und keinen aussagekräftigen Wert außer zur Identität der Zeile hat.
IsUnique	DBCOLUMN_ISUNIQUE	VARIANT_TRUE: In dieser Spalte können keine zwei Zeilen in der Basistabelle , die in BaseTableName zurückgegebene Tabelle, denselben Wert aufweisen. IsUnique wird garantiert VARIANT_TRUE, wenn die Spalte selbst einen Schlüssel darstellt oder wenn eine Einschränkung vom Typ UNIQUE vorhanden ist, die nur für diese Spalte gilt. VARIANT_FALSE: Die Spalte kann doppelte Werte in der Basistabelle enthalten. Der Standardwert dieser Spalte ist VARIANT_FALSE.
IsKey	DBCOLUMN_KEYCOLUMN	VARIANT_TRUE: Die Spalte ist eine aus einer Reihe von Spalten im Rowset, die zusammen die Zeile eindeutig identifizieren. Der Spaltensatz, für den IsKey auf VARIANT_TRUE festgelegt ist, muss eine Zeile im Rowset eindeutig identifizieren. Es ist nicht erforderlich, dass es sich bei dieser Menge Spalten um eine minimale Spaltenmenge handelt. Diese Spaltenmenge kann aus einem Primärschlüssel der Basistabelle, einer eindeutigen Bedingung oder einem eindeutigen Index gebildet werden. VARIANT_FALSE: Die Spalte ist nicht erforderlich, um die Zeile eindeutig zu identifizieren.
IsAutoIncrement	DBCOLUMN_ISAUTOINCREMENT	VARIANT_TRUE: Die Spalte weist neuen Zeilen werte in festen Schritten zu. VARIANT_FALSE: Die Spalte weist neuen Zeilen in festen Schritten keine Werte zu. Der Standardwert dieser Spalte ist VARIANT_FALSE.
BaseSchemaName	DBCOLUMN_BASESCHEMANAME	Der Name des Schemas im Datenspeicher, das die Spalte enthält. Ein NULL-Wert, wenn der Name des Basisschemas nicht bestimmt werden kann. Der Standardwert dieser Spalte ist ein NULL-Wert.
BaseCatalogName	DBCOLUMN_BASECATALOGNAME	Der Name des Katalogs im Datenspeicher, der die Spalte enthält. Ein NULL-Wert, wenn der Name des Basiskatalogs nicht bestimmt werden kann. Der Standardwert dieser Spalte ist ein NULL-Wert.
BaseTableName	DBCOLUMN_BASETABLENAME	Der Name der Tabelle oder Ansicht im Datenspeicher, die die Spalte enthält. Ein NULL-Wert, wenn der Name der Basistabelle nicht bestimmt werden kann. Der Standardwert dieser Spalte ist ein NULL-Wert.
BaseColumnName	DBCOLUMN_BASECOLUMNNAME	Der Name der Spalte im Datenspeicher. Dies kann sich von dem Spaltennamen unterscheiden, der in der Spalte ColumnName zurückgegeben wird, wenn ein Alias verwendet wurde. Ein NULL-Wert, wenn der Name der Basisspalte nicht bestimmt werden kann oder wenn die Rowsetspalte abgeleitet, aber nicht identisch mit einer Spalte im Datenspeicher ist. Der Standardwert dieser Spalte ist ein NULL-Wert.

Hinweis

Um sicherzustellen, dass Metadatenspalten die richtigen Informationen zurückgeben, müssen Sie aufrufen ExecuteReader , wobei der behavior Parameter auf KeyInfofestgelegt ist. Andernfalls geben einige Spalten in der Schematabelle möglicherweise standard-, NULL- oder falsche Daten zurück.

Weitere Informationen

• "DataAdapters" und "DataReaders"