Freigeben über

IDataAdapter.FillSchema-Methode

  • Artikel

Fügt dem angegebenen DataSet eine DataTable mit dem Namen "Table" hinzu und konfiguriert das Schema anhand des angegebenen SchemaType so, dass es dem Schema in der Datenquelle entspricht.

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

Syntax

'Declaration
Function FillSchema ( _
    dataSet As DataSet, _
    schemaType As SchemaType _
) As DataTable()
'Usage
Dim instance As IDataAdapter
Dim dataSet As DataSet
Dim schemaType As SchemaType
Dim returnValue As DataTable()

returnValue = instance.FillSchema(dataSet, schemaType)

DataTable[] FillSchema (
    DataSet dataSet,
    SchemaType schemaType
)

array<DataTable^>^ FillSchema (
    DataSet^ dataSet, 
    SchemaType schemaType
)

DataTable[] FillSchema (
    DataSet dataSet, 
    SchemaType schemaType
)

function FillSchema (
    dataSet : DataSet, 
    schemaType : SchemaType
) : DataTable[]

Parameter

  • dataSet
    Die mit dem Schema aus der Datenquelle zu füllende DataSet.

Rückgabewert

Ein Array von DataTable-Objekten, die aus der Datenquelle zurückgegebene Schemainformationen enthalten.

Hinweise

Die FillSchema-Methode ruft das Schema mithilfe des SelectCommand aus der Datenquelle ab. Das dem SelectCommand zugeordnete Verbindungsobjekt muss gültig, jedoch nicht geöffnet sein. Wenn die Verbindung vor dem Aufruf von FillSchema geschlossen ist, wird sie zum Abrufen der Daten geöffnet und anschließend geschlossen. Wenn die Verbindung vor dem Aufruf von FillSchema geöffnet ist, bleibt sie weiterhin geöffnet.

Eine FillSchema-Operation fügt dem Ziel-DataSet eine DataTable hinzu. Anschließend werden der DataColumnCollection der DataTable Spalten hinzugefügt, und die folgenden DataColumn-Eigenschaften werden konfiguriert, sofern sie in der Datenquelle vorhanden sind:

FillSchema konfiguriert außerdem die PrimaryKey-Eigenschaft und die Constraints-Eigenschaft entsprechend den folgenden Regeln:

  • Wenn durch den SelectCommand ein oder mehrere Primärschlüsselspalten zurückgegeben werden, werden sie als Primärschlüsselspalten für die DataTable verwendet.

  • Wenn keine Primärschlüsselspalten, aber eindeutige Spalten zurückgegeben werden, werden die eindeutigen Spalten als Primärschlüssel verwendet, aber nur dann, wenn keine dieser eindeutigen Spalten NULL-Werte zulässt. Wenn eine der Spalten NULL-Werte enthalten kann, wird der ConstraintCollection eine UniqueConstraint hinzugefügt, aber die PrimaryKey-Eigenschaft wird nicht festgelegt.

  • Wenn sowohl Primärschlüsselspalten als auch eindeutige Spalten zurückgegeben werden, werden die Primärschlüsselspalten als Primärschlüsselspalten für die DataTable verwendet.

Beachten Sie, dass ConstraintCollection zwar Primärschlüssel und Unique-Einschränkungen entsprechend der oben genannten Regeln, andere Einschränkungstypen jedoch nicht hinzugefügt werden.

Wenn der IDataAdapter beim Füllen einer DataTable mehrfach vorhandene Spalten findet, generiert er für die jeweils folgenden Spalten Namen nach dem Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden diese im DataSet entsprechend dem Muster "Spalte1", "Spalte2" usw. eingefügt. Wenn dem DataSet mehrere Resultsets hinzugefügt werden, wird jedes Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem dem angegebenen Tabellennamen ganzzahlige Werte angefügt werden (z. B. "Tabelle", "Tabelle1", "Tabelle2" usw.). Beim Verwenden von Spalten- und Tabellennamen in Anwendungen muss darauf geachtet werden, dass keine Konflikte mit diesen Benennungsmustern auftreten.

FillSchema gibt keine Zeilen zurück. Verwenden Sie die Fill-Methode, um einer DataTable Zeilen hinzuzufügen.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDataAdapter-Schnittstelle
IDataAdapter-Member
System.Data-Namespace
Fill