SqlDataRecord Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une seule ligne de données et ses métadonnées.
public ref class SqlDataRecord : System::Data::IDataRecordpublic class SqlDataRecord : System.Data.IDataRecordtype SqlDataRecord = class
interface IDataRecordPublic Class SqlDataRecord
Implements IDataRecord- Héritage
-
SqlDataRecord
- Implémente
Exemples
L’exemple suivant montre comment créer plusieurs SqlMetaData objets décrivant les métadonnées de colonne d’un enregistrement, puis créer une instance réutilisable SqlDataRecord . Les valeurs de colonne du SqlDataRecord jeu sont définies et les mêmes SqlDataRecord peuvent être utilisées pour diffuser plusieurs lignes vers SQL Server en tant que paramètre table.
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;
}
Remarques
Cette classe décrit une seule ligne d’un paramètre table. Construisez-en un à partir d’un tableau d’objets qui décrivent les métadonnées de SqlMetaData colonne de l’enregistrement, renseignez-le avec les méthodes Set Type<>, incluez-le dans un IEnumerable<SqlDataRecord> objet et affectez-le IEnumerable<SqlDataRecord> à Value.
Pour des performances optimales lors de l’envoi de plusieurs lignes, réutilise une seule SqlDataRecord instance sur un IEnumerable<SqlDataRecord> itérateur : définissez de nouvelles valeurs de colonne et yield return la même instance pour chaque ligne.
SqlCommand lit chaque enregistrement avant de passer à la suivante.
Constructeurs
| Nom | Description |
|---|---|
| SqlDataRecord(SqlMetaData[]) |
Initialise une nouvelle SqlDataRecord instance avec le schéma en fonction du tableau d’objets SqlMetaData transmis en tant qu’argument. |
Propriétés
| Nom | Description |
|---|---|
| FieldCount |
Obtient le nombre de colonnes dans la ligne de données. Cette propriété est en lecture seule. |
| Item[Int32] |
Obtient la valeur de type CLR (Common Language Runtime) pour la colonne spécifiée par l’argument de colonne |
| Item[String] |
Obtient la valeur de type CLR (Common Language Runtime) pour la colonne spécifiée par l’argument de colonne |
Méthodes
| Nom | Description |
|---|---|
| GetBoolean(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Boolean. |
| GetByte(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que tableau d’objets Byte . |
| GetChar(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Char. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que tableau d’objets Char . |
| GetDataTypeName(Int32) |
Retourne le nom du type de données de la colonne spécifiée par l’argument ordinal. |
| GetDateTime(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que DateTime. |
| GetDateTimeOffset(Int32) |
Retourne les données de la colonne spécifiée en tant que DateTimeOffset. |
| GetDecimal(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Decimal. |
| GetDouble(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Double. |
| GetFieldType(Int32) |
Renvoie un Type objet représentant le type CLR (Common Language Runtime) mappé au type SQL Server de la colonne spécifiée par l’argument |
| GetFloat(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Single. |
| GetGuid(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Guid. |
| GetInt16(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Int16. |
| GetInt32(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Int32. |
| GetInt64(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que Int64. |
| GetName(Int32) |
Retourne le nom de la colonne spécifiée par l’argument ordinal. |
| GetOrdinal(String) |
Retourne l’ordinal de colonne spécifié par le nom de colonne. |
| GetSqlBinary(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlBinary. |
| GetSqlBoolean(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlBoolean. |
| GetSqlByte(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlByte. |
| GetSqlBytes(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlBytes. |
| GetSqlChars(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlChars. |
| GetSqlDateTime(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlDateTime. |
| GetSqlDecimal(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlDecimal. |
| GetSqlDouble(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlDouble. |
| GetSqlFieldType(Int32) |
Renvoie un Type objet qui représente le type (en tant que type SQL Server, défini dans System.Data.SqlTypes) qui correspond au type SQL Server de la colonne. |
| GetSqlGuid(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlGuid. |
| GetSqlInt16(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlInt16. |
| GetSqlInt32(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlInt32. |
| GetSqlInt64(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlInt64. |
| GetSqlMetaData(Int32) |
Retourne un SqlMetaData objet, décrivant les métadonnées de la colonne spécifiée par l’ordinal de colonne. |
| GetSqlMoney(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlMoney. |
| GetSqlSingle(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlSingle. |
| GetSqlString(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlString. |
| GetSqlValue(Int32) |
Retourne la valeur de données stockée dans la colonne, exprimée sous la forme d’un type SQL Server, spécifiée par l’ordinal de colonne. |
| GetSqlValues(Object[]) |
Retourne les valeurs de toutes les colonnes de l’enregistrement, exprimées sous forme de types SQL Server, dans un tableau. |
| GetSqlXml(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que SqlXml. |
| GetString(Int32) |
Obtient la valeur de la colonne spécifiée par l’ordinal en tant que String. |
| GetTimeSpan(Int32) |
Retourne les données de la colonne spécifiée en tant que TimeSpan. |
| GetValue(Int32) |
Retourne la valeur de type CLR (Common Language Runtime) pour la colonne spécifiée par l’argument ordinal. |
| GetValues(Object[]) |
Retourne les valeurs de toutes les colonnes de l’enregistrement, exprimées sous forme de types CLR (Common Language Runtime), dans un tableau. |
| IsDBNull(Int32) |
Retourne |
| SetBoolean(Int32, Boolean) |
Définit les données stockées dans la colonne sur la valeur spécifiée Boolean . |
| SetByte(Int32, Byte) |
Définit les données stockées dans la colonne sur la valeur spécifiée Byte . |
| SetBytes(Int32, Int64, Byte[], Int32, Int32) |
Définit les données stockées dans la colonne sur le tableau de Byte valeurs spécifié. |
| SetChar(Int32, Char) |
Définit les données stockées dans la colonne sur la valeur spécifiée Char . |
| SetChars(Int32, Int64, Char[], Int32, Int32) |
Définit les données stockées dans la colonne sur le tableau de Char valeurs spécifié. |
| SetDateTime(Int32, DateTime) |
Définit les données stockées dans la colonne sur la valeur spécifiée DateTime . |
| SetDateTimeOffset(Int32, DateTimeOffset) |
Définit la valeur de la colonne spécifiée sur la DateTimeOffset valeur. |
| SetDBNull(Int32) |
Définit la valeur dans la colonne DBNullspécifiée sur . |
| SetDecimal(Int32, Decimal) |
Définit les données stockées dans la colonne sur la valeur spécifiée Decimal . |
| SetDouble(Int32, Double) |
Définit les données stockées dans la colonne sur la valeur spécifiée Double . |
| SetFloat(Int32, Single) |
Définit les données stockées dans la colonne sur la valeur spécifiée Single . |
| SetGuid(Int32, Guid) |
Définit les données stockées dans la colonne sur la valeur spécifiée Guid . |
| SetInt16(Int32, Int16) |
Définit les données stockées dans la colonne sur la valeur spécifiée Int16 . |
| SetInt32(Int32, Int32) |
Définit les données stockées dans la colonne sur la valeur spécifiée Int32 . |
| SetInt64(Int32, Int64) |
Définit les données stockées dans la colonne sur la valeur spécifiée Int64 . |
| SetSqlBinary(Int32, SqlBinary) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlBinary . |
| SetSqlBoolean(Int32, SqlBoolean) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlBoolean . |
| SetSqlByte(Int32, SqlByte) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlByte . |
| SetSqlBytes(Int32, SqlBytes) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlBytes . |
| SetSqlChars(Int32, SqlChars) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlChars . |
| SetSqlDateTime(Int32, SqlDateTime) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlDateTime . |
| SetSqlDecimal(Int32, SqlDecimal) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlDecimal . |
| SetSqlDouble(Int32, SqlDouble) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlDouble . |
| SetSqlGuid(Int32, SqlGuid) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlGuid . |
| SetSqlInt16(Int32, SqlInt16) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlInt16 . |
| SetSqlInt32(Int32, SqlInt32) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlInt32 . |
| SetSqlInt64(Int32, SqlInt64) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlInt64 . |
| SetSqlMoney(Int32, SqlMoney) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlMoney . |
| SetSqlSingle(Int32, SqlSingle) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlSingle . |
| SetSqlString(Int32, SqlString) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlString . |
| SetSqlXml(Int32, SqlXml) |
Définit les données stockées dans la colonne sur la valeur spécifiée SqlXml . |
| SetString(Int32, String) |
Définit les données stockées dans la colonne sur la valeur spécifiée String . |
| SetTimeSpan(Int32, TimeSpan) |
Définit la valeur de la colonne spécifiée sur le TimeSpan. |
| SetValue(Int32, Object) |
Définit une nouvelle valeur, exprimée en tant que type CLR (Common Language Runtime), pour la colonne spécifiée par l’ordinal de colonne. |
| SetValues(Object[]) |
Définit de nouvelles valeurs pour toutes les colonnes du SqlDataRecord. Ces valeurs sont exprimées sous forme de types CLR (Common Language Runtime). |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Non pris en charge dans cette version. |