SqlDataRecord Sınıf

Başvuru

Tanım

Ad Alanı:: Microsoft.SqlServer.Server

Bütünleştirilmiş Kod:: System.Data.SqlClient.dll

Bütünleştirilmiş Kod:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.5

Ö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. Bu sınıf devralınamaz.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Devralma: Object
SqlDataRecord

Uygulamalar: IDataRecord

Örnekler

Aşağıdaki örnekte, bir kaydın sütun meta verilerini açıklayan birkaç SqlMetaData nesnenin nasıl oluşturulacağı ve bir oluşturma işlemi gösterilmektedir SqlDataRecord. sütun değerleri SqlDataRecord ayarlanır ve SqlDataRecord sınıfı kullanılarak SqlContext çağıran programa gönderilir.

[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

Açıklamalar

Bu sınıf, yönetilen kod saklı yordamlarından istemciye sonuç kümeleri göndermek için ile SqlPipe birlikte kullanılır.

Ortak dil çalışma zamanı (CLR) uygulamaları yazarken, her seferinde yenilerini oluşturmak yerine mevcut SqlDataRecord nesneleri yeniden kullanmanız gerekir. Çok sayıda yeni SqlDataRecord nesne oluşturmak, belleği ciddi ölçüde düşürebilir ve performansı olumsuz etkileyebilir.

Oluşturucular

SqlDataRecord(SqlMetaData[])

Bağımsız değişken olarak geçirilen nesne dizisini SqlMetaData temel alan şema ile yeni SqlDataRecord bir örneği başlatır.

Özellikler

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 `ordinal` belirtilen sütun için ortak dil çalışma zamanı (CLR) türü değerini alır.
Item[String]	Sütun bağımsız değişkeni tarafından `name` belirtilen sütun için ortak dil çalışma zamanı (CLR) türü değerini alır.

Yöntemler

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 `ordinal` belirtilen sütunun SQL Server türüyle eşleşen ortak dil çalışma zamanı (CLR) türünü temsil eden bir Type nesne döndürür.
GetFloat(Int32)	sıra ile belirtilen sütunun değerini olarak `float`alı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ı tarafından 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şleyen 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 nesnesi 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ıra 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ıralı parametresi tarafından belirtilen sütun null ise true 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 `float` 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ı

IDataRecord.GetData(Int32)

Bu sürümde desteklenmez.

Şunlara uygulanır

Aracılığıyla paylaş