SqlDataRecord Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje pojedynczy wiersz danych i jego metadanych.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Dziedziczenie
-
SqlDataRecord
- Implementuje
Przykłady
W poniższym przykładzie pokazano, jak utworzyć kilka SqlMetaData obiektów opisujących metadane kolumny rekordu, a następnie utworzyć wystąpienie wielokrotnego użytku SqlDataRecord . Wartości SqlDataRecord kolumny są ustawiane i te same SqlDataRecord mogą służyć do przesyłania strumieniowego wielu wierszy do SQL Server jako parametru wartości tabeli.
using System;
using System.Collections.Generic;
using System.Data;
using Microsoft.Data.SqlClient.Server;
// Stream rows to SQL Server as a table-valued parameter.
public static IEnumerable<SqlDataRecord> CreateNewRecord()
{
// Re-use a single SqlDataRecord instance rather than allocating a new one for each row.
// Each row's values are read before SqlCommand advances to the next one.
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);
// Stream the first record to SQL Server.
yield return record;
// Set the fields of the second record and stream it to SQL Server.
record.SetInt32(1, 0);
yield return record;
}
Uwagi
Ta klasa opisuje pojedynczy wiersz parametru o wartości tabeli. Skonstruuj jedną z tablicy SqlMetaData obiektów, które opisują metadane kolumny rekordu, wypełnij je metodami Ustaw<typ> , dołącz je do IEnumerable<SqlDataRecord> elementu i przypisz IEnumerable<SqlDataRecord> je do Valueelementu .
Aby uzyskać najlepszą wydajność podczas wysyłania wielu wierszy, ponownie użyj pojedynczego SqlDataRecord wystąpienia w iteratorze IEnumerable<SqlDataRecord> : ustaw nowe wartości kolumn i yield return to samo wystąpienie dla każdego wiersza.
SqlCommand odczytuje każdy rekord przed przejściem do następnego.
Konstruktory
| Nazwisko | Opis |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Inicjuje nowe SqlDataRecord wystąpienie ze schematem na podstawie tablicy SqlMetaData obiektów przekazanych jako argument. |
Właściwości
| Nazwisko | Opis |
|---|---|
| FieldCount |
Pobiera liczbę kolumn w wierszu danych. Ta właściwość jest tylko do odczytu. |
| Item[Int32] |
Pobiera wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument kolumny |
| Item[String] |
Pobiera wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument kolumny |
Metody
| Nazwisko | Opis |
|---|---|
| GetBoolean(Int32) |
Pobiera wartość kolumny określonej przez porządkową Booleanjako . |
| GetByte(Int32) |
Pobiera wartość kolumny określonej przez porządkową Bytejako . |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Pobiera wartość kolumny określonej przez porządkową jako tablicę Byte obiektów. |
| GetChar(Int32) |
Pobiera wartość kolumny określonej przez porządkową Charjako . |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Pobiera wartość kolumny określonej przez porządkową jako tablicę Char obiektów. |
| GetDataTypeName(Int32) |
Zwraca nazwę typu danych dla kolumny określonej przez argument porządkowy. |
| GetDateTime(Int32) |
Pobiera wartość kolumny określonej przez porządkową DateTimejako . |
| GetDateTimeOffset(Int32) |
Zwraca dane określonej kolumny jako DateTimeOffset. |
| GetDecimal(Int32) |
Pobiera wartość kolumny określonej przez porządkową Decimaljako . |
| GetDouble(Int32) |
Pobiera wartość kolumny określonej przez porządkową Doublejako . |
| GetFieldType(Int32) |
Type Zwraca obiekt reprezentujący typ środowiska uruchomieniowego języka wspólnego (CLR), który jest mapowany na typ SQL Server kolumny określonej przez |
| GetFloat(Int32) |
Pobiera wartość kolumny określonej przez porządkową Singlejako . |
| GetGuid(Int32) |
Pobiera wartość kolumny określonej przez porządkową Guidjako . |
| GetInt16(Int32) |
Pobiera wartość kolumny określonej przez porządkową Int16jako . |
| GetInt32(Int32) |
Pobiera wartość kolumny określonej przez porządkową Int32jako . |
| GetInt64(Int32) |
Pobiera wartość kolumny określonej przez porządkową Int64jako . |
| GetName(Int32) |
Zwraca nazwę kolumny określonej przez argument porządkowy. |
| GetOrdinal(String) |
Zwraca porządkową kolumnę określoną przez nazwę kolumny. |
| GetSqlBinary(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlBinaryjako . |
| GetSqlBoolean(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlBooleanjako . |
| GetSqlByte(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlBytejako . |
| GetSqlBytes(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlBytesjako . |
| GetSqlChars(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlCharsjako . |
| GetSqlDateTime(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlDateTimejako . |
| GetSqlDecimal(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlDecimaljako . |
| GetSqlDouble(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlDoublejako . |
| GetSqlFieldType(Int32) |
Type Zwraca obiekt reprezentujący typ (jako typ SQL Server zdefiniowany w pliku System.Data.SqlTypes), który jest mapowane na typ SQL Server kolumny. |
| GetSqlGuid(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlGuidjako . |
| GetSqlInt16(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlInt16jako . |
| GetSqlInt32(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlInt32jako . |
| GetSqlInt64(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlInt64jako . |
| GetSqlMetaData(Int32) |
SqlMetaData Zwraca obiekt opisujący metadane kolumny określonej przez porządkową kolumnę. |
| GetSqlMoney(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlMoneyjako . |
| GetSqlSingle(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlSinglejako . |
| GetSqlString(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlStringjako . |
| GetSqlValue(Int32) |
Zwraca wartość danych przechowywaną w kolumnie wyrażoną jako typ SQL Server określony przez porządkową kolumnę. |
| GetSqlValues(Object[]) |
Zwraca wartości dla wszystkich kolumn w rekordzie wyrażonych jako typy SQL Server w tablicy. |
| GetSqlXml(Int32) |
Pobiera wartość kolumny określonej przez porządkową SqlXmljako . |
| GetString(Int32) |
Pobiera wartość kolumny określonej przez porządkową Stringjako . |
| GetTimeSpan(Int32) |
Zwraca dane określonej kolumny jako TimeSpan. |
| GetValue(Int32) |
Zwraca wartość typu środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez argument porządkowy. |
| GetValues(Object[]) |
Zwraca wartości dla wszystkich kolumn w rekordzie, wyrażone jako typy środowiska uruchomieniowego języka wspólnego (CLR) w tablicy. |
| IsDBNull(Int32) |
Zwraca wartość |
| SetBoolean(Int32, Boolean) |
Ustawia dane przechowywane w kolumnie na określoną Boolean wartość. |
| SetByte(Int32, Byte) |
Ustawia dane przechowywane w kolumnie na określoną Byte wartość. |
| SetBytes(Int32, Int64, Byte[], Int32, Int32) |
Ustawia dane przechowywane w kolumnie na określoną tablicę Byte wartości. |
| SetChar(Int32, Char) |
Ustawia dane przechowywane w kolumnie na określoną Char wartość. |
| SetChars(Int32, Int64, Char[], Int32, Int32) |
Ustawia dane przechowywane w kolumnie na określoną tablicę Char wartości. |
| SetDateTime(Int32, DateTime) |
Ustawia dane przechowywane w kolumnie na określoną DateTime wartość. |
| SetDateTimeOffset(Int32, DateTimeOffset) |
Ustawia wartość kolumny określonej na DateTimeOffset wartość. |
| SetDBNull(Int32) |
Ustawia wartość w określonej kolumnie na DBNull. |
| SetDecimal(Int32, Decimal) |
Ustawia dane przechowywane w kolumnie na określoną Decimal wartość. |
| SetDouble(Int32, Double) |
Ustawia dane przechowywane w kolumnie na określoną Double wartość. |
| SetFloat(Int32, Single) |
Ustawia dane przechowywane w kolumnie na określoną Single wartość. |
| SetGuid(Int32, Guid) |
Ustawia dane przechowywane w kolumnie na określoną Guid wartość. |
| SetInt16(Int32, Int16) |
Ustawia dane przechowywane w kolumnie na określoną Int16 wartość. |
| SetInt32(Int32, Int32) |
Ustawia dane przechowywane w kolumnie na określoną Int32 wartość. |
| SetInt64(Int32, Int64) |
Ustawia dane przechowywane w kolumnie na określoną Int64 wartość. |
| SetSqlBinary(Int32, SqlBinary) |
Ustawia dane przechowywane w kolumnie na określoną SqlBinary wartość. |
| SetSqlBoolean(Int32, SqlBoolean) |
Ustawia dane przechowywane w kolumnie na określoną SqlBoolean wartość. |
| SetSqlByte(Int32, SqlByte) |
Ustawia dane przechowywane w kolumnie na określoną SqlByte wartość. |
| SetSqlBytes(Int32, SqlBytes) |
Ustawia dane przechowywane w kolumnie na określoną SqlBytes wartość. |
| SetSqlChars(Int32, SqlChars) |
Ustawia dane przechowywane w kolumnie na określoną SqlChars wartość. |
| SetSqlDateTime(Int32, SqlDateTime) |
Ustawia dane przechowywane w kolumnie na określoną SqlDateTime wartość. |
| SetSqlDecimal(Int32, SqlDecimal) |
Ustawia dane przechowywane w kolumnie na określoną SqlDecimal wartość. |
| SetSqlDouble(Int32, SqlDouble) |
Ustawia dane przechowywane w kolumnie na określoną SqlDouble wartość. |
| SetSqlGuid(Int32, SqlGuid) |
Ustawia dane przechowywane w kolumnie na określoną SqlGuid wartość. |
| SetSqlInt16(Int32, SqlInt16) |
Ustawia dane przechowywane w kolumnie na określoną SqlInt16 wartość. |
| SetSqlInt32(Int32, SqlInt32) |
Ustawia dane przechowywane w kolumnie na określoną SqlInt32 wartość. |
| SetSqlInt64(Int32, SqlInt64) |
Ustawia dane przechowywane w kolumnie na określoną SqlInt64 wartość. |
| SetSqlMoney(Int32, SqlMoney) |
Ustawia dane przechowywane w kolumnie na określoną SqlMoney wartość. |
| SetSqlSingle(Int32, SqlSingle) |
Ustawia dane przechowywane w kolumnie na określoną SqlSingle wartość. |
| SetSqlString(Int32, SqlString) |
Ustawia dane przechowywane w kolumnie na określoną SqlString wartość. |
| SetSqlXml(Int32, SqlXml) |
Ustawia dane przechowywane w kolumnie na określoną SqlXml wartość. |
| SetString(Int32, String) |
Ustawia dane przechowywane w kolumnie na określoną String wartość. |
| SetTimeSpan(Int32, TimeSpan) |
Ustawia wartość kolumny określonej na TimeSpanwartość . |
| SetValue(Int32, Object) |
Ustawia nową wartość wyrażoną jako typ środowiska uruchomieniowego języka wspólnego (CLR) dla kolumny określonej przez porządkową kolumnę. |
| SetValues(Object[]) |
Ustawia nowe wartości dla wszystkich kolumn w obiekcie SqlDataRecord. Te wartości są wyrażane jako typy środowiska uruchomieniowego języka wspólnego (CLR). |
Jawne implementacje interfejsu
| Nazwisko | Opis |
|---|---|
| IDataRecord.GetData(Int32) |
Nieobsługiwane w tej wersji. |