SqlDataRecord Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Tek bir veri satırını ve meta verilerini temsil eder.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Devralma
-
SqlDataRecord
- Uygulamalar
Örnekler
Aşağıdaki örnekte, bir kaydın sütun meta verilerini açıklayan birkaç SqlMetaData nesnenin nasıl oluşturulacağı ve ardından yeniden kullanılabilir bir örneğin nasıl oluşturulacağı gösterilmektedir SqlDataRecord . sütun değerleri SqlDataRecord ayarlanır ve aynı SqlDataRecord değer tablo değerli parametre olarak SQL Server için birden çok satırın akışını yapmak için kullanılabilir.
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;
}
Açıklamalar
Bu sınıf, tablo değerli bir parametrenin tek bir satırını açıklar. Kaydın SqlMetaData sütun meta verilerini açıklayan bir nesne dizisinden bir tane oluşturun, Bunu Tür> Ayarla< yöntemleriyle doldurun, bir öğesine IEnumerable<SqlDataRecord> ekleyin ve bunu öğesine ValueatayınIEnumerable<SqlDataRecord>.
Birden çok satır gönderirken en iyi performans için yineleyici genelinde tek SqlDataRecord bir IEnumerable<SqlDataRecord> örneği yeniden kullanın: her satır için yeni sütun değerleri ve yield return aynı örneği ayarlayın.
SqlCommand sonrakine geçmeden önce her kaydı okur.
Oluşturucular
| Veri Akışı Adı | Description |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Bağımsız değişken olarak geçirilen nesne dizisini SqlMetaData temel alarak şemayla yeni SqlDataRecord bir örnek başlatır. |
Özellikler
| Veri Akışı Adı | Description |
|---|---|
| FieldCount |
Veri satırındaki sütun sayısını alır. Bu özellik salt okunur durumdadır. |
| Item[Int32] |
Sütun bağımsız değişkeni tarafından |
| Item[String] |
Sütun bağımsız değişkeni tarafından |
Yöntemler
| Veri Akışı Adı | Description |
|---|---|
| GetBoolean(Int32) |
sıra ile belirtilen sütunun değerini olarak Booleanalır. |
| GetByte(Int32) |
sıra ile belirtilen sütunun değerini olarak Bytealır. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Sıra tarafından bir nesne dizisi olarak belirtilen sütunun Byte değerini alır. |
| GetChar(Int32) |
sıra ile belirtilen sütunun değerini olarak Charalır. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Sıra tarafından bir nesne dizisi olarak belirtilen sütunun Char değerini alır. |
| GetDataTypeName(Int32) |
Sıralı bağımsız değişkeni tarafından belirtilen sütunun veri türünün adını döndürür. |
| GetDateTime(Int32) |
sıra ile belirtilen sütunun değerini olarak DateTimealır. |
| GetDateTimeOffset(Int32) |
Belirtilen sütunun verilerini olarak DateTimeOffsetdöndürür. |
| GetDecimal(Int32) |
sıra ile belirtilen sütunun değerini olarak Decimalalır. |
| GetDouble(Int32) |
sıra ile belirtilen sütunun değerini olarak Doublealır. |
| GetFieldType(Int32) |
Bağımsız değişken tarafından |
| GetFloat(Int32) |
sıra ile belirtilen sütunun değerini olarak Singlealır. |
| GetGuid(Int32) |
sıra ile belirtilen sütunun değerini olarak Guidalır. |
| GetInt16(Int32) |
sıra ile belirtilen sütunun değerini olarak Int16alır. |
| GetInt32(Int32) |
sıra ile belirtilen sütunun değerini olarak Int32alır. |
| GetInt64(Int32) |
sıra ile belirtilen sütunun değerini olarak Int64alır. |
| GetName(Int32) |
Sıralı bağımsız değişkeni tarafından belirtilen sütunun adını döndürür. |
| GetOrdinal(String) |
Sütun adıyla belirtilen sütun sırasını döndürür. |
| GetSqlBinary(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlBinaryalır. |
| GetSqlBoolean(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlBooleanalır. |
| GetSqlByte(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlBytealır. |
| GetSqlBytes(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlBytesalır. |
| GetSqlChars(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlCharsalır. |
| GetSqlDateTime(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlDateTimealır. |
| GetSqlDecimal(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlDecimalalır. |
| GetSqlDouble(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlDoublealır. |
| GetSqlFieldType(Int32) |
Sütunun SQL Server türüyle eşleşen türü (içinde System.Data.SqlTypestanımlanan SQL Server türü olarak) temsil eden bir Type nesne döndürür. |
| GetSqlGuid(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlGuidalır. |
| GetSqlInt16(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlInt16alır. |
| GetSqlInt32(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlInt32alır. |
| GetSqlInt64(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlInt64alır. |
| GetSqlMetaData(Int32) |
Sütun sıralı tarafından belirtilen sütunun meta verilerini açıklayan bir SqlMetaData nesne döndürür. |
| GetSqlMoney(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlMoneyalır. |
| GetSqlSingle(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlSinglealır. |
| GetSqlString(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlStringalır. |
| GetSqlValue(Int32) |
Sütunda depolanan ve sütun sıralı tarafından belirtilen SQL Server türü olarak ifade edilen veri değerini döndürür. |
| GetSqlValues(Object[]) |
Bir dizideki SQL Server türleri olarak ifade edilen kayıttaki tüm sütunların değerlerini döndürür. |
| GetSqlXml(Int32) |
sıra ile belirtilen sütunun değerini olarak SqlXmlalır. |
| GetString(Int32) |
sıra ile belirtilen sütunun değerini olarak Stringalır. |
| GetTimeSpan(Int32) |
Belirtilen sütunun verilerini olarak TimeSpandöndürür. |
| GetValue(Int32) |
Sıralı bağımsız değişkeni tarafından belirtilen sütun için ortak dil çalışma zamanı (CLR) türü değerini döndürür. |
| GetValues(Object[]) |
Bir dizideki ortak dil çalışma zamanı (CLR) türleri olarak ifade edilen kayıttaki tüm sütunların değerlerini döndürür. |
| IsDBNull(Int32) |
Sütun sıra parametresi tarafından belirtilen sütun null ise döndürür |
| SetBoolean(Int32, Boolean) |
Sütunda depolanan verileri belirtilen Boolean değere ayarlar. |
| SetByte(Int32, Byte) |
Sütunda depolanan verileri belirtilen Byte değere ayarlar. |
| SetBytes(Int32, Int64, Byte[], Int32, Int32) |
Sütunda depolanan verileri belirtilen değer dizisine Byte ayarlar. |
| SetChar(Int32, Char) |
Sütunda depolanan verileri belirtilen Char değere ayarlar. |
| SetChars(Int32, Int64, Char[], Int32, Int32) |
Sütunda depolanan verileri belirtilen değer dizisine Char ayarlar. |
| SetDateTime(Int32, DateTime) |
Sütunda depolanan verileri belirtilen DateTime değere ayarlar. |
| SetDateTimeOffset(Int32, DateTimeOffset) |
Belirtilen DateTimeOffset sütunun değerini değerine ayarlar. |
| SetDBNull(Int32) |
Belirtilen sütundaki değeri olarak DBNullayarlar. |
| SetDecimal(Int32, Decimal) |
Sütunda depolanan verileri belirtilen Decimal değere ayarlar. |
| SetDouble(Int32, Double) |
Sütunda depolanan verileri belirtilen Double değere ayarlar. |
| SetFloat(Int32, Single) |
Sütunda depolanan verileri belirtilen Single değere ayarlar. |
| SetGuid(Int32, Guid) |
Sütunda depolanan verileri belirtilen Guid değere ayarlar. |
| SetInt16(Int32, Int16) |
Sütunda depolanan verileri belirtilen Int16 değere ayarlar. |
| SetInt32(Int32, Int32) |
Sütunda depolanan verileri belirtilen Int32 değere ayarlar. |
| SetInt64(Int32, Int64) |
Sütunda depolanan verileri belirtilen Int64 değere ayarlar. |
| SetSqlBinary(Int32, SqlBinary) |
Sütunda depolanan verileri belirtilen SqlBinary değere ayarlar. |
| SetSqlBoolean(Int32, SqlBoolean) |
Sütunda depolanan verileri belirtilen SqlBoolean değere ayarlar. |
| SetSqlByte(Int32, SqlByte) |
Sütunda depolanan verileri belirtilen SqlByte değere ayarlar. |
| SetSqlBytes(Int32, SqlBytes) |
Sütunda depolanan verileri belirtilen SqlBytes değere ayarlar. |
| SetSqlChars(Int32, SqlChars) |
Sütunda depolanan verileri belirtilen SqlChars değere ayarlar. |
| SetSqlDateTime(Int32, SqlDateTime) |
Sütunda depolanan verileri belirtilen SqlDateTime değere ayarlar. |
| SetSqlDecimal(Int32, SqlDecimal) |
Sütunda depolanan verileri belirtilen SqlDecimal değere ayarlar. |
| SetSqlDouble(Int32, SqlDouble) |
Sütunda depolanan verileri belirtilen SqlDouble değere ayarlar. |
| SetSqlGuid(Int32, SqlGuid) |
Sütunda depolanan verileri belirtilen SqlGuid değere ayarlar. |
| SetSqlInt16(Int32, SqlInt16) |
Sütunda depolanan verileri belirtilen SqlInt16 değere ayarlar. |
| SetSqlInt32(Int32, SqlInt32) |
Sütunda depolanan verileri belirtilen SqlInt32 değere ayarlar. |
| SetSqlInt64(Int32, SqlInt64) |
Sütunda depolanan verileri belirtilen SqlInt64 değere ayarlar. |
| SetSqlMoney(Int32, SqlMoney) |
Sütunda depolanan verileri belirtilen SqlMoney değere ayarlar. |
| SetSqlSingle(Int32, SqlSingle) |
Sütunda depolanan verileri belirtilen SqlSingle değere ayarlar. |
| SetSqlString(Int32, SqlString) |
Sütunda depolanan verileri belirtilen SqlString değere ayarlar. |
| SetSqlXml(Int32, SqlXml) |
Sütunda depolanan verileri belirtilen SqlXml değere ayarlar. |
| SetString(Int32, String) |
Sütunda depolanan verileri belirtilen String değere ayarlar. |
| SetTimeSpan(Int32, TimeSpan) |
Belirtilen sütunun değerini olarak TimeSpanayarlar. |
| SetValue(Int32, Object) |
Sütun sıralı tarafından belirtilen sütun için ortak dil çalışma zamanı (CLR) türü olarak ifade edilen yeni bir değer ayarlar. |
| SetValues(Object[]) |
içindeki SqlDataRecordtüm sütunlar için yeni değerler ayarlar. Bu değerler ortak dil çalışma zamanı (CLR) türleri olarak ifade edilir. |
Belirtik Arabirim Kullanımları
| Veri Akışı Adı | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Bu sürümde desteklenmez. |