SqlDataReader.GetSchemaTable Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

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

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

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.

Viz také

• Přehled ADO.NET