SqlDataRecord Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient.Server

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Reprezentuje pojedynczy wiersz danych i jego metadanych.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Dziedziczenie

Object

SqlDataRecord

Implementuje

IDataRecord

Przykłady

W poniższym przykładzie pokazano, jak utworzyć kilka SqlMetaData obiektów, które opisują metadane kolumny rekordu i tworzą obiekt SqlDataRecord. Wartości kolumny są ustawione, a SqlDataRecord element SqlDataRecord jest wysyłany do programu wywołującego przy użyciu SqlContext klasy .

//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);
}

Uwagi

Ta klasa jest używana razem z usługą SqlPipe do wysyłania zestawów wyników do klienta z procedur składowanych kodu zarządzanego.

Podczas pisania aplikacji środowiska uruchomieniowego języka wspólnego (CLR) należy ponownie używać istniejących SqlDataRecord obiektów zamiast tworzyć nowe za każdym razem. Tworzenie wielu nowych SqlDataRecord obiektów może poważnie wyczerpać pamięć i negatywnie wpłynąć na wydajność.

Konstruktory

SqlDataRecord(SqlMetaData[])

Inititializuje nowe SqlDataRecord wystąpienie ze schematem na podstawie tablicy SqlMetaData obiektów przekazanych jako argument.

Właściwości

FieldCount	Pobiera liczbę kolumn w wierszu danych. Ta właściwość jest tylko do odczytu.
Item[Int32]	Pobiera wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument kolumny ordinal .
Item[String]	Pobiera wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument kolumny name .

Metody

GetBoolean(Int32)	Pobiera wartość kolumny określonej przez porządkową Booleanjako .
GetByte(Int32)	Pobiera wartość kolumny określonej przez porządkową Bytejako .
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Pobiera wartość kolumny określonej przez porządkową jako tablicę Byte obiektów.
GetChar(Int32)	Pobiera wartość kolumny określonej przez porządkową Charjako .
GetChars(Int32, Int64, Char[], Int32, Int32)	Pobiera wartość kolumny określonej przez porządkową jako tablicę Char obiektów.
GetDataTypeName(Int32)	Zwraca nazwę typu danych dla kolumny określonej przez argument porządkowy.
GetDateTime(Int32)	Pobiera wartość kolumny określonej przez porządkową DateTimejako .
GetDateTimeOffset(Int32)	Zwraca dane określonej kolumny jako DateTimeOffset.
GetDecimal(Int32)	Pobiera wartość kolumny określonej przez porządkową Decimaljako .
GetDouble(Int32)	Pobiera wartość kolumny określonej przez porządkową Doublejako .
GetFieldType(Int32)	Type Zwraca obiekt reprezentujący typ środowiska uruchomieniowego języka wspólnego (CLR), który mapuje na typ SQL Server kolumny określonej przez ordinal argument.
GetFloat(Int32)	Pobiera wartość kolumny określonej przez porządkową floatjako .
GetGuid(Int32)	Pobiera wartość kolumny określonej przez porządkową Guidjako .
GetInt16(Int32)	Pobiera wartość kolumny określonej przez porządkową Int16jako .
GetInt32(Int32)	Pobiera wartość kolumny określonej przez porządkową Int32jako .
GetInt64(Int32)	Pobiera wartość kolumny określonej przez porządkową Int64jako .
GetName(Int32)	Zwraca nazwę kolumny określonej przez argument porządkowy.
GetOrdinal(String)	Zwraca porządkową kolumnę określoną przez nazwę kolumny.
GetSqlBinary(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlBinaryjako .
GetSqlBoolean(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlBooleanjako .
GetSqlByte(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlBytejako .
GetSqlBytes(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlBytesjako .
GetSqlChars(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlCharsjako .
GetSqlDateTime(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlDateTimejako .
GetSqlDecimal(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlDecimaljako .
GetSqlDouble(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlDoublejako .
GetSqlFieldType(Int32)	Type Zwraca obiekt reprezentujący typ (jako typ SQL Server zdefiniowany w System.Data.SqlTypespliku ), który mapuje na typ SQL Server kolumny.
GetSqlGuid(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlGuidjako .
GetSqlInt16(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlInt16jako .
GetSqlInt32(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlInt32jako .
GetSqlInt64(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlInt64jako .
GetSqlMetaData(Int32)	SqlMetaData Zwraca obiekt opisujący metadane kolumny określonej przez porządkową kolumnę.
GetSqlMoney(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlMoneyjako .
GetSqlSingle(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlSinglejako .
GetSqlString(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlStringjako .
GetSqlValue(Int32)	Zwraca wartość danych przechowywaną w kolumnie wyrażoną jako typ SQL Server określony przez kolumnę porządkową.
GetSqlValues(Object[])	Zwraca wartości wszystkich kolumn w rekordzie wyrażonych jako typy SQL Server w tablicy.
GetSqlXml(Int32)	Pobiera wartość kolumny określonej przez porządkową SqlXmljako .
GetString(Int32)	Pobiera wartość kolumny określonej przez porządkową Stringjako .
GetTimeSpan(Int32)	Zwraca dane określonej kolumny jako TimeSpan.
GetValue(Int32)	Zwraca wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument porządkowy.
GetValues(Object[])	Zwraca wartości wszystkich kolumn w rekordzie wyrażonych jako typy środowiska uruchomieniowego języka wspólnego (CLR) w tablicy.
IsDBNull(Int32)	Zwraca wartość true, jeśli kolumna określona przez parametr porządkowy kolumny ma wartość null.
SetBoolean(Int32, Boolean)	Ustawia dane przechowywane w kolumnie na określoną Boolean wartość.
SetByte(Int32, Byte)	Ustawia dane przechowywane w kolumnie na określoną Byte wartość.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Ustawia dane przechowywane w kolumnie na określoną tablicę Byte wartości.
SetChar(Int32, Char)	Ustawia dane przechowywane w kolumnie na określoną Char wartość.
SetChars(Int32, Int64, Char[], Int32, Int32)	Ustawia dane przechowywane w kolumnie na określoną tablicę Char wartości.
SetDateTime(Int32, DateTime)	Ustawia dane przechowywane w kolumnie na określoną DateTime wartość.
SetDateTimeOffset(Int32, DateTimeOffset)	Ustawia wartość kolumny określonej na DateTimeOffset wartość.
SetDBNull(Int32)	Ustawia wartość w określonej kolumnie na DBNull.
SetDecimal(Int32, Decimal)	Ustawia dane przechowywane w kolumnie na określoną Decimal wartość.
SetDouble(Int32, Double)	Ustawia dane przechowywane w kolumnie na określoną Double wartość.
SetFloat(Int32, Single)	Ustawia dane przechowywane w kolumnie na określoną float wartość.
SetGuid(Int32, Guid)	Ustawia dane przechowywane w kolumnie na określoną Guid wartość.
SetInt16(Int32, Int16)	Ustawia dane przechowywane w kolumnie na określoną Int16 wartość.
SetInt32(Int32, Int32)	Ustawia dane przechowywane w kolumnie na określoną Int32 wartość.
SetInt64(Int32, Int64)	Ustawia dane przechowywane w kolumnie na określoną Int64 wartość.
SetSqlBinary(Int32, SqlBinary)	Ustawia dane przechowywane w kolumnie na określoną SqlBinary wartość.
SetSqlBoolean(Int32, SqlBoolean)	Ustawia dane przechowywane w kolumnie na określoną SqlBoolean wartość.
SetSqlByte(Int32, SqlByte)	Ustawia dane przechowywane w kolumnie na określoną SqlByte wartość.
SetSqlBytes(Int32, SqlBytes)	Ustawia dane przechowywane w kolumnie na określoną SqlBytes wartość.
SetSqlChars(Int32, SqlChars)	Ustawia dane przechowywane w kolumnie na określoną SqlChars wartość.
SetSqlDateTime(Int32, SqlDateTime)	Ustawia dane przechowywane w kolumnie na określoną SqlDateTime wartość.
SetSqlDecimal(Int32, SqlDecimal)	Ustawia dane przechowywane w kolumnie na określoną SqlDecimal wartość.
SetSqlDouble(Int32, SqlDouble)	Ustawia dane przechowywane w kolumnie na określoną SqlDouble wartość.
SetSqlGuid(Int32, SqlGuid)	Ustawia dane przechowywane w kolumnie na określoną SqlGuid wartość.
SetSqlInt16(Int32, SqlInt16)	Ustawia dane przechowywane w kolumnie na określoną SqlInt16 wartość.
SetSqlInt32(Int32, SqlInt32)	Ustawia dane przechowywane w kolumnie na określoną SqlInt32 wartość.
SetSqlInt64(Int32, SqlInt64)	Ustawia dane przechowywane w kolumnie na określoną SqlInt64 wartość.
SetSqlMoney(Int32, SqlMoney)	Ustawia dane przechowywane w kolumnie na określoną SqlMoney wartość.
SetSqlSingle(Int32, SqlSingle)	Ustawia dane przechowywane w kolumnie na określoną SqlSingle wartość.
SetSqlString(Int32, SqlString)	Ustawia dane przechowywane w kolumnie na określoną SqlString wartość.
SetSqlXml(Int32, SqlXml)	Ustawia dane przechowywane w kolumnie na określoną SqlXml wartość.
SetString(Int32, String)	Ustawia dane przechowywane w kolumnie na określoną String wartość.
SetTimeSpan(Int32, TimeSpan)	Ustawia wartość kolumny określonej na TimeSpanwartość .
SetValue(Int32, Object)	Ustawia nową wartość wyrażoną jako typ środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez kolumnę porządkową.
SetValues(Object[])	Ustawia nowe wartości dla wszystkich kolumn w obiekcie SqlDataRecord. Te wartości są wyrażane jako typy środowiska uruchomieniowego języka wspólnego (CLR).

Jawne implementacje interfejsu

IDataRecord.GetData(Int32)

Nieobsługiwane w tej wersji.