SqlDataReader.GetSchemaTable Methode

Definition

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

Gibt eine DataTable zurück, die die Spaltenmetadaten des SqlDataReader 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.

Implementiert

GetSchemaTable()

Ausnahmen

InvalidOperationException

Der SqlDataReader ist geschlossen.

Hinweise

Die GetSchemaTable -Methode gibt die folgenden Metadaten zu jeder Spalte zurück:

DataReader-Spalte	BESCHREIBUNG
AllowDBNull	Legen Sie 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. Andernfalls nicht festgelegt. Eine Spalte kann NULL-Werte enthalten, auch wenn sie nicht auf einen NULL-Wert festgelegt werden kann.
BaseCatalogName	Der Name des Katalogs im Datenspeicher, der die Spalte enthält. NULL, wenn der Name des Basiskatalogs nicht ermittelt werden kann. Der Standardwert dieser Spalte ist ein NULL-Wert.
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 ist, aber nicht mit einer Spalte im Datenspeicher identisch ist. Der Standardwert dieser Spalte ist ein NULL-Wert.
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.
BaseServerName	Der Name des instance von Microsoft SQL Server verwendet.SqlDataReader
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.
ColumnName	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	Die nullbasierte Ordnungszahl der Spalte. Diese Spalte kann keinen NULL-Wert enthalten.
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. Für nvarchar(MAX)Spalten, , varchar(MAX)undvarbinary(MAX), die in einer SQL Server-Datenbank gespeichert sind, beträgt die maximale Größe 2 GB. Wenn diese Spalten als Dateien gespeichert und zugegriffen werden, wird die Maximale Größe vom Dateisystem festgelegt. Dieser Wert ändert sich bei Verwendung des Type System Version Schlüsselwort (keyword) im Verbindungszeichenfolge. Bei neuen Typen werden sie als Downleveltypen dargestellt. Die MAX-Datentypen geben die normalen 4k für nvarchar und 8000 für varcharzurück. Weitere Informationen finden Sie in der Transact-SQL-Referenz.
DataTypeName	Gibt eine Zeichenfolge zurück, die den Datentyp der angegebenen Spalte darstellt.
IsAliased	true: Der Spaltenname ist ein Alias. false: Der Spaltenname ist kein Alias.
IsAutoIncrement	true: Die Spalte weist neuen Zeilen in festen Schritten Werte zu. false: Die Spalte weist neuen Zeilen in festen Schritten keine Werte zu. Der Standardwert für diese Spalte ist false.
IsColumnSet	true: Die Spalte ist eine Sparsespalte, die ein Element eines Spaltensatzes ist.
IsExpression	true: Die Spalte ist ein Ausdruck. false: Die Spalte ist kein Ausdruck.
IsHidden	true: Die Spalte ist ausgeblendet. false: Die Spalte ist nicht ausgeblendet.
IsIdentity	true: Die Spalte ist eine Identitätsspalte. false: Die Spalte ist keine Identitätsspalte.
IsKey	true: Die Spalte ist eine aus einer Reihe von Spalten im Rowset, die die Zeile zusammen eindeutig identifizieren. Die Gruppe der Spalten, bei denen IsKey auf 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. false: Die Spalte ist nicht erforderlich, um die Zeile eindeutig zu identifizieren.
IsLong	true: Die Spalte enthält ein Blob (Binary Long Object), das sehr lange Daten enthält. Die Definition dessen, was als sehr umfangreiche Daten gilt, ist anbieterspezifisch. false: Die Spalte enthält kein Blob (Binary Long Object), das sehr lange Daten enthält.
IsReadOnly	true: Die Spalte kann nicht geändert werden. false: Die Spalte kann geändert werden.
IsRowVersion	true: Die Spalte enthält einen persistenten Zeilenbezeichner, der nicht in geschrieben werden kann, und verfügt über keinen aussagekräftigen Wert außer zum Identifizieren der Zeile. false: Die Spalte enthält keinen persistenten Zeilenbezeichner, in den nicht geschrieben werden kann, und hat keinen aussagekräftigen Wert außer zur Identität der Zeile.
IsUnique	true: Die Spalte hat den Typ timestamp. false: Spalte ist nicht vom Typ timestamp.
NonVersionedProviderType	Der Typ der Spalte unabhängig vom aktuellen Type System Version Wert, der im Verbindungszeichenfolge angegeben ist. Der zurückgegebene Wert stammt aus der SqlDbType Enumeration.
NumericPrecision	Wenn ProviderType es sich um einen numerischen Datentyp handelt, ist dies die maximale Genauigkeit der Spalte. Die Genauigkeit hängt von der Definition der Spalte ab. Wenn ProviderType es sich nicht um einen numerischen Datentyp handelt, ist dies 255.
NumericScale	Wenn ProviderType DBTYPE_DECIMAL oder DBTYPE_NUMERIC ist, die Anzahl der Ziffern rechts neben dem Dezimalzeichen. Andernfalls ist dies 255.
ProviderSpecificDataType	Gibt den anbieterspezifischen Datentyp der Spalte basierend auf dem Type System Version Schlüsselwort (keyword) im Verbindungszeichenfolge zurück.
ProviderType	Der Zähler des Datentyps der Spalte. Wenn der Datentyp der Spalte von Zeile zu Zeile variiert, muss dies Object sein. Diese Spalte kann keinen NULL-Wert enthalten.
UdtAssemblyQualifiedName	Wenn es sich bei der Spalte um einen benutzerdefinierten Typ (UDT) handelt, ist dies der qualifizierte Name der UDT-Assembly gemäß AssemblyQualifiedName. Wenn die Spalte kein UDT ist, ist dies NULL.
XmlSchemaCollectionDatabase	Der Name der Datenbank, in der sich die Schemaauflistung für diese XML-instance befindet, wenn die Zeile Informationen zu einer XML-Spalte enthält. Dieser Wert ist null (Nothing in Visual Basic), wenn die Auflistung in der aktuellen Datenbank definiert ist. Es ist auch NULL, wenn keine Schemaauflistung vorhanden ist. In diesem Fall sind die XmlSchemaCollectionName Spalten und XmlSchemaCollectionOwningSchema ebenfalls NULL.
Xmlschemacollectionname	Der Name der Schemaauflistung für diese XML-instance, wenn die Zeile Informationen zu einer XML-Spalte enthält. Dieser Wert ist null (Nothing in Visual Basic), wenn keine zugeordnete Schemaauflistung vorhanden ist. Wenn der Wert NULL ist, sind die XmlSchemaCollectionDatabase Spalten und XmlSchemaCollectionOwningSchema ebenfalls NULL.
XmlSchemaCollectionOwningSchema	Das relationale Schema, in dem sich die Schemaauflistung für diese XML-instance befindet, wenn die Zeile Informationen zu einer XML-Spalte enthält. Dieser Wert ist null (Nothing in Visual Basic), wenn die Auflistung in der aktuellen Datenbank definiert ist. Es ist auch NULL, wenn keine Schemaauflistung vorhanden ist. In diesem Fall sind die XmlSchemaCollectionDatabase Spalten und XmlSchemaCollectionName ebenfalls NULL.

Hinweis

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

Weitere Informationen

• Übersicht über ADO.NET