Sdílet prostřednictvím


SqlDataRecord Třída

Definice

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
SqlDataRecord
Implementuje

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