SqlMetaData Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient.Server

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.1.0

Určuje informace o metadatech sloupce používaného objektem SqlDataRecord . Tato třída se nemůže dědit.

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

Dědičnost

Object

SqlMetaData

Příklady

Následující příklad ukazuje vytvoření několika SqlMetaData objektů, které popisují metadata sloupce záznamu a generování datového proudu SqlDataRecord záznamů. Tyto SqlDataRecord záznamy lze streamovat do SQL Server jako parametr s hodnotou tabulky přiřazením návratové hodnoty metody do Value vlastnosti.

using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;

public static IEnumerable<SqlDataRecord> ReturnNewRecords()
{
    // Variables.
    SqlMetaData column1Info;
    SqlMetaData column2Info;
    SqlMetaData column3Info;
    SqlDataRecord record;

    // Create the column metadata.
    column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
    column2Info = new SqlMetaData("Column2", SqlDbType.Int);
    column3Info = new SqlMetaData("Column3", SqlDbType.DateTime);

    // Create a new record with the column metadata.      
    record = new SqlDataRecord(new SqlMetaData[] { 
      column1Info,
      column2Info,
      column3Info });

    // Set the fields of the first record and stream it to SQL Server.
    record.SetString(0, "Hello World!");
    record.SetInt32(1, 42);
    record.SetDateTime(2, DateTime.Now);
    yield return record;

    // Set the fields of the second record and stream it to SQL Server.
    record.SetInt32(1, 0);
    yield return record;
}

Poznámky

SqlMetaDatainstance se obvykle vytvářejí jednou a znovu se používají k vytvoření mnoha SqlDataRecord objektů, které se streamují do SQL Server jako parametr s hodnotou tabulky. Další informace najdete v tématu Table-Valued Parametry.

Konstruktory

Název	Description
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce a výchozím serverem. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, přesností, škálováním a výchozím nastavením serveru. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Byte, Byte)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, přesností a měřítkem.
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, maximální délkou a výchozím nastavením serveru. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, maximální délkou, přesností, měřítkem, ID národního prostředí, porovnáním možností a uživatelem definovaným typem (UDT). Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, maximální délkou, přesností, měřítkem, ID národního prostředí, porovnáním možností a uživatelem definovaným typem (UDT).
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, maximální délkou, národním prostředím, porovnáním možností a výchozím nastavením serveru. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, maximální délkou, národním prostředím a porovnávat možnosti.
SqlMetaData(String, SqlDbType, Int64)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem a maximální délkou.
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, názvem databáze, vlastníkem schématu, názvem objektu a výchozím serverem. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, String, String, String)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, názvem databáze, vlastníkem schématu a názvem objektu.
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem, uživatelem definovaným typem, SQL Server typem a výchozím nastavením serveru. Tato forma konstruktoru podporuje parametry hodnot tabulky tím, že umožňuje určit, jestli je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a pořadové číslo sloupce řazení.
SqlMetaData(String, SqlDbType, Type, String)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, uživatelem definovaným typem (UDT) a SQL Server typ.
SqlMetaData(String, SqlDbType, Type)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, typem a uživatelem definovaným typem (UDT).
SqlMetaData(String, SqlDbType)	Inicializuje novou instanci SqlMetaData třídy se zadaným názvem a typem sloupce.

Vlastnosti

Název	Description
CompareOptions	Získá porovnávací pravidla používaná pro sloupec nebo parametr.
DbType	Získá datový typ sloupce nebo parametru.
IsUniqueKey	Určuje, jestli je sloupec v parametru s hodnotou tabulky jedinečný.
LocaleId	Získá ID národního prostředí sloupce nebo parametru.
Max	Získá délku datových typů TEXT, NTEXT a IMAGE.
MaxLength	Získá maximální délku sloupce nebo parametru.
Name	Získá název sloupce nebo parametru.
Precision	Získá přesnost sloupce nebo parametru.
Scale	Získá měřítko sloupce nebo parametru.
SortOrder	Vrátí pořadí řazení sloupce.
SortOrdinal	Vrátí pořadový řádek sloupce řazení.
SqlDbType	Získá datový typ sloupce nebo parametru.
Type	Získá typ modulu CLR (Common Language Runtime) uživatelem definovaného typu (UDT).
TypeName	Získá třídílný název uživatelem definovaného typu (UDT) nebo SQL Server typ reprezentovaný instancí.
UseServerDefault	Udává, jestli má tento sloupec používat výchozí hodnotu serveru.
XmlSchemaCollectionDatabase	Získá název databáze, kde je umístěna kolekce schémat pro tuto instanci XML.
XmlSchemaCollectionName	Získá název kolekce schémat pro tuto instanci XML.
XmlSchemaCollectionOwningSchema	Získá vlastní relační schéma, kde je umístěna kolekce schématu pro tuto instanci XML.

Metody

Název	Description
Adjust(Boolean)	Ověří zadanou Boolean hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Byte)	Ověří zadanou Byte hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Byte[])	Ověří zadanou matici Byte hodnot vůči metadatům a v případě potřeby upraví hodnotu.
Adjust(Char)	Ověří zadanou Char hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Char[])	Ověří zadanou matici Char hodnot vůči metadatům a v případě potřeby upraví hodnotu.
Adjust(DateTime)	Ověří zadanou DateTime hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(DateTimeOffset)	Ověří zadanou DateTimeOffset hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Decimal)	Ověří zadanou Decimal hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Double)	Ověří zadanou Double hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Guid)	Ověří zadanou Guid hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Int16)	Ověří zadanou Int16 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Int32)	Ověří zadanou Int32 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Int64)	Ověří zadanou Int64 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Object)	Ověří zadanou Object hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(Single)	Ověří zadanou Single hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlBinary)	Ověří zadanou SqlBinary hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlBoolean)	Ověří zadanou SqlBoolean hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlByte)	Ověří zadanou SqlByte hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlBytes)	Ověří zadanou SqlBytes hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlChars)	Ověří zadanou SqlChars hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlDateTime)	Ověří zadanou SqlDateTime hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlDecimal)	Ověří zadanou SqlDecimal hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlDouble)	Ověří zadanou SqlDouble hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlGuid)	Ověří zadanou SqlGuid hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlInt16)	Ověří zadanou SqlInt16 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlInt32)	Ověří zadanou SqlInt32 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlInt64)	Ověří zadanou SqlInt64 hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlMoney)	Ověří zadanou SqlMoney hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlSingle)	Ověří zadanou SqlSingle hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlString)	Ověří zadanou SqlString hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(SqlXml)	Ověří zadanou SqlXml hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(String)	Ověří zadanou String hodnotu na metadatech a v případě potřeby ji upraví.
Adjust(TimeSpan)	Ověří zadanou TimeSpan hodnotu na metadatech a v případě potřeby ji upraví.
InferFromValue(Object, String)	Odvodí metadata ze zadaného objektu a vrátí je jako SqlMetaData instanci.