SqlCeDataReader.GetSchemaTable-Methode

Gibt eine DataTable-Klasse zurück, die die Spaltenmetadaten der SqlCeDataReader-Klasse beschreibt.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Overrides Function GetSchemaTable As DataTable
'Usage
Dim instance As SqlCeDataReader
Dim returnValue As DataTable

returnValue = instance.GetSchemaTable

public override DataTable GetSchemaTable ()

public:
virtual DataTable^ GetSchemaTable () override

public DataTable GetSchemaTable ()

public override function GetSchemaTable () : DataTable

Rückgabewert

Eine DataTable-Klasse, die die Spaltenmetadaten beschreibt.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die Operation ist ungültig. Die SqlCeDataReader-Klasse ist möglicherweise hinter der letzten Zeile im Resultset positioniert.

Hinweise

Wenn SqlCeDataReader Spalten aus mehr als einer Basistabelle liest, füllt SqlCeDataReader die Schematabelle nicht mit IsKey-Werten. Dieses Verhalten ist dem Verhalten bei SELECT-Abfragen ähnlich:

SELECT FirstName, LastName, 1+2 FROM Employees  

Die Abfrage liest Spalten aus zwei verschiedenen Tabellen, der Employees-Tabelle in der Northwind-Datenbank und der temporären Tabelle, die für 1+2 erstellt wurde.

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

Schema Tabelle Spalte	Beschreibung
ColumnName	Der Name der Spalte. Dieser Name ist u. U. nicht eindeutig. Wenn der Name nicht bestimmt werden kann, wird ein NULL (Nothing in Visual Basic)-Wert zurückgegeben. Dieser Name stellt immer die aktuellste Benennung der Spalte in der aktuellen Sicht oder im Befehlstext dar.
ColumnOrdinal	Die Ordnungszahl der Spalte. Die Ordinalzahl beginnt mit 0 (null). SQL Server Mobile unterstützt keine Lesezeichen.
ColumnSize	Die maximal mögliche Länge eines Werts in der Spalte. Bei Spalten, die einen Datentyp mit fester Länge verwenden, ist die maximale Länge die Größe des Datentyps.
NumericPrecision	Die maximale Genauigkeit der Spalte, wenn ProviderType ein numerischer Datentyp ist. Die Genauigkeit ist von der Definition der Spalte abhängig. Ein NULL (Nothing in Visual Basic)-Wert, wenn ProviderType kein numerischer Datentyp ist.
NumericScale	Wenn ProviderType DBTYPE_DECIMAL oder DBTYPE_NUMERIC ist, ist dies die Anzahl der Ziffern rechts vom Dezimaltrennzeichen. Andernfalls ist dies ein NULL (Nothing in Visual Basic)-Wert.
IsUnique	Wenn true, dann ist es nicht möglich, dass zwei Zeilen in dieser Spalte der Basistabelle (d. h. der als BaseTableName zurückgegebenen Tabelle) denselben Wert aufweisen. IsUnique ist immer true, wenn die Spalte selbst einen Schlüssel darstellt oder eine Einschränkung vom Typ UNIQUE ausschließlich auf diese Spalte angewendet wird. Wenn false, dann kann die Spalte doppelte Werte in der Basistabelle enthalten. Der Standardwert dieser Spalte ist false.
IsKey	Wenn true, dann gehört die Spalte zu einem Satz von Spalten im Rowset, die zusammen die Zeile eindeutig bezeichnen. Der Satz von Spalten, bei denen IsKey auf true festgelegt ist, muss eine Zeile im Rowset eindeutig bezeichnen. Es gibt für diesen Satz von Spalten keine Anforderung für einen Mindestsatz von Spalten. Dieser Satz von Spalten kann aus dem Primärschlüssel der Basistabelle, einer Unique-Einschränkung oder einem eindeutigen Index generiert werden. Wenn false, dann ist die Spalte für die eindeutige Bezeichnung der Zeile nicht erforderlich.
BaseColumnName	Der Name der Spalte im Datenspeicher. Der Name ist ein NULL (Nothing in Visual Basic)-Wert, wenn der Name der Basisspalte nicht bestimmt werden kann oder wenn die Rowset-Spalte zwar von einer Spalte im Datenspeicher abgeleitet wurde, aber nicht mit ihr identisch ist. Der Standardwert dieser Spalte ist NULL (Nothing in Visual Basic).
BaseTableName	Der Name der Tabelle im Datenspeicher, die die Spalte enthält. Der Name ist ein NULL (Nothing in Visual Basic)-Wert, wenn der Name der Basistabelle nicht bestimmt werden kann. Der Standardwert dieser Spalte ist NULL (Nothing in Visual Basic).
DataType	Wird dem .NET Framework-Typ der Spalte zugeordnet
AllowDBNull	Wird festgelegt, wenn der Consumer die Spalte auf einen NULL (Nothing in Visual Basic)-Wert festlegen kann oder wenn der Anbieter nicht bestimmen kann, ob der Consumer die Spalte auf einen NULL (Nothing in Visual Basic)-Wert festlegen kann. Wird andernfalls nicht festgelegt. Eine Spalte kann auch dann NULL (Nothing in Visual Basic)-Werte enthalten, wenn sie eigentlich nicht auf einen NULL (Nothing in Visual Basic)-Wert festgelegt werden kann.
ProviderType	Der Indikator des Datentyps der Spalte. Diese Spalte darf keinen NULL-Wert enthalten.
IsAutoIncrement	Wenn true, weist die Spalte neuen Zeilen Werte zu, die in feststehenden Schritten erhöht werden. Wenn false, weist die Spalte weist neuen Zeilen keine Werte zu, die in feststehenden Schritten erhöht werden. Der Standardwert dieser Spalte ist false.
IsRowVersion	Wird festgelegt, wenn die Spalte einen persistenten Zeilenbezeichner enthält, in den nicht geschrieben werden kann und dessen Wert nur zum Bezeichnen der Zeile sinnvoll ist.
IsLong	Wird festgelegt, wenn die Spalte ein BLOB (Binary Large Object) mit sehr umfangreichen Daten enthält.
IsReadOnly	Wenn true, kann die Spalte geändert werden. Wenn false, kann die Spalte nicht geändert werden.

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlCeDataReader-Klasse
SqlCeDataReader-Member
System.Data.SqlServerCe-Namespace