SqlDataRecord Klasse

Definition

Stellt eine einzelne Datenzeile und ihre Metadaten dar.Represents a single row of data and its metadata. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class SqlDataRecord : System::Data::IDataRecord
public class SqlDataRecord : System.Data.IDataRecord
type SqlDataRecord = class
    interface IDataRecord
Public Class SqlDataRecord
Implements IDataRecord
Vererbung
SqlDataRecord
Implementiert

Beispiele

Im folgenden Beispiel wird gezeigt, wie mehrere SqlMetaData -Objekte erstellt werden, die die Spalten Metadaten eines Datensatzes beschreiben und SqlDataRecordeinen erstellen.The following example shows how to create several SqlMetaData objects, which describe the column metadata of a record, and creating a SqlDataRecord. Die Spaltenwerte der SqlDataRecord werden festgelegt, und der SqlDataRecord wird mithilfe der SqlContext -Klasse an das aufrufenden Programm gesendet.The column values of the SqlDataRecord are set and the SqlDataRecord is sent to the calling program by using the SqlContext class.

[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 in Verbindung mit SqlPipe verwendet, um Resultsets aus gespeicherten gespeicherten Code Prozeduren an den Client zu senden.This class is used together with SqlPipe to send result sets to the client from managed code stored-procedures.

Beim Schreiben von Common Language Runtime (CLR)-Anwendungen sollten Sie vorhandene SqlDataRecord Objekte wieder verwenden, anstatt jedes Mal neue Objekte zu erstellen.When writing common language runtime (CLR) applications, you should re-use existing SqlDataRecord objects instead of creating new ones every time. Durch das Erstellen SqlDataRecord vieler neuer Objekte kann der Arbeitsspeicher erheblich beeinträchtigt und die Leistung beeinträchtigt werden.Creating many new SqlDataRecord objects could severely deplete memory and adversely affect performance.

Konstruktoren

SqlDataRecord(SqlMetaData[])

Initialisiert eine neue SqlDataRecord-Instanz mit dem Schema auf Grundlage des Arrays von SqlMetaData-Objekten, die als Argument übergeben werden.Inititializes a new SqlDataRecord instance with the schema based on the array of SqlMetaData objects passed as an argument.

Eigenschaften

FieldCount

Ruft die Anzahl der Spalten in der Datenzeile ab.Gets the number of columns in the data row. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

Item[Int32]

Ruft den CLR-Typwert (Common Language Runtime) für die durch das ordinal-Argument angegebene Spalte ab.Gets the common language runtime (CLR) type value for the column specified by the column ordinal argument.

Item[String]

Ruft den CLR-Typwert (Common Language Runtime) für die durch das name-Argument angegebene Spalte ab.Gets the common language runtime (CLR) type value for the column specified by the column name argument.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetBoolean(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Boolean ab.Gets the value for the column specified by the ordinal as a Boolean.

GetByte(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Byte ab.Gets the value for the column specified by the ordinal as a Byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Byte-Objekten ab.Gets the value for the column specified by the ordinal as an array of Byte objects.

GetChar(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Char ab.Gets the value for the column specified by the ordinal as a Char.

GetChars(Int32, Int64, Char[], Int32, Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.Gets the value for the column specified by the ordinal as an array of Char objects.

GetData(Int32)
GetDataTypeName(Int32)

Gibt den Namen des Datentyps der durch das Ordnungszahlargument angegebenen Spalte zurück.Returns the name of the data type for the column specified by the ordinal argument.

GetDateTime(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als DateTime ab.Gets the value for the column specified by the ordinal as a DateTime.

GetDateTimeOffset(Int32)

Gibt die Daten in der angegebenen Spalte als DateTimeOffset zurück.Returns the specified column's data as a DateTimeOffset.

GetDecimal(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Decimal ab.Gets the value for the column specified by the ordinal as a Decimal.

GetDouble(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Double ab.Gets the value for the column specified by the ordinal as a Double.

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.Returns a Type object representing the common language runtime (CLR) type that maps to the SQL Server type of the column specified by the ordinal argument.

GetFloat(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als float ab.Gets the value for the column specified by the ordinal as a float.

GetGuid(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Guid ab.Gets the value for the column specified by the ordinal as a Guid.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetInt16(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int16 ab.Gets the value for the column specified by the ordinal as a Int16.

GetInt32(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int32 ab.Gets the value for the column specified by the ordinal as a Int32.

GetInt64(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int64 ab.Gets the value for the column specified by the ordinal as a Int64.

GetName(Int32)

Gibt den Namen der durch das Ordnungszahlargument angegebenen Spalte zurück.Returns the name of the column specified by the ordinal argument.

GetOrdinal(String)

Gibt die durch den Spaltennamen angegebene Ordnungszahl der Spalte zurück.Returns the column ordinal specified by the column name.

GetSqlBinary(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBinary ab.Gets the value for the column specified by the ordinal as a SqlBinary.

GetSqlBoolean(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBoolean ab.Gets the value for the column specified by the ordinal as a SqlBoolean.

GetSqlByte(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlByte ab.Gets the value for the column specified by the ordinal as a SqlByte.

GetSqlBytes(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBytes ab.Gets the value for the column specified by the ordinal as a SqlBytes.

GetSqlChars(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlChars ab.Gets the value for the column specified by the ordinal as a SqlChars.

GetSqlDateTime(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDateTime ab.Gets the value for the column specified by the ordinal as a SqlDateTime.

GetSqlDecimal(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDecimal ab.Gets the value for the column specified by the ordinal as a SqlDecimal.

GetSqlDouble(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDouble ab.Gets the value for the column specified by the ordinal as a SqlDouble.

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.Returns a Type object that represents the type (as a SQL Server type, defined in System.Data.SqlTypes) that maps to the SQL Server type of the column.

GetSqlGuid(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlGuid ab.Gets the value for the column specified by the ordinal as a SqlGuid.

GetSqlInt16(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt16 ab.Gets the value for the column specified by the ordinal as a SqlInt16.

GetSqlInt32(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt32 ab.Gets the value for the column specified by the ordinal as a SqlInt32.

GetSqlInt64(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt64 ab.Gets the value for the column specified by the ordinal as a SqlInt64.

GetSqlMetaData(Int32)

Gibt ein SqlMetaData-Objekt zurück, das die Metadaten der Spalte beschreibt, die von der Spaltenordnungszahl angegeben wird.Returns a SqlMetaData object, describing the metadata of the column specified by the column ordinal.

GetSqlMoney(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlMoney ab.Gets the value for the column specified by the ordinal as a SqlMoney.

GetSqlSingle(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlSingle ab.Gets the value for the column specified by the ordinal as a SqlSingle.

GetSqlString(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlString ab.Gets the value for the column specified by the ordinal as a SqlString.

GetSqlValue(Int32)

Gibt den gespeicherten Datenwert in der Spalte, die durch die Spaltenordnungszahl angegeben ist, als SQL Server-Typ ausgedrückt zurück.Returns the data value stored in the column, expressed as a SQL Server type, specified by the column ordinal.

GetSqlValues(Object[])

Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als SQL Server-Typen, in einem Array zurück.Returns the values for all the columns in the record, expressed as SQL Server types, in an array.

GetSqlXml(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlXml ab.Gets the value for the column specified by the ordinal as a SqlXml.

GetString(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als String ab.Gets the value for the column specified by the ordinal as a String.

GetTimeSpan(Int32)

Gibt die Daten in der angegebenen Spalte als TimeSpan zurück.Returns the specified column's data as a TimeSpan.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(Int32)

Gibt den CLR-Typwert (Common Language Runtime) für die durch das Ordnungszahlargument angegebene Spalte zurück.Returns the common language runtime (CLR) type value for the column specified by the ordinal argument.

GetValues(Object[])

Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als CLR-Typen (Common Language Runtime), in ein Array zurück.Returns the values for all the columns in the record, expressed as common language runtime (CLR) types, in an array.

IsDBNull(Int32)

Gibt "true" zurück, wenn die durch den Parameter für die Spaltenordnungszahl angegebene Spalte null ist.Returns true if the column specified by the column ordinal parameter is null.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SetBoolean(Int32, Boolean)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Boolean-Wert fest.Sets the data stored in the column to the specified Boolean value.

SetByte(Int32, Byte)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Byte-Wert fest.Sets the data stored in the column to the specified Byte value.

SetBytes(Int32, Int64, Byte[], Int32, Int32)

Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Byte-Werten fest.Sets the data stored in the column to the specified array of Byte values.

SetChar(Int32, Char)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Char-Wert fest.Sets the data stored in the column to the specified Char value.

SetChars(Int32, Int64, Char[], Int32, Int32)

Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Char-Werten fest.Sets the data stored in the column to the specified array of Char values.

SetDateTime(Int32, DateTime)

Legt die in der Spalte gespeicherten Daten auf den angegebenen DateTime-Wert fest.Sets the data stored in the column to the specified DateTime value.

SetDateTimeOffset(Int32, DateTimeOffset)

Legt den Wert der angegebenen Spalte auf den DateTimeOffset-Wert fest.Sets the value of the column specified to the DateTimeOffset value.

SetDBNull(Int32)

Legt den Wert in der angegebenen Spalte auf DBNull fest.Sets the value in the specified column to DBNull.

SetDecimal(Int32, Decimal)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Decimal-Wert fest.Sets the data stored in the column to the specified Decimal value.

SetDouble(Int32, Double)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Double-Wert fest.Sets the data stored in the column to the specified Double value.

SetFloat(Int32, Single)

Legt die in der Spalte gespeicherten Daten auf den angegebenen float-Wert fest.Sets the data stored in the column to the specified float value.

SetGuid(Int32, Guid)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Guid-Wert fest.Sets the data stored in the column to the specified Guid value.

SetInt16(Int32, Int16)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int16-Wert fest.Sets the data stored in the column to the specified Int16 value.

SetInt32(Int32, Int32)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int32-Wert fest.Sets the data stored in the column to the specified Int32 value.

SetInt64(Int32, Int64)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int64-Wert fest.Sets the data stored in the column to the specified Int64 value.

SetSqlBinary(Int32, SqlBinary)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBinary-Wert fest.Sets the data stored in the column to the specified SqlBinary value.

SetSqlBoolean(Int32, SqlBoolean)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBoolean-Wert fest.Sets the data stored in the column to the specified SqlBoolean value.

SetSqlByte(Int32, SqlByte)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlByte-Wert fest.Sets the data stored in the column to the specified SqlByte value.

SetSqlBytes(Int32, SqlBytes)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBytes-Wert fest.Sets the data stored in the column to the specified SqlBytes value.

SetSqlChars(Int32, SqlChars)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlChars-Wert fest.Sets the data stored in the column to the specified SqlChars value.

SetSqlDateTime(Int32, SqlDateTime)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDateTime-Wert fest.Sets the data stored in the column to the specified SqlDateTime value.

SetSqlDecimal(Int32, SqlDecimal)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDecimal-Wert fest.Sets the data stored in the column to the specified SqlDecimal value.

SetSqlDouble(Int32, SqlDouble)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDouble-Wert fest.Sets the data stored in the column to the specified SqlDouble value.

SetSqlGuid(Int32, SqlGuid)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlGuid-Wert fest.Sets the data stored in the column to the specified SqlGuid value.

SetSqlInt16(Int32, SqlInt16)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt16-Wert fest.Sets the data stored in the column to the specified SqlInt16 value.

SetSqlInt32(Int32, SqlInt32)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt32-Wert fest.Sets the data stored in the column to the specified SqlInt32 value.

SetSqlInt64(Int32, SqlInt64)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt64-Wert fest.Sets the data stored in the column to the specified SqlInt64 value.

SetSqlMoney(Int32, SqlMoney)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlMoney-Wert fest.Sets the data stored in the column to the specified SqlMoney value.

SetSqlSingle(Int32, SqlSingle)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlSingle-Wert fest.Sets the data stored in the column to the specified SqlSingle value.

SetSqlString(Int32, SqlString)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlString-Wert fest.Sets the data stored in the column to the specified SqlString value.

SetSqlXml(Int32, SqlXml)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlXml-Wert fest.Sets the data stored in the column to the specified SqlXml value.

SetString(Int32, String)

Legt die in der Spalte gespeicherten Daten auf den angegebenen String-Wert fest.Sets the data stored in the column to the specified String value.

SetTimeSpan(Int32, TimeSpan)

Legt den Wert der angegebenen Spalte auf TimeSpan fest.Sets the value of the column specified to the TimeSpan.

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.Sets a new value, expressed as a common language runtime (CLR) type, for the column specified by the column ordinal.

SetValues(Object[])

Legt neue Werte für alle Spalten im SqlDataRecord fest.Sets new values for all of the columns in the SqlDataRecord. Diese Werte werden in Form von CLR-Typen (Common Language Runtime) ausgedrückt.These values are expressed as common language runtime (CLR) types.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDataRecord.GetData(Int32)

Wird in dieser Version nicht unterstützt.Not supported in this release.

Gilt für: