SqlDataRecord Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili satu baris data dan metadatanya.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Warisan
-
SqlDataRecord
- Penerapan
Contoh
Contoh berikut menunjukkan cara membuat beberapa SqlMetaData objek yang menjelaskan metadata kolom rekaman, lalu untuk membuat instans yang dapat digunakan SqlDataRecord kembali. Nilai SqlDataRecord kolom diatur dan sama SqlDataRecord dapat digunakan untuk mengalirkan beberapa baris ke SQL Server sebagai parameter bernilai tabel.
using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;
// Stream rows to SQL Server as a table-valued parameter.
public static IEnumerable<SqlDataRecord> CreateNewRecord()
{
// Re-use a single SqlDataRecord instance rather than allocating a new one for each row.
// Each row's values are read before SqlCommand advances to the next one.
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);
// Stream the first record to SQL Server.
yield return record;
// Set the fields of the second record and stream it to SQL Server.
record.SetInt32(1, 0);
yield return record;
}
Keterangan
Kelas ini menjelaskan satu baris parameter bernilai tabel. Buat satu dari array SqlMetaData objek yang menjelaskan metadata kolom rekaman, mengisinya dengan metode Atur<Jenis> , sertakan dalam IEnumerable<SqlDataRecord> dan tetapkan IEnumerable<SqlDataRecord> ke Value.
Untuk performa terbaik saat mengirim beberapa baris, gunakan kembali satu SqlDataRecord instans di seluruh iterator IEnumerable<SqlDataRecord> : atur nilai kolom baru dan yield return instans yang sama untuk setiap baris.
SqlCommand akan membaca setiap rekaman sebelum maju ke rekaman berikutnya.
Konstruktor
| Nama | Deskripsi |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Menginisialisasi instans baru SqlDataRecord dengan skema berdasarkan array SqlMetaData objek yang diteruskan sebagai argumen. |
Properti
| Nama | Deskripsi |
|---|---|
| FieldCount |
Mendapatkan jumlah kolom di baris data. Properti ini bersifat hanya dapat dibaca. |
| Item[Int32] |
Mendapatkan nilai jenis runtime bahasa umum (CLR) untuk kolom yang ditentukan oleh argumen kolom |
| Item[String] |
Mendapatkan nilai jenis runtime bahasa umum (CLR) untuk kolom yang ditentukan oleh argumen kolom |
Metode
| Nama | Deskripsi |
|---|---|
| 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 |
| GetFloat(Int32) |
Mendapatkan nilai untuk kolom yang ditentukan oleh ordinal sebagai Single. |
| 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) |
Mengembalikan Type objek yang mewakili jenis (sebagai jenis SQL Server, yang didefinisikan 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) |
Mengembalikan SqlMetaData objek, yang menjelaskan metadata kolom yang ditentukan oleh kolom ordinal. |
| 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 |
| 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 Single . |
| 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 kolom ordinal. |
| SetValues(Object[]) |
Mengatur nilai baru untuk semua kolom di SqlDataRecord. Nilai-nilai ini dinyatakan sebagai jenis runtime bahasa umum (CLR). |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IDataRecord.GetData(Int32) |
Tidak didukung dalam rilis ini. |