Sdílet prostřednictvím


SqlMetaData Třída

Definice

Určuje a načítá informace metadat z parametrů a sloupců SqlDataRecord objektů. 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
SqlMetaData

Příklady

Následující příklad ukazuje vytvoření několika SqlMetaData objektů, které popisují metadata sloupce záznamu a vytvoření objektu SqlDataRecord. Hodnoty SqlDataRecord sloupců jsou nastaveny a SqlDataRecord je odeslána volajícímu programu pomocí SqlContext třídy.

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{
   // 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 record fields.
   record.SetString(0, "Hello World!");
   record.SetInt32(1, 42);
   record.SetDateTime(2, DateTime.Now);

   // Send the record to the calling program.
   SqlContext.Pipe.Send(record);
}
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()

   ' Variables.
   Dim column1Info As SqlMetaData 
   Dim column2Info As SqlMetaData
   Dim column3Info As SqlMetaData
   Dim record As SqlDataRecord

   ' 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 record fields.
   record.SetString(0, "Hello World!")
   record.SetInt32(1, 42)
   record.SetDateTime(2, DateTime.Now)

   ' Send the record to the calling program.
   SqlContext.Pipe.Send(record)

End Sub

Konstruktory

SqlMetaData(String, SqlDbType)

Inicializuje novou instanci SqlMetaData třídy se zadaným názvem a typem sloupce.

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 s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál 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, 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 s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál sloupce řazení.

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, 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 s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál 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í, možnostmi porovnání a uživatelem definovaným typem (UDT).

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í, možnostmi porovnání a uživatelem definovaným typem (UDT). Tato forma konstruktoru podporuje parametry s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál 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 možnostmi porovnání.

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, možnostmi porovnání a výchozím nastavením serveru. Tato forma konstruktoru podporuje parametry s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál 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ím schématem a názvem objektu.

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ím schématem, názvem objektu a výchozím serverem. Tato forma konstruktoru podporuje parametry s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál sloupce řazení.

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, Type, String)

Inicializuje novou instanci SqlMetaData třídy se zadaným názvem sloupce, uživatelem definovaným typem (UDT) a typem SQLServer.

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 s hodnotou tabulky tím, že umožňuje určit, zda je sloupec jedinečný v parametru s hodnotou tabulky, pořadí řazení sloupce a ordinál sloupce řazení.

Vlastnosti

CompareOptions

Získá porovnávaná pravidla použitá 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 texttypů , ntexta 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í ordinál sloupce řazení.

SqlDbType

Získá datový typ sloupce nebo parametru.

Type

Získá common language runtime (CLR) typ 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

Hlásí, jestli má tento sloupec používat výchozí hodnotu serveru.

XmlSchemaCollectionDatabase

Získá název databáze, kde se nachází kolekce schémat pro tuto instanci XML.

XmlSchemaCollectionName

Získá název kolekce schémat pro tuto instanci XML.

XmlSchemaCollectionOwningSchema

Získá vlastnící relační schéma, kde se nachází kolekce schémat pro tuto instanci XML.

Metody

Adjust(Boolean)

Ověří zadanou Boolean hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Byte)

Ověří zadanou Byte hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Byte[])

Ověří zadanou matici Byte hodnot podle metadat a v případě potřeby upraví hodnotu.

Adjust(Char)

Ověří zadanou Char hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Char[])

Ověří zadanou matici Char hodnot podle metadat a v případě potřeby upraví hodnotu.

Adjust(DateTime)

Ověří zadanou DateTime hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(DateTimeOffset)

Ověří zadanou DateTimeOffset hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Decimal)

Ověří zadanou Decimal hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Double)

Ověří zadanou Double hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Guid)

Ověří zadanou Guid hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Int16)

Ověří zadanou Int16 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Int32)

Ověří zadanou Int32 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Int64)

Ověří zadanou Int64 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Object)

Ověří zadanou Object hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(Single)

Ověří zadanou Single hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlBinary)

Ověří zadanou SqlBinary hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlBoolean)

Ověří zadanou SqlBoolean hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlByte)

Ověří zadanou SqlByte hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlBytes)

Ověří zadanou SqlBytes hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlChars)

Ověří zadanou SqlChars hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlDateTime)

Ověří zadanou SqlDateTime hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlDecimal)

Ověří zadanou SqlDecimal hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlDouble)

Ověří zadanou SqlDouble hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlGuid)

Ověří zadanou SqlGuid hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlInt16)

Ověří zadanou SqlInt16 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlInt32)

Ověří zadanou SqlInt32 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlInt64)

Ověří zadanou SqlInt64 hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlMoney)

Ověří zadanou SqlMoney hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlSingle)

Ověří zadanou SqlSingle hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlString)

Ověří zadanou SqlString hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(SqlXml)

Ověří zadanou SqlXml hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(String)

Ověří zadanou String hodnotu proti metadatům a v případě potřeby ji upraví.

Adjust(TimeSpan)

Ověří zadanou TimeSpan hodnotu proti metadatům a v případě potřeby ji upraví.

InferFromValue(Object, String)

Odvodí metadata ze zadaného objektu a vrátí je jako SqlMetaData instanci.

Platí pro