SqlDataRecord Kelas

Definisi

Ruang nama:

Microsoft.Data.SqlClient.Server

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mewakili satu baris data dan metadatanya.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Warisan

Object

SqlDataRecord

Penerapan

IDataRecord

Contoh

Contoh berikut menunjukkan cara membuat beberapa SqlMetaData objek, yang menjelaskan metadata kolom rekaman, dan membuat SqlDataRecord. Nilai SqlDataRecord kolom diatur dan SqlDataRecord dikirim ke program panggilan dengan menggunakan SqlContext kelas .

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

Keterangan

Kelas ini digunakan bersama dengan SqlPipe untuk mengirim tataan hasil ke klien dari prosedur tersimpan kode terkelola.

Saat menulis aplikasi runtime bahasa umum (CLR), Anda harus menggunakan kembali objek yang ada SqlDataRecord alih-alih membuat yang baru setiap saat. Membuat banyak objek baru SqlDataRecord dapat sangat menguras memori dan berdampak buruk pada performa.

Konstruktor

SqlDataRecord(SqlMetaData[])

Memulai instans baru SqlDataRecord dengan skema berdasarkan array SqlMetaData objek yang diteruskan sebagai argumen.

Properti

FieldCount	Mendapatkan jumlah kolom dalam baris data. Properti ini bersifat hanya baca.
Item[Int32]	Mendapatkan nilai jenis runtime bahasa umum (CLR) untuk kolom yang ditentukan oleh argumen kolom ordinal .
Item[String]	Mendapatkan nilai jenis runtime bahasa umum (CLR) untuk kolom yang ditentukan oleh argumen kolom name .

Metode

GetBoolean(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Boolean.
GetByte(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai array Byte objek.
GetChar(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Char.
GetChars(Int32, Int64, Char[], Int32, Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai array Char objek.
GetDataTypeName(Int32)	Mengembalikan nama jenis data untuk kolom yang ditentukan oleh argumen ordinal.
GetDateTime(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai DateTime.
GetDateTimeOffset(Int32)	Mengembalikan data kolom yang ditentukan sebagai DateTimeOffset.
GetDecimal(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Decimal.
GetDouble(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Double.
GetFieldType(Int32)	Mengembalikan objek yang Type mewakili jenis runtime bahasa umum (CLR) yang memetakan ke jenis SQL Server kolom yang ditentukan oleh ordinal argumen.
GetFloat(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai float.
GetGuid(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Guid.
GetInt16(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Int16.
GetInt32(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Int32.
GetInt64(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Int64.
GetName(Int32)	Mengembalikan nama kolom yang ditentukan oleh argumen ordinal.
GetOrdinal(String)	Mengembalikan ordinal kolom yang ditentukan oleh nama kolom.
GetSqlBinary(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlBinary.
GetSqlBoolean(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlBoolean.
GetSqlByte(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlByte.
GetSqlBytes(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlBytes.
GetSqlChars(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlChars.
GetSqlDateTime(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlDateTime.
GetSqlDecimal(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlDecimal.
GetSqlDouble(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlDouble.
GetSqlFieldType(Int32)	Type Mengembalikan objek yang mewakili jenis (sebagai jenis SQL Server, ditentukan dalam System.Data.SqlTypes) yang memetakan ke jenis kolom SQL Server.
GetSqlGuid(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlGuid.
GetSqlInt16(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlInt16.
GetSqlInt32(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlInt32.
GetSqlInt64(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlInt64.
GetSqlMetaData(Int32)	SqlMetaData Mengembalikan objek, yang menjelaskan metadata kolom yang ditentukan oleh ordinal kolom.
GetSqlMoney(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlMoney.
GetSqlSingle(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlSingle.
GetSqlString(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlString.
GetSqlValue(Int32)	Mengembalikan nilai data yang disimpan dalam kolom, yang dinyatakan sebagai jenis SQL Server, yang ditentukan oleh kolom ordinal.
GetSqlValues(Object[])	Mengembalikan nilai untuk semua kolom dalam rekaman, yang dinyatakan sebagai jenis SQL Server, dalam array.
GetSqlXml(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai SqlXml.
GetString(Int32)	Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai String.
GetTimeSpan(Int32)	Mengembalikan data kolom yang ditentukan sebagai TimeSpan.
GetValue(Int32)	Mengembalikan nilai jenis runtime bahasa umum (CLR) untuk kolom yang ditentukan oleh argumen ordinal.
GetValues(Object[])	Mengembalikan nilai untuk semua kolom dalam rekaman, yang dinyatakan sebagai jenis runtime bahasa umum (CLR), dalam array.
IsDBNull(Int32)	Mengembalikan true jika kolom yang ditentukan oleh parameter ordinal kolom null.
SetBoolean(Int32, Boolean)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Boolean .
SetByte(Int32, Byte)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Byte .
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Mengatur data yang disimpan dalam kolom ke array Byte nilai yang ditentukan.
SetChar(Int32, Char)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Char .
SetChars(Int32, Int64, Char[], Int32, Int32)	Mengatur data yang disimpan dalam kolom ke array Char nilai yang ditentukan.
SetDateTime(Int32, DateTime)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan DateTime .
SetDateTimeOffset(Int32, DateTimeOffset)	Mengatur nilai kolom yang ditentukan ke DateTimeOffset nilai .
SetDBNull(Int32)	Mengatur nilai dalam kolom yang ditentukan ke DBNull.
SetDecimal(Int32, Decimal)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Decimal .
SetDouble(Int32, Double)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Double .
SetFloat(Int32, Single)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan float .
SetGuid(Int32, Guid)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Guid .
SetInt16(Int32, Int16)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Int16 .
SetInt32(Int32, Int32)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Int32 .
SetInt64(Int32, Int64)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan Int64 .
SetSqlBinary(Int32, SqlBinary)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlBinary .
SetSqlBoolean(Int32, SqlBoolean)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlBoolean .
SetSqlByte(Int32, SqlByte)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlByte .
SetSqlBytes(Int32, SqlBytes)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlBytes .
SetSqlChars(Int32, SqlChars)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlChars .
SetSqlDateTime(Int32, SqlDateTime)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlDateTime .
SetSqlDecimal(Int32, SqlDecimal)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlDecimal .
SetSqlDouble(Int32, SqlDouble)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlDouble .
SetSqlGuid(Int32, SqlGuid)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlGuid .
SetSqlInt16(Int32, SqlInt16)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlInt16 .
SetSqlInt32(Int32, SqlInt32)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlInt32 .
SetSqlInt64(Int32, SqlInt64)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlInt64 .
SetSqlMoney(Int32, SqlMoney)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlMoney .
SetSqlSingle(Int32, SqlSingle)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlSingle .
SetSqlString(Int32, SqlString)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlString .
SetSqlXml(Int32, SqlXml)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan SqlXml .
SetString(Int32, String)	Mengatur data yang disimpan dalam kolom ke nilai yang ditentukan String .
SetTimeSpan(Int32, TimeSpan)	Mengatur nilai kolom yang ditentukan ke TimeSpan.
SetValue(Int32, Object)	Mengatur nilai baru, yang dinyatakan sebagai jenis runtime bahasa umum (CLR), untuk kolom yang ditentukan oleh ordinal kolom.
SetValues(Object[])	Mengatur nilai baru untuk semua kolom di SqlDataRecord. Nilai-nilai ini dinyatakan sebagai jenis runtime bahasa umum (CLR).

Implementasi Antarmuka Eksplisit

IDataRecord.GetData(Int32)

Tidak didukung dalam rilis ini.