DataAdapter.FillSchema Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Hozzáad egy értéket DataTable a megadotthoz DataSet.

Túlterhelések

Name	Description
FillSchema(DataSet, SchemaType, String, IDataReader)	Hozzáad egy értéket DataTable a megadotthoz DataSet.
FillSchema(DataSet, SchemaType)	Hozzáad egy értéket DataTable a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásnak a megadott SchemaTypealapján.
FillSchema(DataTable, SchemaType, IDataReader)	Hozzáad egy értéket DataTable a megadotthoz DataSet.

FillSchema(DataSet, SchemaType, String, IDataReader)

Forrás:

DataAdapter.cs

Hozzáad egy értéket DataTable a megadotthoz DataSet.

protected:
 virtual cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType, System::String ^ srcTable, System::Data::IDataReader ^ dataReader);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("dataReader's schema table types cannot be statically analyzed.")]
protected virtual System.Data.DataTable[] FillSchema(System.Data.DataSet dataSet, System.Data.SchemaType schemaType, string srcTable, System.Data.IDataReader dataReader);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("dataReader's schema table types cannot be statically analyzed.")>]
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType * string * System.Data.IDataReader -> System.Data.DataTable[]
override this.FillSchema : System.Data.DataSet * System.Data.SchemaType * string * System.Data.IDataReader -> System.Data.DataTable[]

Protected Overridable Function FillSchema (dataSet As DataSet, schemaType As SchemaType, srcTable As String, dataReader As IDataReader) As DataTable()

Paraméterek

dataSet

DataSet

A DataTable kitöltendő IDataReader.

schemaType

SchemaType

Az egyik SchemaType érték.

srcTable

String

A táblaleképezéshez használandó forrástábla neve.

dataReader

IDataReader

Az IDataReader adatforrásként használandó a kitöltéskor DataTable.

Válaszok

DataTable[]

Hivatkozás a .-hoz DataTable hozzáadott objektumok gyűjteményére DataSet.

Attribútumok

RequiresUnreferencedCodeAttribute

Lásd még

• ADO.NET áttekintése

FillSchema(DataSet, SchemaType)

Forrás:

DataAdapter.cs

Hozzáad egy értéket DataTable a megadotthoz DataSet , és úgy konfigurálja a sémát, hogy az megfeleljen az adatforrásnak a megadott SchemaTypealapján.

public:
 virtual cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public virtual System.Data.DataTable[] FillSchema(System.Data.DataSet dataSet, System.Data.SchemaType schemaType);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]
override this.FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]

Public Overridable Function FillSchema (dataSet As DataSet, schemaType As SchemaType) As DataTable()

Paraméterek

dataSet

DataSet

Az DataSet adatforrás sémájával kitöltendő.

schemaType

SchemaType

Az egyik SchemaType érték.

Válaszok

DataTable[]

Az DataTable adatforrásból visszaadott sémaadatokat tartalmazó objektum.

Megvalósítás

FillSchema(DataSet, SchemaType)

Attribútumok

RequiresUnreferencedCodeAttribute

Megjegyzések

A FillSchema metódus lekéri a sémát az adatforrásból a SelectCommand. A kapcsolati objektumnak SelectCommand érvényesnek kell lennie, de nem kell megnyitnia. Ha a kapcsolat a hívás előtt FillSchema le van zárva, megnyílik az adatok lekéréséhez, majd bezárul. Ha a kapcsolat még a hívás előtt FillSchema meg van nyitva, az nyitva marad.

Egy FillSchema művelet hozzáad egy DataTable elemet a célhelyhez DataSet. Ezután oszlopokat ad hozzá a DataColumnCollectionDataTablefájlhoz, és konfigurálja a következő DataColumn tulajdonságokat, ha az adatforrásban léteznek:

• AllowDBNull

• AutoIncrement. Be kell állítania és AutoIncrementStep külön kell beállítaniaAutoIncrementSeed.

• MaxLength

• ReadOnly

• Unique

FillSchema emellett az alábbi szabályok szerint konfigurálja a PrimaryKeyConstraints tulajdonságokat és a tulajdonságokat:

• Ha egy vagy több elsődleges kulcsoszlopot ad vissza a SelectCommandrendszer, azokat a rendszer a rendszer elsődleges kulcsoszlopaként használja.DataTable

• Ha a rendszer nem ad vissza elsődleges kulcsoszlopokat, de egyedi oszlopokat, akkor az egyedi oszlopokat használja elsődleges kulcsként, ha és csak akkor, ha az összes egyedi oszlop nemnullálható. Ha bármelyik oszlop null értékű, a rendszer hozzáad egy UniqueConstraint értéket a ConstraintCollection, de a PrimaryKey tulajdonság nincs beállítva.

• Ha az elsődleges kulcsoszlopokat és az egyedi oszlopokat is visszaadja, a rendszer az elsődleges kulcsoszlopokat használja elsődleges kulcsoszlopként a DataTable.

Note

A mögöttes adattár lehetővé teheti az olyan oszlopattribútumok engedélyezését, amelyek nem támogatottak egy DataColumnoszlopattribútumban, ami miatt egyes oszlopattribútumok fordítása nem megfelelő. A SQL Server például lehetővé teszi, hogy a kis méretű adattípusú identitásoszlopok, míg egy DataColumn csak az Int16, az Int32 és az Int64 számára engedélyezi a AutoIncrement tulajdonságkészletet. FillSchema csendben figyelmen kívül hagyja azokat az eseteket, amikor a DataColumn rendszer nem tudja pontosan tükrözni az adatforrást, és kivételt nem vet fel.

Vegye figyelembe, hogy az elsődleges kulcsok és az egyedi korlátozások az ConstraintCollection előző szabályok szerint vannak hozzáadva, de más kényszertípusok nem lesznek hozzáadva.

Ha egy egyedi fürtözött index egy SQL Server tábla oszlopán vagy oszlopán van definiálva, és az elsődleges kulcsra vonatkozó korlátozás külön oszlopkészleten van meghatározva, akkor a rendszer visszaadja a fürtözött index oszlopainak nevét. Az elsődleges kulcsoszlopok nevének vagy nevének visszaadásához használjon lekérdezési tippet az elsődleges kulcsindex nevét meghatározó SELECT utasítással. További információ a lekérdezési tippek megadásáról: Hiba (Transact-SQL) – Lekérdezés.

Ha a DataAdapter rendszer ismétlődő oszlopokkal találkozik egy DataTableelőugró ablak feltöltése során, az "oszlopnév1", "columnname2", "columnname3" stb. mintával létrehozza a következő oszlopok nevét. Ha a bejövő adatok névtelen oszlopokat tartalmaznak, a rendszer az DataSet "Oszlop1", "Oszlop2" stb. minta szerint helyezi el őket. Ha több eredményhalmazt ad hozzá az DataSet egyes eredménykészletekhez, a rendszer egy külön táblába helyezi. A további eredményhalmazok neve úgy van elnevezve, hogy az integrálértékeket hozzáfűzi a megadott táblanévhez (például "Táblázat", "Table1", "Table2" stb.). Az oszlop- és táblaneveket használó alkalmazásoknak gondoskodniuk kell arról, hogy ne forduljanak elő ütközések ezekkel az elnevezési mintákkal.

FillSchema nem ad vissza sorokat. Fill A metódussal sorokat adhat hozzá egy DataTable.

Note

Több eredményt adó kötegelt SQL-utasítások kezelésekor az OLE DB-hez készült .NET-keretrendszer Data Provider FillSchema implementációja csak az első eredmény sémaadatait kéri le. Ha több találat sémaadatait szeretné lekérniFill, használja MissingSchemaAction a AddWithKey következőt: .

Lásd még

• Fill(DataSet)
• ADO.NET áttekintése

FillSchema(DataTable, SchemaType, IDataReader)

Forrás:

DataAdapter.cs

Hozzáad egy értéket DataTable a megadotthoz DataSet.

protected:
 virtual System::Data::DataTable ^ FillSchema(System::Data::DataTable ^ dataTable, System::Data::SchemaType schemaType, System::Data::IDataReader ^ dataReader);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("dataReader's schema table types cannot be statically analyzed.")]
protected virtual System.Data.DataTable? FillSchema(System.Data.DataTable dataTable, System.Data.SchemaType schemaType, System.Data.IDataReader dataReader);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("dataReader's schema table types cannot be statically analyzed.")>]
abstract member FillSchema : System.Data.DataTable * System.Data.SchemaType * System.Data.IDataReader -> System.Data.DataTable
override this.FillSchema : System.Data.DataTable * System.Data.SchemaType * System.Data.IDataReader -> System.Data.DataTable

Protected Overridable Function FillSchema (dataTable As DataTable, schemaType As SchemaType, dataReader As IDataReader) As DataTable

Paraméterek

dataTable

DataTable

A DataTable kitöltendő IDataReader.

schemaType

SchemaType

Az egyik SchemaType érték.

dataReader

IDataReader

Az IDataReader adatforrásként használandó a kitöltéskor DataTable.

Válaszok

DataTable

Az DataTable adatforrásból visszaadott sémaadatokat tartalmazó objektum.

Attribútumok

RequiresUnreferencedCodeAttribute

Lásd még

• ADO.NET áttekintése