SqlDataRecord Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient.Server

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Představuje jeden řádek dat a jejich metadata.

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 sloupců jsou nastaveny a SqlDataRecord do volajícího programu se odešle pomocí SqlContext třídy .

//using Microsoft.Data.SqlClient.Server;

[Microsoft.Data.SqlClient.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);
}

Poznámky

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

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é objekty. Vytváření mnoha nových SqlDataRecord objektů může vážně vyčerpát paměť a nepříznivě ovlivnit výkon.

Konstruktory

SqlDataRecord(SqlMetaData[])

Inicializuje 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 CLR (Common Language Runtime) pro sloupec určený argumentem sloupce ordinal .
Item[String]	Získá hodnotu typu CLR (Common Language Runtime) pro sloupec určený argumentem sloupce name .

Metody

GetBoolean(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Booleanjako .
GetByte(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Bytejako .
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Získá hodnotu pro sloupec určený pořadovým řádem jako pole Byte objektů.
GetChar(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Charjako .
GetChars(Int32, Int64, Char[], Int32, Int32)	Získá hodnotu pro sloupec určený pořadovým řádem jako pole Char objektů.
GetDataTypeName(Int32)	Vrátí název datového typu sloupce určeného pořadovým argumentem.
GetDateTime(Int32)	Získá hodnotu sloupce určeného pořadovým řádem DateTimejako .
GetDateTimeOffset(Int32)	Vrátí data zadaného sloupce jako DateTimeOffset.
GetDecimal(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Decimaljako .
GetDouble(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Doublejako .
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 argumentemordinal.
GetFloat(Int32)	Získá hodnotu sloupce určeného pořadovým řádem floatjako .
GetGuid(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Guidjako .
GetInt16(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Int16jako .
GetInt32(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Int32jako .
GetInt64(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Int64jako .
GetName(Int32)	Vrátí název sloupce určeného pořadovým argumentem.
GetOrdinal(String)	Vrátí ordinál sloupce určený názvem sloupce.
GetSqlBinary(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlBinaryjako .
GetSqlBoolean(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlBooleanjako .
GetSqlByte(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlBytejako .
GetSqlBytes(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlBytesjako .
GetSqlChars(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlCharsjako .
GetSqlDateTime(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlDateTimejako .
GetSqlDecimal(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlDecimaljako .
GetSqlDouble(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlDoublejako .
GetSqlFieldType(Int32)	Type Vrátí objekt, který představuje typ (jako typ SQL Server definovaný v System.Data.SqlTypes), který se mapuje na typ SQL Server sloupce.
GetSqlGuid(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlGuidjako .
GetSqlInt16(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlInt16jako .
GetSqlInt32(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlInt32jako .
GetSqlInt64(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlInt64jako .
GetSqlMetaData(Int32)	SqlMetaData Vrátí objekt popisující metadata sloupce určeného pořadovým řádem sloupce.
GetSqlMoney(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlMoneyjako .
GetSqlSingle(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlSinglejako .
GetSqlString(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlStringjako .
GetSqlValue(Int32)	Vrátí hodnotu dat uloženou ve sloupci vyjádřenou jako typ SQL Server určený pořadovým řádem sloupce.
GetSqlValues(Object[])	Vrátí hodnoty pro všechny sloupce v záznamu vyjádřené jako SQL Server typů v matici.
GetSqlXml(Int32)	Získá hodnotu sloupce určeného pořadovým řádem SqlXmljako .
GetString(Int32)	Získá hodnotu sloupce určeného pořadovým řádem Stringjako .
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 matici.
IsDBNull(Int32)	Vrátí hodnotu true, pokud sloupec zadaný parametrem řadového 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 zadanou matici 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 zadanou matici 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 DBNullhodnotu .
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 TimeSpanhodnotu .
SetValue(Int32, Object)	Nastaví novou hodnotu vyjádřenou jako typ modulu CLR (Common Language Runtime) pro sloupec určený pořadovou adresou 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 není podporováno.