Sdílet prostřednictvím

Běžné kolekce schémat

Platí pro: .NET Framework .NET Standard

Stáhnout ADO.NET

Běžné kolekce schémat jsou kolekce schémat, které jsou implementovány jednotlivými poskytovateli spravovanými rozhraním .NET. Pomocí dotazu na spravovaného zprostředkovatele .NET můžete určit seznam podporovaných kolekcí schémat voláním GetSchema metody bez argumentů nebo s názvem kolekce schématu MetaDataCollections. Tato metoda vrátí DataTable seznam podporovaných kolekcí schémat, počet omezení, která podporují, a počet částí identifikátorů, které používají. Tyto kolekce popisují všechny požadované sloupce. Poskytovatelé můžou přidávat další sloupce, pokud chtějí. Například zprostředkovatel dat Microsoft SqlClient pro SQL Server přidá ParameterName do kolekce omezení.

Pokud poskytovatel nemůže určit hodnotu požadovaného sloupce, vrátí hodnotu null.

Další informace o používání GetSchema metod naleznete v tématu GetSchema a Schema Collections.

MetaDataCollections

Tato kolekce zveřejňuje informace o všech kolekcích schémat podporovaných poskytovatelem, který se aktuálně používá pro připojení k databázi.

ColumnName datový typ Description
Název kolekce string Název kolekce k předání metodě GetSchema pro vrácení kolekce.
Počet omezení int Počet omezení, která mohou být zadána pro kolekci.
PočetČástíIdentifikátoru int Počet částí v názvu složeného identifikátoru nebo databázového objektu. Například na SQL Serveru by hodnota byla 3 pro tabulky a 4 pro sloupce.

Informace o zdroji dat

Tato kolekce schématu zveřejňuje informace o zdroji dat, ke kterému je aktuálně připojen poskytovatel dat Microsoft SqlClient pro SQL Server.

ColumnName datový typ Description
Vzorec oddělovače složeného identifikátoru string Regulární výraz pro odpovídání složeným oddělovačům ve složeném identifikátoru. Například \. (pro SQL Server).

Složený identifikátor se obvykle používá pro název databázového objektu, například: pubs.dbo.authors nebo pubs@dbo.authors.

Pro SQL Server použijte regulární výraz \..
NázevProduktDatovéhoZdroje string Název produktu, ke který přistupuje poskytovatel, například SQLServer.
VerzeProduktovéhoZdrojovéhoData string Označuje verzi produktu, ke které má poskytovatel přístup, v nativním formátu zdrojů dat, nikoli ve formátu Microsoftu.

V některých případech DataSourceProductVersionDataSourceProductVersionNormalized bude stejná hodnota.
NormalizovanáVerzeProduktovéhoZdrojeDat string Normalizovaná verze zdroje dat, aby bylo možné ji porovnat s String.Compare(). Tento formát je konzistentní pro všechny verze poskytovatele, aby se zabránilo řazení verze 10 mezi verzí 1 a verzí 2.

Sql Server například používá typický formát Microsoftu nn.nn.nnnn .

V některých případech DataSourceProductVersionDataSourceProductVersionNormalized bude stejná hodnota.
GroupByBehavior GroupByBehavior Určuje relaci mezi sloupci v klauzuli GROUP BY a neagregovanými sloupci v seznamu select.
Identifikační vzor string Regulární výraz, který odpovídá identifikátoru a má odpovídající hodnotu identifikátoru. Například: [A-Za-z0-9_#$].
IdentifikátorCase IdentifierCase Označuje, jestli se identifikátory, které nejsou v uvozovkách, považují za citlivé na velikost písmen.
SeřaditPodleSloupcůVeVýběru bool Určuje, zda sloupce v klauzuli ORDER BY musí být v seznamu výběru. Hodnota true značí, že se musí nacházet v seznamu výběru. Hodnota false značí, že nemusí být v seznamu výběru.
ParameterMarkerFormat string Formátovací řetězec, který představuje způsob formátování parametru.

Pokud zdroj dat podporuje pojmenované parametry, na prvním místě v tomto řetězci by měl být zástupný symbol, kde se naformátuje název parametru.

Například, pokud zdroj dat očekává, že parametry budou pojmenovány a budou mít předponu s řetězcem :, tento řetězec by byl :{0}. Při formátování tohoto parametru s názvem p1 je výsledný řetězec :p1.

Pokud zdroj dat očekává, že parametry mají mít předponu @, ale názvy ji již obsahují, tento řetězec bude {0}, a výsledek formátování @p1 pojmenovaného parametru bude @p1.

U zdrojů dat, které neočekávají pojmenované parametry a očekávají použití znaku ? , lze řetězec formátu zadat jako ?, což by ignorovalo název parametru.
Vzor značky parametru string Regulární výraz, který odpovídá značce parametru. Pokud existuje, bude mít odpovídající hodnotu názvu parametru.

Pokud jsou například pojmenované parametry podporovány znakem @ lead-in, který bude zahrnut v názvu parametru, bude tento vzor: (\@[A-Za-z0-9_$#]*).

Pokud jsou pojmenované parametry podporovány s : jako úvodním znakem, a není-li součástí názvu parametru, bude tento vzor: :([A-Za-z0-9_$#]\*).

Pokud zdroj dat nepodporuje pojmenované parametry, tento vzor by byl ?.
ParameterNameMaxLength int Maximální délka názvu parametru v počtu znaků. Visual Studio očekává, že pokud jsou podporovány názvy parametrů, minimální hodnota maximální délky je 30 znaků.

Pokud zdroj dat nepodporuje pojmenované parametry, vrátí tato vlastnost nulu.
ParameterNamePattern string Regulární výraz, který odpovídá platným názvům parametrů. Různé zdroje dat mají různá pravidla týkající se znaků, které lze použít pro názvy parametrů.

Visual Studio očekává, že pokud jsou podporovány názvy parametrů, jsou znaky \p{Lu}\p{Ll}\p{Lt}\p{Lm}\p{Lo}\p{Nl}\p{Nd} minimální podporovanou sadou znaků, které jsou platné pro názvy parametrů.
QuotedIdentifierPattern string Regulární výraz, který odpovídá identifikátoru v uvozovkách a má odpovídající hodnotu samotného identifikátoru bez uvozovek. Pokud například zdroj dat použil dvojité uvozovky k označení uvozených identifikátorů, bude tento vzor: (([^\\"]\|\\"\\")*).
PřípadQuotedIdentifikátoru IdentifierCase Udává, zda se uvozené identifikátory posuzují jako rozlišující nebo nerozlišující velikost písmen.
VzorOddělovačeVýroku string Regulární výraz, který odpovídá oddělovači příkazů.
StringLiteralPattern string Regulární výraz, který odpovídá řetězcovém literálu a má odpovídající hodnotu samotného literálu. Pokud například zdroj dat k identifikaci řetězců použil jednoduché uvozovky, bude tento vzor: ('([^']\|'')*')
Podporovaní operátoři spojení SupportedJoinOperators Určuje, jaké typy příkazů spojení SQL podporuje zdroj dat.

Datové typy

Tato kolekce schématu zveřejňuje informace o datových typech podporovaných databází, ke které je poskytovatel aktuálně připojený.

ColumnName datový typ Description
NázevTypu string Název datového typu specifického pro zprostředkovatele.
ProviderDbType int Hodnota typu specifická pro zprostředkovatele, která by se měla použít při zadávání typu parametru. Například: SqlDbType.Money.
Velikost sloupce long Délka nečíselného sloupce nebo parametru Tato hodnota odkazuje na maximální nebo délku definovanou pro tento typ poskytovatelem.

Pro data znaků je tato hodnota maximální nebo definovaná délka v jednotkách definovaných zdrojem dat.

U datových typů data a času tato hodnota vyjadřuje délku řetězcové podoby, za předpokladu použití maximální povolené přesnosti pro komponentu obsahující zlomky sekund.

Pokud je datový typ číselný, je tato hodnota horní mez maximální přesnosti datového typu.
Vytvořit Formát string Formátovací řetězec, který představuje způsob přidání tohoto sloupce do příkazu definice dat, například CREATE TABLE. Každý prvek v CreateParameter poli by měl být reprezentován značkou parametru v řetězci formátu.

Například datový typ SQL DECIMAL vyžaduje přesnost a měřítko. V tomto případě by formátovací řetězec byl DECIMAL({0},{1}).
VytvořitParametry string Parametry vytvoření, které musí být zadány při vytváření sloupce tohoto datového typu. Každý parametr vytvoření je uvedený v řetězci oddělený čárkou v pořadí, ve kterém se mají zadaná.

Například datový typ SQL DECIMAL vyžaduje přesnost a měřítko. V tomto případě by parametry vytvoření měly obsahovat řetězec "přesnost, rozsah".

V textovém příkazu pro vytvoření sloupce DECIMAL s přesností 10 a měřítkem 2 může být hodnota sloupce CreateFormat DECIMAL({0},{1}) a kompletní specifikace typu DECIMAL(10,2).
datový typ string Název typu .NET datového typu.
JeAutomatickyInkrementovatelné bool true – Hodnoty tohoto datového typu se můžou automaticky zvýšit.

false – Hodnoty tohoto datového typu nemusí být automaticky inkrementované.

Tato vlastnost pouze označuje, jestli se sloupec tohoto datového typu může automaticky zvýšit, ne že všechny sloupce tohoto typu se automaticky navyšují.
IsBestMatch bool true – Datový typ je nejlepší shoda mezi všemi datovými typy v úložišti dat a datovým typem .NET označeným hodnotou ve sloupci DataType .

false – Datový typ není nejvhodnější.

Pro každou sadu řádků, ve které je hodnota sloupce DataType stejná, je sloupec IsBestMatch nastaven na true pouze v jednom řádku.
JeReagujícíNaVelikostPísmen bool true – Datový typ je znakový typ a rozlišuje malá a velká písmena.

false – Datový typ není znakový typ nebo není citlivý na velikost písmen.
JePevnáDélka bool true – Sloupce tohoto datového typu vytvořeného jazykem DDL (Data Definition Language) budou mít pevnou délku.

false – Sloupce tohoto datového typu vytvořeného DDL budou mít proměnlivou délku.

DBNull.Value – Není známo, jestli zprostředkovatel mapuje toto pole se sloupcem s pevnou délkou nebo proměnnou délkou.
Fixní přesnost stupnice bool true – Datový typ má pevnou přesnost a měřítko.

false – Datový typ nemá pevnou přesnost a měřítko.
IsLong bool true - Datový typ obsahuje velmi dlouhá data; definice velmi dlouhých dat je specifická pro poskytovatele.

false – Datový typ neobsahuje příliš dlouhá data.
JeNullovatelné bool true – Datový typ je nulovatelný.

false – Datový typ neumožňuje hodnotu null.

DBNull.Value – Není známo, jestli je datový typ nullable.
JeVyhledatelné bool true - Datový typ lze použít v klauzuli WHERE s libovolným operátorem s výjimkou predikátu LIKE.

false - Datový typ nelze použít v klauzuli WHERE s žádným operátorem s výjimkou predikátu LIKE.
LzeVyhledatPomocíLike bool true - Datový typ lze použít s predikátem LIKE.

false – Datový typ nelze použít s predikátem LIKE.
IsUnsigned bool true – Datový typ je bez znaménka.

false – Datový typ je podepsaný.

DBNull.Value - Nevztahuje se na datový typ.
Maximální měřítko short Pokud je indikátor typu číselný typ, je tato hodnota maximální počet číslic povolených vpravo od desetinné čárky. V opačném případě je tato hodnota DBNull.Value.
Minimální měřítko short Pokud je indikátor typu číselný typ, je tato hodnota minimální počet číslic povolených vpravo od desetinné čárky. Jinak je tato hodnota DBNull.Value.
IsConcurrencyType bool true – Datový typ se aktualizuje databází při každé změně řádku a hodnota sloupce se liší od všech předchozích hodnot.

false – Datový typ je aktualizován databází při každé změně řádku.

DBNull.Value – Databáze tento datový typ nepodporuje.
IsLiteralSupported bool true – Datový typ lze vyjádřit jako literál.

false – Datový typ nelze vyjádřit jako literál.
LiteralPrefix string Předpona použitá pro daný literál.
Přípona literálu string Přípona použitá pro daný literál.

Restrictions

Tato kolekce schématu odhalila informace o omezeních podporovaných poskytovatelem, který se aktuálně používá pro připojení k databázi.

ColumnName datový typ Description
Název kolekce string Název kolekce, na kterou se tato omezení vztahují.
Název omezení string Název omezení v kolekci.
OmezeníDefault string Ignorovaný.
ČísloOmezení int Skutečné umístění v omezeních kolekce, kam tento konkrétní limit spadá.

Rezervovaná slova

Tato kolekce schémat poskytuje informace o slovech, která jsou rezervována databází, ke které je aktuálně připojen poskytovatel.

ColumnName datový typ Description
RezervovanéSlovo string Specifické rezervované slovo poskytovatele

Viz také

  • Last updated on