SqlDataRecord Klasse

Definition

Namespace:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Stellt eine einzelne Datenzeile und ihre Metadaten dar. Diese Klasse kann nicht vererbt werden.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Vererbung

Object

SqlDataRecord

Implementiert

IDataRecord

Beispiele

Das folgende Beispiel zeigt, wie Sie mehrere SqlMetaData -Objekte erstellen, die die Spaltenmetadaten eines Datensatzes beschreiben, und eine SqlDataRecorderstellen. Die Spaltenwerte des SqlDataRecord werden festgelegt, und das SqlDataRecord wird mithilfe der -Klasse an das SqlContext aufrufende Programm gesendet.

[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

Hinweise

Diese Klasse wird zusammen mit SqlPipe verwendet, um Resultsets aus gespeicherten Prozeduren mit verwaltetem Code an den Client zu senden.

Beim Schreiben von CLR-Anwendungen (Common Language Runtime) sollten Sie vorhandene SqlDataRecord Objekte erneut verwenden, anstatt jedes Mal neue Objekte zu erstellen. Das Erstellen vieler neuer SqlDataRecord Objekte könnte zu einer erheblichen Auslastung des Arbeitsspeichers und zu negativen Auswirkungen auf die Leistung führen.

Konstruktoren

SqlDataRecord(SqlMetaData[])

Initialisiert eine neue SqlDataRecord-Instanz mit dem Schema auf Grundlage des Arrays von SqlMetaData-Objekten, die als Argument übergeben werden.

Eigenschaften

FieldCount	Ruft die Anzahl der Spalten in der Datenzeile ab. Diese Eigenschaft ist schreibgeschützt.
Item[Int32]	Ruft den CLR-Typwert (Common Language Runtime) für die durch das ordinal-Argument angegebene Spalte ab.
Item[String]	Ruft den CLR-Typwert (Common Language Runtime) für die durch das name-Argument angegebene Spalte ab.

Methoden

GetBoolean(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Boolean ab.
GetByte(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Byte ab.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Byte-Objekten ab.
GetChar(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Char ab.
GetChars(Int32, Int64, Char[], Int32, Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.
GetDataTypeName(Int32)	Gibt den Namen des Datentyps der durch das Ordnungszahlargument angegebenen Spalte zurück.
GetDateTime(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als DateTime ab.
GetDateTimeOffset(Int32)	Gibt die Daten in der angegebenen Spalte als DateTimeOffset zurück.
GetDecimal(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Decimal ab.
GetDouble(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Double ab.
GetFieldType(Int32)	Gibt ein Type-Objekt zurück, das den CLR-Typ (Common Language Runtime) darstellt, der dem SQL Server-Typ zugeordnet ist, der durch das ordinal-Argument angegeben ist.
GetFloat(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als float ab.
GetGuid(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Guid ab.
GetInt16(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int16 ab.
GetInt32(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int32 ab.
GetInt64(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int64 ab.
GetName(Int32)	Gibt den Namen der durch das Ordnungszahlargument angegebenen Spalte zurück.
GetOrdinal(String)	Gibt die durch den Spaltennamen angegebene Ordnungszahl der Spalte zurück.
GetSqlBinary(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBinary ab.
GetSqlBoolean(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBoolean ab.
GetSqlByte(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlByte ab.
GetSqlBytes(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBytes ab.
GetSqlChars(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlChars ab.
GetSqlDateTime(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDateTime ab.
GetSqlDecimal(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDecimal ab.
GetSqlDouble(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDouble ab.
GetSqlFieldType(Int32)	Gibt ein Type-Objekt zurück, das den Typ darstellt (als einen in System.Data.SqlTypes definierter SQL Server-Typ), der dem SQL Server-Typ der Spalte zugeordnet wird.
GetSqlGuid(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlGuid ab.
GetSqlInt16(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt16 ab.
GetSqlInt32(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt32 ab.
GetSqlInt64(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt64 ab.
GetSqlMetaData(Int32)	Gibt ein SqlMetaData-Objekt zurück, das die Metadaten der Spalte beschreibt, die von der Spaltenordnungszahl angegeben wird.
GetSqlMoney(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlMoney ab.
GetSqlSingle(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlSingle ab.
GetSqlString(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlString ab.
GetSqlValue(Int32)	Gibt den gespeicherten Datenwert in der Spalte, die durch die Spaltenordnungszahl angegeben ist, als SQL Server-Typ ausgedrückt zurück.
GetSqlValues(Object[])	Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als SQL Server-Typen, in einem Array zurück.
GetSqlXml(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlXml ab.
GetString(Int32)	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als String ab.
GetTimeSpan(Int32)	Gibt die Daten in der angegebenen Spalte als TimeSpan zurück.
GetValue(Int32)	Gibt den CLR-Typwert (Common Language Runtime) für die durch das Ordnungszahlargument angegebene Spalte zurück.
GetValues(Object[])	Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als CLR-Typen (Common Language Runtime), in ein Array zurück.
IsDBNull(Int32)	Gibt "true" zurück, wenn die durch den Parameter für die Spaltenordnungszahl angegebene Spalte null ist.
SetBoolean(Int32, Boolean)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Boolean-Wert fest.
SetByte(Int32, Byte)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Byte-Wert fest.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Byte-Werten fest.
SetChar(Int32, Char)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Char-Wert fest.
SetChars(Int32, Int64, Char[], Int32, Int32)	Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Char-Werten fest.
SetDateTime(Int32, DateTime)	Legt die in der Spalte gespeicherten Daten auf den angegebenen DateTime-Wert fest.
SetDateTimeOffset(Int32, DateTimeOffset)	Legt den Wert der angegebenen Spalte auf den DateTimeOffset-Wert fest.
SetDBNull(Int32)	Legt den Wert in der angegebenen Spalte auf DBNull fest.
SetDecimal(Int32, Decimal)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Decimal-Wert fest.
SetDouble(Int32, Double)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Double-Wert fest.
SetFloat(Int32, Single)	Legt die in der Spalte gespeicherten Daten auf den angegebenen float-Wert fest.
SetGuid(Int32, Guid)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Guid-Wert fest.
SetInt16(Int32, Int16)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Int16-Wert fest.
SetInt32(Int32, Int32)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Int32-Wert fest.
SetInt64(Int32, Int64)	Legt die in der Spalte gespeicherten Daten auf den angegebenen Int64-Wert fest.
SetSqlBinary(Int32, SqlBinary)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBinary-Wert fest.
SetSqlBoolean(Int32, SqlBoolean)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBoolean-Wert fest.
SetSqlByte(Int32, SqlByte)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlByte-Wert fest.
SetSqlBytes(Int32, SqlBytes)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBytes-Wert fest.
SetSqlChars(Int32, SqlChars)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlChars-Wert fest.
SetSqlDateTime(Int32, SqlDateTime)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDateTime-Wert fest.
SetSqlDecimal(Int32, SqlDecimal)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDecimal-Wert fest.
SetSqlDouble(Int32, SqlDouble)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDouble-Wert fest.
SetSqlGuid(Int32, SqlGuid)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlGuid-Wert fest.
SetSqlInt16(Int32, SqlInt16)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt16-Wert fest.
SetSqlInt32(Int32, SqlInt32)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt32-Wert fest.
SetSqlInt64(Int32, SqlInt64)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt64-Wert fest.
SetSqlMoney(Int32, SqlMoney)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlMoney-Wert fest.
SetSqlSingle(Int32, SqlSingle)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlSingle-Wert fest.
SetSqlString(Int32, SqlString)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlString-Wert fest.
SetSqlXml(Int32, SqlXml)	Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlXml-Wert fest.
SetString(Int32, String)	Legt die in der Spalte gespeicherten Daten auf den angegebenen String-Wert fest.
SetTimeSpan(Int32, TimeSpan)	Legt den Wert der angegebenen Spalte auf TimeSpan fest.
SetValue(Int32, Object)	Legt einen neuen Wert fest, der als CLR-Typwert (Common Language Runtime) für die Spalte ausgedrückt wird, die von der Spaltenordnungszahl angegeben wird.
SetValues(Object[])	Legt neue Werte für alle Spalten im SqlDataRecord fest. Diese Werte werden in Form von CLR-Typen (Common Language Runtime) ausgedrückt.

Explizite Schnittstellenimplementierungen

IDataRecord.GetData(Int32)

Wird in dieser Version nicht unterstützt.