SqlDataRecord Třída

Reference

Definice

Obor názvů:: Microsoft.SqlServer.Server

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Balíček:: System.Data.SqlClient v4.8.5

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje jeden řádek dat a jejich metadat. Tato třída se nemůže dědit.

public ref class SqlDataRecord : System::Data::IDataRecord

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Dědičnost: Object
SqlDataRecord

Implementuje: IDataRecord

Příklady

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

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{

   // Variables.
   SqlDataRecord record;

   // Create a new record with the column metadata. The constructor is
   // able to accept a variable number of parameters.
   record = new SqlDataRecord(new SqlMetaData[] { new SqlMetaData("Column1", SqlDbType.NVarChar, 12),
                                                  new SqlMetaData("Column2", SqlDbType.Int),
                                                  new SqlMetaData("Column3", SqlDbType.DateTime) });

   // 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 record As SqlDataRecord
   
   ' Create a new record with the column metadata.  The constructor is 
   ' able to accept a variable number of parameters.     
   record = New SqlDataRecord(New SqlMetaData() {New SqlMetaData("Column1", SqlDbType.NVarChar, 12), _
                                                 New SqlMetaData("Column2", SqlDbType.Int), _
                                                 New SqlMetaData("Column3", SqlDbType.DateTime)})

   ' 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

Poznámky

Tato třída se používá společně s SqlPipe k odeslání sad výsledků do klienta ze spravovaného kódu uložené procedury.

Při psaní aplikací CLR (Common Language Runtime) byste měli znovu použít existující SqlDataRecord objekty, místo abyste pokaždé vytvářeli nové. Vytvoření velkého počtu nových SqlDataRecord objektů může vážně vyčerpát paměť a negativně ovlivnit výkon.

Konstruktory

SqlDataRecord(SqlMetaData[])

Initicializuje novou SqlDataRecord instanci se schématem na základě pole SqlMetaData objektů předaných jako argument.

Vlastnosti

FieldCount	Získá počet sloupců v řádku dat. Tato vlastnost je jen ke čtení.
Item[Int32]	Získá hodnotu typu Common Language Runtime (CLR) pro sloupec určený argumentem column `ordinal` .
Item[String]	Získá hodnotu typu Common Language Runtime (CLR) pro sloupec určený argumentem column `name` .

Metody

GetBoolean(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Boolean.
GetByte(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako pole Byte objektů.
GetChar(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Char.
GetChars(Int32, Int64, Char[], Int32, Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako pole Char objektů.
GetDataTypeName(Int32)	Vrátí název datového typu pro sloupec určený pořadovým argumentem.
GetDateTime(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako DateTime.
GetDateTimeOffset(Int32)	Vrátí data zadaného sloupce jako DateTimeOffset.
GetDecimal(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Decimal.
GetDouble(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Double.
GetFieldType(Int32)	Type Vrátí objekt představující typ CLR (Common Language Runtime), který se mapuje na typ SQL Server sloupce určeného argumentem `ordinal` .
GetFloat(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako `float`.
GetGuid(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Guid.
GetInt16(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Int16.
GetInt32(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Int32.
GetInt64(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako Int64.
GetName(Int32)	Vrátí název sloupce určeného pořadovým argumentem.
GetOrdinal(String)	Vrátí pořadové číslo sloupce určené názvem sloupce.
GetSqlBinary(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlBinary.
GetSqlBoolean(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlBoolean.
GetSqlByte(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlByte.
GetSqlBytes(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlBytes.
GetSqlChars(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlChars.
GetSqlDateTime(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlDateTime.
GetSqlDecimal(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlDecimal.
GetSqlDouble(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlDouble.
GetSqlFieldType(Int32)	Type Vrátí objekt, který představuje typ (jako typ SQL Server definovaný v System.Data.SqlTypes), který se mapuje na SQL Server typ sloupce.
GetSqlGuid(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlGuid.
GetSqlInt16(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlInt16.
GetSqlInt32(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlInt32.
GetSqlInt64(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlInt64.
GetSqlMetaData(Int32)	SqlMetaData Vrátí objekt popisující metadata sloupce určeného řadovým sloupcem.
GetSqlMoney(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlMoney.
GetSqlSingle(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlSingle.
GetSqlString(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlString.
GetSqlValue(Int32)	Vrátí hodnotu dat uloženou ve sloupci vyjádřenou jako typ SQL Server určený pořadovým pořadím sloupce.
GetSqlValues(Object[])	Vrátí hodnoty pro všechny sloupce v záznamu vyjádřené jako SQL Server typy v poli.
GetSqlXml(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako SqlXml.
GetString(Int32)	Získá hodnotu pro sloupec určený pořadovým číslo jako String.
GetTimeSpan(Int32)	Vrátí data zadaného sloupce jako TimeSpan.
GetValue(Int32)	Vrátí hodnotu typu CLR (Common Language Runtime) pro sloupec určený pořadovým argumentem.
GetValues(Object[])	Vrátí hodnoty pro všechny sloupce v záznamu vyjádřené jako typy CLR (Common Language Runtime) v poli.
IsDBNull(Int32)	Vrátí hodnotu true, pokud sloupec určený parametrem řadové číslo sloupce má hodnotu null.
SetBoolean(Int32, Boolean)	Nastaví data uložená ve sloupci na zadanou Boolean hodnotu.
SetByte(Int32, Byte)	Nastaví data uložená ve sloupci na zadanou Byte hodnotu.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Nastaví data uložená ve sloupci na zadané pole Byte hodnot.
SetChar(Int32, Char)	Nastaví data uložená ve sloupci na zadanou Char hodnotu.
SetChars(Int32, Int64, Char[], Int32, Int32)	Nastaví data uložená ve sloupci na zadané pole Char hodnot.
SetDateTime(Int32, DateTime)	Nastaví data uložená ve sloupci na zadanou DateTime hodnotu.
SetDateTimeOffset(Int32, DateTimeOffset)	Nastaví hodnotu zadaného sloupce na DateTimeOffset hodnotu .
SetDBNull(Int32)	Nastaví hodnotu v zadaném sloupci na DBNull.
SetDecimal(Int32, Decimal)	Nastaví data uložená ve sloupci na zadanou Decimal hodnotu.
SetDouble(Int32, Double)	Nastaví data uložená ve sloupci na zadanou Double hodnotu.
SetFloat(Int32, Single)	Nastaví data uložená ve sloupci na zadanou `float` hodnotu.
SetGuid(Int32, Guid)	Nastaví data uložená ve sloupci na zadanou Guid hodnotu.
SetInt16(Int32, Int16)	Nastaví data uložená ve sloupci na zadanou Int16 hodnotu.
SetInt32(Int32, Int32)	Nastaví data uložená ve sloupci na zadanou Int32 hodnotu.
SetInt64(Int32, Int64)	Nastaví data uložená ve sloupci na zadanou Int64 hodnotu.
SetSqlBinary(Int32, SqlBinary)	Nastaví data uložená ve sloupci na zadanou SqlBinary hodnotu.
SetSqlBoolean(Int32, SqlBoolean)	Nastaví data uložená ve sloupci na zadanou SqlBoolean hodnotu.
SetSqlByte(Int32, SqlByte)	Nastaví data uložená ve sloupci na zadanou SqlByte hodnotu.
SetSqlBytes(Int32, SqlBytes)	Nastaví data uložená ve sloupci na zadanou SqlBytes hodnotu.
SetSqlChars(Int32, SqlChars)	Nastaví data uložená ve sloupci na zadanou SqlChars hodnotu.
SetSqlDateTime(Int32, SqlDateTime)	Nastaví data uložená ve sloupci na zadanou SqlDateTime hodnotu.
SetSqlDecimal(Int32, SqlDecimal)	Nastaví data uložená ve sloupci na zadanou SqlDecimal hodnotu.
SetSqlDouble(Int32, SqlDouble)	Nastaví data uložená ve sloupci na zadanou SqlDouble hodnotu.
SetSqlGuid(Int32, SqlGuid)	Nastaví data uložená ve sloupci na zadanou SqlGuid hodnotu.
SetSqlInt16(Int32, SqlInt16)	Nastaví data uložená ve sloupci na zadanou SqlInt16 hodnotu.
SetSqlInt32(Int32, SqlInt32)	Nastaví data uložená ve sloupci na zadanou SqlInt32 hodnotu.
SetSqlInt64(Int32, SqlInt64)	Nastaví data uložená ve sloupci na zadanou SqlInt64 hodnotu.
SetSqlMoney(Int32, SqlMoney)	Nastaví data uložená ve sloupci na zadanou SqlMoney hodnotu.
SetSqlSingle(Int32, SqlSingle)	Nastaví data uložená ve sloupci na zadanou SqlSingle hodnotu.
SetSqlString(Int32, SqlString)	Nastaví data uložená ve sloupci na zadanou SqlString hodnotu.
SetSqlXml(Int32, SqlXml)	Nastaví data uložená ve sloupci na zadanou SqlXml hodnotu.
SetString(Int32, String)	Nastaví data uložená ve sloupci na zadanou String hodnotu.
SetTimeSpan(Int32, TimeSpan)	Nastaví hodnotu zadaného sloupce na TimeSpan.
SetValue(Int32, Object)	Nastaví novou hodnotu vyjádřenou jako typ CLR (Common Language Runtime) pro sloupec určený řadovým pořadím sloupce.
SetValues(Object[])	Nastaví nové hodnoty pro všechny sloupce v .SqlDataRecord Tyto hodnoty jsou vyjádřeny jako typy CLR (Common Language Runtime).

Explicitní implementace rozhraní

IDataRecord.GetData(Int32)

V této verzi se nepodporuje.

Platí pro

Sdílet prostřednictvím