SqlDataRecord Klasa

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.SqlServer.Server

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.SqlClient v4.8.5

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje pojedynczy wiersz danych i jego metadanych. Klasa ta nie może być dziedziczona.

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 SqlDataRecord kolumny są ustawione, a element SqlDataRecord jest wysyłany do programu wywołującego SqlContext przy użyciu klasy .

[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

Uwagi

Ta klasa jest używana razem z SqlPipe programem 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. Utworzenie 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ść dla kolumny określonej przez porządkową Booleanjako .
GetByte(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Bytejako .
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Pobiera wartość dla kolumny określonej przez porządkową jako tablicę Byte obiektów.
GetChar(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Charjako .
GetChars(Int32, Int64, Char[], Int32, Int32)	Pobiera wartość dla 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ść dla kolumny określonej przez porządkową DateTimejako .
GetDateTimeOffset(Int32)	Zwraca dane określonej kolumny jako DateTimeOffset.
GetDecimal(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Decimaljako .
GetDouble(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Doublejako .
GetFieldType(Int32)	Type Zwraca obiekt reprezentujący typ środowiska uruchomieniowego języka wspólnego (CLR), który jest mapowany na typ SQL Server kolumny określonej przez `ordinal` argument.
GetFloat(Int32)	Pobiera wartość dla kolumny określonej przez porządkową `float`jako .
GetGuid(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Guidjako .
GetInt16(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Int16jako .
GetInt32(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Int32jako .
GetInt64(Int32)	Pobiera wartość dla kolumny określonej przez porządkową Int64jako .
GetName(Int32)	Zwraca nazwę kolumny określonej przez argument porządkowy.
GetOrdinal(String)	Zwraca liczbę porządkową kolumny określoną przez nazwę kolumny.
GetSqlBinary(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlBinaryjako .
GetSqlBoolean(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlBooleanjako .
GetSqlByte(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlBytejako .
GetSqlBytes(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlBytesjako .
GetSqlChars(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlCharsjako .
GetSqlDateTime(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlDateTimejako .
GetSqlDecimal(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlDecimaljako .
GetSqlDouble(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlDoublejako .
GetSqlFieldType(Int32)	Type Zwraca obiekt, który reprezentuje typ (jako typ SQL Server zdefiniowany w System.Data.SqlTypesobiekcie ), który mapuje na typ SQL Server kolumny.
GetSqlGuid(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlGuidjako .
GetSqlInt16(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlInt16jako .
GetSqlInt32(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlInt32jako .
GetSqlInt64(Int32)	Pobiera wartość dla 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ść dla kolumny określonej przez porządkową SqlMoneyjako .
GetSqlSingle(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlSinglejako .
GetSqlString(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlStringjako .
GetSqlValue(Int32)	Zwraca wartość danych przechowywaną w kolumnie wyrażoną jako typ SQL Server określony przez liczbę porządkową kolumny.
GetSqlValues(Object[])	Zwraca wartości dla wszystkich kolumn w rekordzie wyrażonych jako typy SQL Server w tablicy.
GetSqlXml(Int32)	Pobiera wartość dla kolumny określonej przez porządkową SqlXmljako .
GetString(Int32)	Pobiera wartość dla 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 DBNullwartość .
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.

Dotyczy