Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SqlDataRecord-Klasse

 

Veröffentlicht: Oktober 2016

Stellt eine einzelne Zeile mit Daten und die zugehörigen Metadaten dar. Diese Klasse kann nicht vererbt werden.

Namespace:   Microsoft.SqlServer.Server
Assembly:  System.Data (in System.Data.dll)

System.Object
  Microsoft.SqlServer.Server.SqlDataRecord

public class SqlDataRecord : IDataRecord

NameBeschreibung
System_CAPS_pubmethodSqlDataRecord(SqlMetaData[])

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

NameBeschreibung
System_CAPS_pubpropertyFieldCount

Ruft die Anzahl der Spalten in der Datenzeile ab. Diese Eigenschaft ist schreibgeschützt.

System_CAPS_pubpropertyItem[Int32]

Ruft den CLR-Typwert (Common Language Runtime) für die durch das ordinal-Argument angegebene Spalte ab.

System_CAPS_pubpropertyItem[String]

Ruft den CLR-Typwert (Common Language Runtime) für die durch das name-Argument angegebene Spalte ab.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetBoolean(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Boolean ab.

System_CAPS_pubmethodGetByte(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Byte ab.

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

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Byte-Objekten ab.

System_CAPS_pubmethodGetChar(Int32)

Ruft den Wert für die Spalte ab, die durch die Ordnungszahl als Char angegeben ist.

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

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.

System_CAPS_pubmethodGetDataTypeName(Int32)

Gibt den Namen des Datentyps der durch das Ordnungszahlargument angegebenen Spalte zurück.

System_CAPS_pubmethodGetDateTime(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als DateTime ab.

System_CAPS_pubmethodGetDateTimeOffset(Int32)

Gibt die Daten in der angegebenen Spalte als DateTimeOffset zurück.

System_CAPS_pubmethodGetDecimal(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Decimal ab.

System_CAPS_pubmethodGetDouble(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Double ab.

System_CAPS_pubmethodGetFieldType(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.

System_CAPS_pubmethodGetFloat(Int32)

Ruft den Wert für die Spalte ab, die durch die Ordnungszahl als float angegeben ist.

System_CAPS_pubmethodGetGuid(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Guid ab.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetInt16(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int16 ab.

System_CAPS_pubmethodGetInt32(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int32 ab.

System_CAPS_pubmethodGetInt64(Int32)

Ruft den Wert für die Spalte ab, die durch die Ordnungszahl als Int64 angegeben ist.

System_CAPS_pubmethodGetName(Int32)

Gibt den Namen der durch das Ordnungszahlargument angegebenen Spalte zurück.

System_CAPS_pubmethodGetOrdinal(String)

Gibt die durch den Spaltennamen angegebene Ordnungszahl der Spalte zurück.

System_CAPS_pubmethodGetSqlBinary(Int32)

Ruft den Wert für die Spalte ab, die durch die Ordnungszahl als SqlBinary angegeben ist.

System_CAPS_pubmethodGetSqlBoolean(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBoolean ab.

System_CAPS_pubmethodGetSqlByte(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlByte ab.

System_CAPS_pubmethodGetSqlBytes(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBytes ab.

System_CAPS_pubmethodGetSqlChars(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlChars ab.

System_CAPS_pubmethodGetSqlDateTime(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDateTime ab.

System_CAPS_pubmethodGetSqlDecimal(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDecimal ab.

System_CAPS_pubmethodGetSqlDouble(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDouble ab.

System_CAPS_pubmethodGetSqlFieldType(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.

System_CAPS_pubmethodGetSqlGuid(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlGuid ab.

System_CAPS_pubmethodGetSqlInt16(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt16 ab.

System_CAPS_pubmethodGetSqlInt32(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt32 ab.

System_CAPS_pubmethodGetSqlInt64(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt64 ab.

System_CAPS_pubmethodGetSqlMetaData(Int32)

Gibt ein SqlMetaData-Objekt zurück, das die Metadaten der Spalte beschreibt, die von der Spaltenordnungszahl angegeben wird.

System_CAPS_pubmethodGetSqlMoney(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlMoney ab.

System_CAPS_pubmethodGetSqlSingle(Int32)

Ruft den Wert für die Spalte ab, die durch die Ordnungszahl als SqlSingle angegeben ist.

System_CAPS_pubmethodGetSqlString(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlString ab.

System_CAPS_pubmethodGetSqlValue(Int32)

Gibt den gespeicherten Datenwert in der Spalte, die durch die Spaltenordnungszahl angegeben ist, als SQL Server-Typ ausgedrückt zurück.

System_CAPS_pubmethodGetSqlValues(Object[])

Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als SQL Server-Typen, in einem Array zurück.

System_CAPS_pubmethodGetSqlXml(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlXml ab.

System_CAPS_pubmethodGetString(Int32)

Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als String ab.

System_CAPS_pubmethodGetTimeSpan(Int32)

Gibt die Daten in der angegebenen Spalte als TimeSpan zurück.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetValue(Int32)

Gibt den CLR-Typwert (Common Language Runtime) für die durch das Ordnungszahlargument angegebene Spalte zurück.

System_CAPS_pubmethodGetValues(Object[])

Gibt die Werte für alle Spalten im Datensatz, ausgedrückt als CLR-Typen (Common Language Runtime), in ein Array zurück.

System_CAPS_pubmethodIsDBNull(Int32)

Gibt "true" zurück, wenn die durch den Parameter für die Spaltenordnungszahl angegebene Spalte null ist.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodSetBoolean(Int32, Boolean)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Boolean-Wert fest.

System_CAPS_pubmethodSetByte(Int32, Byte)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Byte-Wert fest.

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

Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Byte-Werten fest.

System_CAPS_pubmethodSetChar(Int32, Char)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Char-Wert fest.

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

Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Char-Werten fest.

System_CAPS_pubmethodSetDateTime(Int32, DateTime)

Legt die in der Spalte gespeicherten Daten auf den angegebenen DateTime-Wert fest.

System_CAPS_pubmethodSetDateTimeOffset(Int32, DateTimeOffset)

Legt den Wert der angegebenen Spalte auf den DateTimeOffset-Wert fest.

System_CAPS_pubmethodSetDBNull(Int32)

Legt den Wert in der angegebenen Spalte auf DBNull fest.

System_CAPS_pubmethodSetDecimal(Int32, Decimal)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Decimal-Wert fest.

System_CAPS_pubmethodSetDouble(Int32, Double)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Double-Wert fest.

System_CAPS_pubmethodSetFloat(Int32, Single)

Legt die in der Spalte gespeicherten Daten auf den angegebenen float-Wert fest.

System_CAPS_pubmethodSetGuid(Int32, Guid)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Guid-Wert fest.

System_CAPS_pubmethodSetInt16(Int32, Int16)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int16-Wert fest.

System_CAPS_pubmethodSetInt32(Int32, Int32)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int32-Wert fest.

System_CAPS_pubmethodSetInt64(Int32, Int64)

Legt die in der Spalte gespeicherten Daten auf den angegebenen Int64-Wert fest.

System_CAPS_pubmethodSetSqlBinary(Int32, SqlBinary)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBinary-Wert fest.

System_CAPS_pubmethodSetSqlBoolean(Int32, SqlBoolean)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBoolean-Wert fest.

System_CAPS_pubmethodSetSqlByte(Int32, SqlByte)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlByte-Wert fest.

System_CAPS_pubmethodSetSqlBytes(Int32, SqlBytes)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlBytes-Wert fest.

System_CAPS_pubmethodSetSqlChars(Int32, SqlChars)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlChars-Wert fest.

System_CAPS_pubmethodSetSqlDateTime(Int32, SqlDateTime)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDateTime-Wert fest.

System_CAPS_pubmethodSetSqlDecimal(Int32, SqlDecimal)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDecimal-Wert fest.

System_CAPS_pubmethodSetSqlDouble(Int32, SqlDouble)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlDouble-Wert fest.

System_CAPS_pubmethodSetSqlGuid(Int32, SqlGuid)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlGuid-Wert fest.

System_CAPS_pubmethodSetSqlInt16(Int32, SqlInt16)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt16-Wert fest.

System_CAPS_pubmethodSetSqlInt32(Int32, SqlInt32)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt32-Wert fest.

System_CAPS_pubmethodSetSqlInt64(Int32, SqlInt64)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlInt64-Wert fest.

System_CAPS_pubmethodSetSqlMoney(Int32, SqlMoney)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlMoney-Wert fest.

System_CAPS_pubmethodSetSqlSingle(Int32, SqlSingle)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlSingle-Wert fest.

System_CAPS_pubmethodSetSqlString(Int32, SqlString)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlString-Wert fest.

System_CAPS_pubmethodSetSqlXml(Int32, SqlXml)

Legt die in der Spalte gespeicherten Daten auf den angegebenen SqlXml-Wert fest.

System_CAPS_pubmethodSetString(Int32, String)

Legt die in der Spalte gespeicherten Daten auf den angegebenen String-Wert fest.

System_CAPS_pubmethodSetTimeSpan(Int32, TimeSpan)

Legt den Wert der angegebenen Spalte auf TimeSpan fest.

System_CAPS_pubmethodSetValue(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.

System_CAPS_pubmethodSetValues(Object[])

Legt neue Werte für alle Spalten im SqlDataRecord fest. Diese Werte werden in Form von CLR-Typen (Common Language Runtime) ausgedrückt.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataRecord.GetData(Int32)

Wird in dieser Version nicht unterstützt.

Diese Klasse dient zusammen mit SqlPipe Resultsets aus gespeicherten Prozeduren mit verwaltetem Code an den Client zu senden.

Wenn common Language Runtime (CLR)-Anwendung schreiben, sollten Sie erneut verwenden vorhandene SqlDataRecord Objekte nicht jedes Mal neu erstellt. Erstellung zahlreicher neuer SqlDataRecord Objekte den Arbeitsspeicher stark auslasten und Leistung beeinträchtigen könnte.

Das folgende Beispiel zeigt das Erstellen mehrerer SqlMetaData Objekte, die die Spaltenmetadaten eines Datensatzes beschreiben, und erstellen eine SqlDataRecord. Die Spaltenwerte die SqlDataRecord festgelegt sind und die SqlDataRecord an das aufrufende Programm gesendet wird, mithilfe der SqlContext Klasse.

[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);
}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: