SqlDataReader.GetSchemaTable Metoda

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.dll
Sestavení:
System.Data.SqlClient.dll
Balíček:
System.Data.SqlClient v4.8.6

Vrátí hodnotu DataTable , která popisuje metadata sloupce objektu SqlDataReader.

public:
 virtual System::Data::DataTable ^ GetSchemaTable();
public:
 override System::Data::DataTable ^ GetSchemaTable();
public System.Data.DataTable GetSchemaTable ();
public override System.Data.DataTable GetSchemaTable ();
abstract member GetSchemaTable : unit -> System.Data.DataTable
override this.GetSchemaTable : unit -> System.Data.DataTable
override this.GetSchemaTable : unit -> System.Data.DataTable
Public Function GetSchemaTable () As DataTable
Public Overrides Function GetSchemaTable () As DataTable

Návraty

DataTable

A DataTable , který popisuje metadata sloupce.

Implementuje

GetSchemaTable()

Výjimky

InvalidOperationException

Je SqlDataReader zavřený.

Poznámky

Metoda GetSchemaTable vrátí následující metadata o každém sloupci:

Sloupec DataReader Description
Allowdbnull Nastavte, jestli příjemce může nastavit sloupec na hodnotu null, nebo pokud zprostředkovatel nemůže určit, jestli příjemce může nastavit sloupec na hodnotu null. V opačném případě není nastaveno. Sloupec může obsahovat hodnoty null, i když ho nelze nastavit na hodnotu null.
BaseCatalogName Název katalogu v úložišti dat, které obsahuje sloupec. HODNOTA NULL, pokud nelze určit název základního katalogu. Výchozí hodnota tohoto sloupce je null.
BaseColumnName Název sloupce v úložišti dat. To se může lišit od názvu sloupce vráceného ve sloupci ColumnName, pokud byl použit alias. Hodnota null, pokud nelze určit název základního sloupce nebo pokud je sloupec sady řádků odvozen, ale není identický se sloupcem v úložišti dat. Výchozí hodnota tohoto sloupce je null.
BaseSchemaName Název schématu v úložišti dat, které obsahuje sloupec. Hodnota null, pokud nelze určit název základního schématu. Výchozí hodnota tohoto sloupce je null.
BaseServerName Název instance microsoftu SQL Server používá SqlDataReader.
BaseTableName Název tabulky nebo zobrazení v úložišti dat, které obsahuje sloupec. Hodnota null, pokud nelze určit název základní tabulky. Výchozí hodnota tohoto sloupce je null.
ColumnName Název sloupce; to nemusí být jedinečné. Pokud to nelze určit, vrátí se hodnota null. Tento název vždy odráží poslední přejmenování sloupce v aktuálním zobrazení nebo textu příkazu.
ColumnOrdinal Pořadová řada sloupce založená na nule. Tento sloupec nesmí obsahovat hodnotu null.
Columnsize Maximální možná délka hodnoty ve sloupci. U sloupců, které používají datový typ s pevnou délkou, se jedná o velikost datového typu. U nvarchar(MAX)sloupců , varchar(MAX)a varbinary(MAX) uložených v databázi SQL Server je maximální velikost 2 GB. Pokud jsou tyto sloupce uložené a přístupné jako soubory, je limit maximální velikosti stanoven systémem souborů. Tato hodnota se změní při použití klíčového Type System Version slova v připojovací řetězec. U nových typů jsou reprezentovány jako typy nižší úrovně. Datové typy MAX vrátí normální hodnotu 4k pro nvarchar a 8000 pro varchar. Další informace najdete v referenčních informacích k jazyku Transact-SQL.
Název datového typu Vrátí řetězec představující datový typ zadaného sloupce.
IsAliased true: Název sloupce je alias.

false: Název sloupce není alias.
IsAutoIncrement true: Sloupec přiřazuje hodnoty novým řádkům v pevných přírůstcích.

false: Sloupec nepřiřazuje hodnoty novým řádkům v pevných přírůstcích. Výchozí hodnota tohoto sloupce je false.
IsColumnSet true: Sloupec je řídký sloupec, který je členem sady sloupců.
IsExpression true: Sloupec je výraz.

false: Sloupec není výraz.
IsHidden true: Sloupec je skrytý.

false: Sloupec není skrytý.
IsIdentity true: Sloupec je sloupec identity.

false: Sloupec není sloupec identity.
Iskey true: Sloupec je jedním ze sady sloupců v sadě řádků, které společně jednoznačně identifikují řádek. Sada sloupců s nastavenou IsKey na true musí jednoznačně identifikovat řádek v sadě řádků. Není nutné, aby tato sada sloupců byla minimální sadou sloupců. Tato sada sloupců může být generována z primárního klíče základní tabulky, jedinečného omezení nebo jedinečného indexu.

false: Sloupec není nutný k jednoznačné identifikaci řádku.
IsLong true: Sloupec obsahuje objekt BLOB (Binary Long Object), který obsahuje velmi dlouhá data. Definice velmi dlouhých dat je specifická pro zprostředkovatele.

false: Sloupec neobsahuje objekt BLOB (Binary Long Object), který obsahuje velmi dlouhá data.
IsReadOnly true: Sloupec nelze změnit.

false: Sloupec je možné upravit.
IsRowVersion true: Sloupec obsahuje trvalý identifikátor řádku, do kterého nelze zapisovat a nemá žádnou smysluplnou hodnotu kromě identity řádku.

false: Sloupec neobsahuje trvalý identifikátor řádku, do kterého nelze zapisovat, a nemá žádnou smysluplnou hodnotu s výjimkou identity řádku.
Isunique true: Sloupec je typu timestamp.

false: Sloupec není typu timestamp.
NonVersionedProviderType Typ sloupce bez ohledu na proud Type System Version zadaný v připojovací řetězec. Vrácená hodnota je z výčtu SqlDbType .
NumericPrecision Pokud ProviderType se jedná o číselný datový typ, jedná se o maximální přesnost sloupce. Přesnost závisí na definici sloupce. Pokud ProviderType se nejedná o číselný datový typ, jedná se o hodnotu 255.
NumericScale Pokud ProviderType je DBTYPE_DECIMAL nebo DBTYPE_NUMERIC, počet číslic napravo od desetinné čárky. Jinak je to 255.
ProviderSpecificDataType Vrátí datový typ sloupce specifický pro zprostředkovatele na základě klíčového Type System Version slova v připojovací řetězec.
Providertype Indikátor datového typu sloupce. Pokud se datový typ sloupce liší v jednotlivých řádcích, musí to být Objekt. Tento sloupec nesmí obsahovat hodnotu null.
UdtAssemblyQualifiedName Pokud je sloupec uživatelem definovaný typ (UDT), jedná se o kvalifikovaný název sestavení UDT podle .AssemblyQualifiedName Pokud sloupec není UDT, má hodnotu null.
Xmlschemacollectiondatabase Název databáze, ve které se nachází kolekce schémat pro tuto instanci XML, pokud řádek obsahuje informace o sloupci XML. Tato hodnota je null (Nothing v jazyce Visual Basic), pokud je kolekce definovaná v rámci aktuální databáze. Je také null, pokud neexistuje žádná kolekce schémat. V takovém případě XmlSchemaCollectionName jsou sloupce a XmlSchemaCollectionOwningSchema také null.
Xmlschemacollectionname Název kolekce schémat pro tuto instanci XML, pokud řádek obsahuje informace o sloupci XML. Tato hodnota je null (Nothing v jazyce Visual Basic), pokud není přidružena žádná kolekce schémat. Pokud je hodnota null, XmlSchemaCollectionDatabase sloupce a XmlSchemaCollectionOwningSchema mají hodnotu null.
Xmlschemacollectionowningschema Vlastnící relační schéma, kde se nachází kolekce schémat pro tuto instanci XML, pokud řádek obsahuje informace o sloupci XML. Tato hodnota je null (Nothing v jazyce Visual Basic), pokud je kolekce definovaná v rámci aktuální databáze. Je také null, pokud neexistuje žádná kolekce schémat. V takovém případě XmlSchemaCollectionDatabase jsou sloupce a XmlSchemaCollectionName také null.

Poznámka

Pokud chcete zajistit, aby sloupce metadat vracely správné informace, musíte volat ExecuteReader s parametrem nastaveným behavior na KeyInfo. V opačném případě můžou některé sloupce v tabulce schématu vrátit výchozí, null nebo nesprávná data.

Platí pro

Viz také