Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

SqlDataRecord-Klasse

.NET Framework 4.5

Andere Versionen

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

Vererbungshierarchie

System.Object
Microsoft.SqlServer.Server.SqlDataRecord

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

Syntax

C++

public class SqlDataRecord : IDataRecord

Der SqlDataRecord-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	SqlDataRecord	Initialisiert eine neue SqlDataRecord-Instanz, deren Schema auf dem Array von SqlMetaData-Objekten basiert, das als Argument übergeben wird.

Zum Seitenanfang

Eigenschaften

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

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetBoolean	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Boolean angeben.
	GetByte	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Byte ab.
	GetBytes	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Byte-Objekten ab.
	GetChar	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Char angeben.
	GetChars	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Array von Char-Objekten ab.
	GetDataTypeName	Gibt den Namen des Datentyps für die durch das Ordnungszahlargument angegebene Spalte zurück.
	GetDateTime	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als DateTime angeben.
	GetDateTimeOffset	Gibt die Daten der angegebenen Spalten als DateTimeOffset zurück.
	GetDecimal	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Decimal ab.
	GetDouble	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Double ab.
	GetFieldType	Gibt ein Type-Objekt zurück, das den CLR (Common Language Runtime)-Typ darstellt, der dem SQL Server-Typ der durch das ordinal-Argument angegebenen Spalte zugeordnet ist.
	GetFloat	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als float angeben.
	GetGuid	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Guid ab.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetInt16	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int16 ab.
	GetInt32	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int32 ab.
	GetInt64	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als Int64 ab.
	GetName	Gibt den Namen der durch das Ordnungszahlargument angegebenen Spalte zurück.
	GetOrdinal	Gibt die durch den Spaltennamen angegebene Spaltenordnungszahl zurück.
	GetSqlBinary	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBinary angeben.
	GetSqlBoolean	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBoolean angeben.
	GetSqlByte	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlByte angeben.
	GetSqlBytes	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlBytes angeben.
	GetSqlChars	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlChars angeben.
	GetSqlDateTime	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDateTime angeben.
	GetSqlDecimal	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDecimal angeben.
	GetSqlDouble	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlDouble angeben.
	GetSqlFieldType	Gibt ein Type-Objekt zurück, das den Typ (als SQL Server-Typ, der in System.Data.SqlTypes definiert ist) darstellt, der dem SQL Server-Typ der Spalte zugeordnet ist.
	GetSqlGuid	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlGuid angeben.
	GetSqlInt16	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt16 angeben.
	GetSqlInt32	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt32 angeben.
	GetSqlInt64	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlInt64 angeben.
	GetSqlMetaData	Gibt ein SqlMetaData-Objekt zurück, das die Metadaten der von der Spaltenordnungszahl angegebenen Spalte beschreibt.
	GetSqlMoney	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlMoney angeben.
	GetSqlSingle	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlSingle angeben.
	GetSqlString	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlString angeben.
	GetSqlValue	Gibt den in der durch die Spaltenordnungszahl angegebenen Spalte gespeicherten Datenwert als einen SQL Server-Typ zurück.
	GetSqlValues	Gibt die Werte aller Spalten in dem Datensatz als SQL Server-Typen in einem Array zurück.
	GetSqlXml	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als SqlXml angeben.
	GetString	Ruft den Wert für die durch die Ordnungszahl angegebene Spalte als String angeben.
	GetTimeSpan	Gibt die Daten der angegebenen Spalten als TimeSpan zurück.
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetValue	Gibt den CLR (Common Language Runtime)-Typwert für die Spalte zurück, die durch das Ordnungszahlargument der Spalte angegeben wird.
	GetValues	Gibt die Werte aller Spalten in dem Datensatz als CLR (Common Language Runtime)-Typen in einem Array zurück.
	IsDBNull	Gibt true zurück, wenn die durch den Ordnungszahlparameter angegebene Spalte NULL ist.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	SetBoolean	Legt die in der Spalte gespeicherten Werte auf den angegebenen Boolean-Wert fest.
	SetByte	Legt die in der Spalte gespeicherten Werte auf den angegebenen Byte-Wert fest.
	SetBytes	Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Byte-Werten fest.
	SetChar	Legt die in der Spalte gespeicherten Werte auf den angegebenen Char-Wert fest.
	SetChars	Legt die in der Spalte gespeicherten Daten auf das angegebene Array von Char-Werten fest.
	SetDateTime	Legt die in der Spalte gespeicherten Werte auf den angegebenen DateTime-Wert fest.
	SetDateTimeOffset	Legt den Wert der angegebenen Spalte auf den DateTimeOffset-Wert fest.
	SetDBNull	Legt den Wert in der angegebenen Spalte auf DBNull fest.
	SetDecimal	Legt die in der Spalte gespeicherten Werte auf den angegebenen Decimal-Wert fest.
	SetDouble	Legt die in der Spalte gespeicherten Werte auf den angegebenen Double-Wert fest.
	SetFloat	Legt die in der Spalte gespeicherten Werte auf den angegebenen float-Wert fest.
	SetGuid	Legt die in der Spalte gespeicherten Werte auf den angegebenen Guid-Wert fest.
	SetInt16	Legt die in der Spalte gespeicherten Werte auf den angegebenen Int16-Wert fest.
	SetInt32	Legt die in der Spalte gespeicherten Werte auf den angegebenen Int32-Wert fest.
	SetInt64	Legt die in der Spalte gespeicherten Werte auf den angegebenen Int64-Wert fest.
	SetSqlBinary	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlBinary-Wert fest.
	SetSqlBoolean	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlBoolean-Wert fest.
	SetSqlByte	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlByte-Wert fest.
	SetSqlBytes	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlBytes-Wert fest.
	SetSqlChars	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlChars-Wert fest.
	SetSqlDateTime	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlDateTime-Wert fest.
	SetSqlDecimal	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlDecimal-Wert fest.
	SetSqlDouble	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlDouble-Wert fest.
	SetSqlGuid	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlGuid-Wert fest.
	SetSqlInt16	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlInt16-Wert fest.
	SetSqlInt32	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlInt32-Wert fest.
	SetSqlInt64	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlInt64-Wert fest.
	SetSqlMoney	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlMoney-Wert fest.
	SetSqlSingle	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlSingle-Wert fest.
	SetSqlString	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlString-Wert fest.
	SetSqlXml	Legt die in der Spalte gespeicherten Werte auf den angegebenen SqlXml-Wert fest.
	SetString	Legt die in der Spalte gespeicherten Werte auf den angegebenen String-Wert fest.
	SetTimeSpan	Legt den Wert der angegebenen Spalte auf die TimeSpan fest.
	SetValue	Legt einen neuen Wert als einen CLR (Common Language Runtime)-Typ für die durch die Spaltenordnungszahl angegebene Spalte fest.
	SetValues	Legt neue Werte für alle Spalten im SqlDataRecord fest. Diese Werte werden in Form von Common Language Runtime (CLR)-Typen ausgedrückt.
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IDataRecord.GetData	Wird in dieser Version nicht unterstützt.

Zum Seitenanfang

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 (Common Language Runtime)-Anwendungen sollten Sie nach Möglichkeit vorhandene SqlDataRecord-Objekte verwenden, anstatt jedes Mal neue Objekte zu erstellen. Die Erstellung zahlreicher neuer SqlDataRecord-Objekte kann den Arbeitsspeicher stark auslasten und die Leistung erheblich beeinträchtigen.

Beispiele

Das folgende Beispiel veranschaulicht das Erstellen mehrerer SqlMetaData-Objekte, die die Spaltenmetadaten eines Datensatzes beschreiben, sowie das Erstellen eines SqlDataRecord. Die Spaltenwerte des SqlDataRecord werden festgelegt, und der SqlDataRecord wird mit der SqlContext-Klasse an das 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);
}

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.SqlServer.Server-Namespace

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN