SqlDataRecord Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje jeden řádek dat a jeho metadata.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Dědičnost
-
SqlDataRecord
- Implementuje
Příklady
Následující příklad ukazuje, jak vytvořit několik SqlMetaData objektů popisujících metadata sloupce záznamu a pak vytvořit znovu použitelnou SqlDataRecord instanci. Hodnoty sloupců jsou SqlDataRecord nastaveny a totéž SqlDataRecord lze použít k streamování více řádků, které se mají SQL Server jako parametr s hodnotou tabulky.
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;
}
Poznámky
Tato třída popisuje jeden řádek parametru s hodnotou tabulky. Vytvořte jeden z pole SqlMetaData objektů, které popisují metadata sloupce záznamu, naplňte jej metodami Set<Type> , zahrňte ho do objektu IEnumerable<SqlDataRecord> a přiřaďte IEnumerable<SqlDataRecord> ho Value.
Pokud chcete dosáhnout nejlepšího výkonu při odesílání více řádků, znovu použijte jednu SqlDataRecord instanci v iterátoru IEnumerable<SqlDataRecord> : nastavte nové hodnoty sloupců a yield return stejnou instanci pro každý řádek.
SqlCommand bude číst každý záznam před tím, než přejde na další.
Konstruktory
| Název | Description |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Inicializuje novou SqlDataRecord instanci se schématem na základě pole SqlMetaData objektů předaných jako argument. |
Vlastnosti
| Název | Description |
|---|---|
| FieldCount |
Získá počet sloupců v řádku dat. Tato vlastnost je pouze pro čtení. |
| Item[Int32] |
Získá hodnotu typu CLR (Common Language Runtime) pro sloupec určený argumentem sloupce |
| Item[String] |
Získá hodnotu typu CLR (Common Language Runtime) pro sloupec určený argumentem sloupce |
Metody
| Název | Description |
|---|---|
| GetBoolean(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Booleanjako . |
| GetByte(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Bytejako . |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Získá hodnotu sloupce určeného pořadovým polem jako pole Byte objektů. |
| GetChar(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Charjako . |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Získá hodnotu sloupce určeného pořadovým polem jako pole Char objektů. |
| GetDataTypeName(Int32) |
Vrátí název datového typu pro sloupec určený pořadovým argumentem. |
| GetDateTime(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem DateTimejako . |
| GetDateTimeOffset(Int32) |
Vrátí data zadaného sloupce jako DateTimeOffset. |
| GetDecimal(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Decimaljako . |
| GetDouble(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Doublejako . |
| GetFieldType(Int32) |
Type Vrátí objekt představující typ CLR (Common Language Runtime), který se mapuje na typ SQL Server sloupce určeného argumentem |
| GetFloat(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Singlejako . |
| GetGuid(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Guidjako . |
| GetInt16(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Int16jako . |
| GetInt32(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Int32jako . |
| GetInt64(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Int64jako . |
| GetName(Int32) |
Vrátí název sloupce určeného pořadovým argumentem. |
| GetOrdinal(String) |
Vrátí pořadový řádek sloupce určený názvem sloupce. |
| GetSqlBinary(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlBinaryjako . |
| GetSqlBoolean(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlBooleanjako . |
| GetSqlByte(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlBytejako . |
| GetSqlBytes(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlBytesjako . |
| GetSqlChars(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlCharsjako . |
| GetSqlDateTime(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlDateTimejako . |
| GetSqlDecimal(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlDecimaljako . |
| GetSqlDouble(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlDoublejako . |
| GetSqlFieldType(Int32) |
Type Vrátí objekt, který představuje typ (jako typ SQL Server definovaný v System.Data.SqlTypes), který se mapuje na typ SQL Server sloupce. |
| GetSqlGuid(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlGuidjako . |
| GetSqlInt16(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlInt16jako . |
| GetSqlInt32(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlInt32jako . |
| GetSqlInt64(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlInt64jako . |
| GetSqlMetaData(Int32) |
SqlMetaData Vrátí objekt popisující metadata sloupce určeného pořadovým sloupcem. |
| GetSqlMoney(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlMoneyjako . |
| GetSqlSingle(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlSinglejako . |
| GetSqlString(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlStringjako . |
| GetSqlValue(Int32) |
Vrátí hodnotu dat uloženou ve sloupci vyjádřenou jako typ SQL Server určený pořadovým sloupcem. |
| GetSqlValues(Object[]) |
Vrátí hodnoty pro všechny sloupce v záznamu vyjádřené jako SQL Server typy v poli. |
| GetSqlXml(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem SqlXmljako . |
| GetString(Int32) |
Získá hodnotu sloupce určeného pořadovým číslokem Stringjako . |
| GetTimeSpan(Int32) |
Vrátí data zadaného sloupce jako TimeSpan. |
| GetValue(Int32) |
Vrátí hodnotu typu CLR (Common Language Runtime) pro sloupec určený pořadovým argumentem. |
| GetValues(Object[]) |
Vrátí hodnoty pro všechny sloupce v záznamu vyjádřené jako typy CLR (Common Language Runtime) v poli. |
| IsDBNull(Int32) |
Vrátí |
| SetBoolean(Int32, Boolean) |
Nastaví data uložená ve sloupci na zadanou Boolean hodnotu. |
| SetByte(Int32, Byte) |
Nastaví data uložená ve sloupci na zadanou Byte hodnotu. |
| SetBytes(Int32, Int64, Byte[], Int32, Int32) |
Nastaví data uložená ve sloupci na zadanou matici Byte hodnot. |
| SetChar(Int32, Char) |
Nastaví data uložená ve sloupci na zadanou Char hodnotu. |
| SetChars(Int32, Int64, Char[], Int32, Int32) |
Nastaví data uložená ve sloupci na zadanou matici Char hodnot. |
| SetDateTime(Int32, DateTime) |
Nastaví data uložená ve sloupci na zadanou DateTime hodnotu. |
| SetDateTimeOffset(Int32, DateTimeOffset) |
Nastaví hodnotu sloupce zadaného na DateTimeOffset hodnotu. |
| SetDBNull(Int32) |
Nastaví hodnotu v zadaném sloupci na DBNullhodnotu . |
| SetDecimal(Int32, Decimal) |
Nastaví data uložená ve sloupci na zadanou Decimal hodnotu. |
| SetDouble(Int32, Double) |
Nastaví data uložená ve sloupci na zadanou Double hodnotu. |
| SetFloat(Int32, Single) |
Nastaví data uložená ve sloupci na zadanou Single hodnotu. |
| SetGuid(Int32, Guid) |
Nastaví data uložená ve sloupci na zadanou Guid hodnotu. |
| SetInt16(Int32, Int16) |
Nastaví data uložená ve sloupci na zadanou Int16 hodnotu. |
| SetInt32(Int32, Int32) |
Nastaví data uložená ve sloupci na zadanou Int32 hodnotu. |
| SetInt64(Int32, Int64) |
Nastaví data uložená ve sloupci na zadanou Int64 hodnotu. |
| SetSqlBinary(Int32, SqlBinary) |
Nastaví data uložená ve sloupci na zadanou SqlBinary hodnotu. |
| SetSqlBoolean(Int32, SqlBoolean) |
Nastaví data uložená ve sloupci na zadanou SqlBoolean hodnotu. |
| SetSqlByte(Int32, SqlByte) |
Nastaví data uložená ve sloupci na zadanou SqlByte hodnotu. |
| SetSqlBytes(Int32, SqlBytes) |
Nastaví data uložená ve sloupci na zadanou SqlBytes hodnotu. |
| SetSqlChars(Int32, SqlChars) |
Nastaví data uložená ve sloupci na zadanou SqlChars hodnotu. |
| SetSqlDateTime(Int32, SqlDateTime) |
Nastaví data uložená ve sloupci na zadanou SqlDateTime hodnotu. |
| SetSqlDecimal(Int32, SqlDecimal) |
Nastaví data uložená ve sloupci na zadanou SqlDecimal hodnotu. |
| SetSqlDouble(Int32, SqlDouble) |
Nastaví data uložená ve sloupci na zadanou SqlDouble hodnotu. |
| SetSqlGuid(Int32, SqlGuid) |
Nastaví data uložená ve sloupci na zadanou SqlGuid hodnotu. |
| SetSqlInt16(Int32, SqlInt16) |
Nastaví data uložená ve sloupci na zadanou SqlInt16 hodnotu. |
| SetSqlInt32(Int32, SqlInt32) |
Nastaví data uložená ve sloupci na zadanou SqlInt32 hodnotu. |
| SetSqlInt64(Int32, SqlInt64) |
Nastaví data uložená ve sloupci na zadanou SqlInt64 hodnotu. |
| SetSqlMoney(Int32, SqlMoney) |
Nastaví data uložená ve sloupci na zadanou SqlMoney hodnotu. |
| SetSqlSingle(Int32, SqlSingle) |
Nastaví data uložená ve sloupci na zadanou SqlSingle hodnotu. |
| SetSqlString(Int32, SqlString) |
Nastaví data uložená ve sloupci na zadanou SqlString hodnotu. |
| SetSqlXml(Int32, SqlXml) |
Nastaví data uložená ve sloupci na zadanou SqlXml hodnotu. |
| SetString(Int32, String) |
Nastaví data uložená ve sloupci na zadanou String hodnotu. |
| SetTimeSpan(Int32, TimeSpan) |
Nastaví hodnotu sloupce zadaného TimeSpanna hodnotu . |
| SetValue(Int32, Object) |
Nastaví novou hodnotu vyjádřenou jako typ CLR (Common Language Runtime) pro sloupec určený pořadovým pořadím. |
| SetValues(Object[]) |
Nastaví nové hodnoty pro všechny sloupce v objektu SqlDataRecord. Tyto hodnoty jsou vyjádřeny jako typy CLR (Common Language Runtime). |
Explicitní implementace rozhraní
| Název | Description |
|---|---|
| IDataRecord.GetData(Int32) |
V této verzi se nepodporuje. |