Partager via


SqlDataRecord Classe

Définition

Représente une ligne de données et ses métadonnées. Cette classe ne peut pas être héritée.

public ref class SqlDataRecord : System::Data::IDataRecord
public class SqlDataRecord : System.Data.IDataRecord
type SqlDataRecord = class
    interface IDataRecord
Public Class SqlDataRecord
Implements IDataRecord
Héritage
SqlDataRecord
Implémente

Exemples

L’exemple suivant montre comment créer plusieurs SqlMetaData objets, qui décrivent les métadonnées de colonne d’un enregistrement, et comment créer un SqlDataRecord. Les valeurs de colonne de sont SqlDataRecord définies et le SqlDataRecord est envoyé au programme appelant à l’aide de la SqlContext classe .

[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);
}
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()

   ' Variables.
   Dim record As SqlDataRecord
   
   ' 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)

End Sub

Remarques

Cette classe est utilisée avec SqlPipe pour envoyer des jeux de résultats au client à partir de procédures stockées de code managé.

Lorsque vous écrivez des applications CLR (Common Language Runtime), vous devez réutiliser des objets existants SqlDataRecord au lieu d’en créer de nouveaux à chaque fois. La création de nombreux SqlDataRecord objets peut gravement épuiser la mémoire et nuire aux performances.

Constructeurs

SqlDataRecord(SqlMetaData[])

Initialise une nouvelle instance SqlDataRecord avec le schéma basé sur le tableau d’objets SqlMetaData passés en tant qu’argument.

Propriétés

FieldCount

Obtient le nombre de colonnes figurant dans la ligne de données. Cette propriété est en lecture seule.

Item[Int32]

Obtient la valeur de type CLR (Common Language Runtime) de la colonne spécifiée par l’argument ordinal de colonne.

Item[String]

Obtient la valeur de type CLR (Common Language Runtime) de la colonne spécifiée par l’argument name de colonne.

Méthodes

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)

Retourne un objet Type représentant le type du Common Language Runtime (CLR) qui mappe au type SQL Server de la colonne spécifiée par l’argument ordinal.

GetFloat(Int32)

Obtient la valeur de la colonne spécifiée par l’ordinal en tant que float.

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)

Retourne un objet Type qui représente le type (comme un type SQL Server, défini dans System.Data.SqlTypes) qui est mappé sur le 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 objet SqlMetaData, décrivant les métadonnées de la colonne spécifiée par le numéro 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 forme de type SQL Server et spécifiée par le numéro de colonne.

GetSqlValues(Object[])

Retourne les valeurs de toutes les colonnes de l’enregistrement, exprimées sous la 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 de CLR (Common Language Runtime) de la colonne spécifiée par l’argument ordinal.

GetValues(Object[])

Retourne les valeurs de toutes les colonnes de l’enregistrement, exprimées sous la forme de types CLR (Common Language Runtime), dans un tableau.

IsDBNull(Int32)

Retourne true si la colonne spécifiée par le paramètre de l’ordinal de la colonne est null.

SetBoolean(Int32, Boolean)

Affecte la valeur Boolean spécifiée aux données stockées dans la colonne.

SetByte(Int32, Byte)

Affecte la valeur Byte spécifiée aux données stockées dans la colonne.

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

Définit les données stockées dans la colonne sur le tableau spécifié des valeurs Byte.

SetChar(Int32, Char)

Affecte la valeur Char spécifiée aux données stockées dans la colonne.

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

Définit les données stockées dans la colonne sur le tableau spécifié des valeurs Char.

SetDateTime(Int32, DateTime)

Affecte la valeur DateTime spécifiée aux données stockées dans la colonne.

SetDateTimeOffset(Int32, DateTimeOffset)

Définit la valeur de la colonne spécifiée sur DateTimeOffset.

SetDBNull(Int32)

Définit la valeur de la colonne spécifiée sur DBNull.

SetDecimal(Int32, Decimal)

Affecte la valeur Decimal spécifiée aux données stockées dans la colonne.

SetDouble(Int32, Double)

Affecte la valeur Double spécifiée aux données stockées dans la colonne.

SetFloat(Int32, Single)

Affecte la valeur float spécifiée aux données stockées dans la colonne.

SetGuid(Int32, Guid)

Affecte la valeur Guid spécifiée aux données stockées dans la colonne.

SetInt16(Int32, Int16)

Affecte la valeur Int16 spécifiée aux données stockées dans la colonne.

SetInt32(Int32, Int32)

Affecte la valeur Int32 spécifiée aux données stockées dans la colonne.

SetInt64(Int32, Int64)

Affecte la valeur Int64 spécifiée aux données stockées dans la colonne.

SetSqlBinary(Int32, SqlBinary)

Affecte la valeur SqlBinary spécifiée aux données stockées dans la colonne.

SetSqlBoolean(Int32, SqlBoolean)

Affecte la valeur SqlBoolean spécifiée aux données stockées dans la colonne.

SetSqlByte(Int32, SqlByte)

Affecte la valeur SqlByte spécifiée aux données stockées dans la colonne.

SetSqlBytes(Int32, SqlBytes)

Affecte la valeur SqlBytes spécifiée aux données stockées dans la colonne.

SetSqlChars(Int32, SqlChars)

Affecte la valeur SqlChars spécifiée aux données stockées dans la colonne.

SetSqlDateTime(Int32, SqlDateTime)

Affecte la valeur SqlDateTime spécifiée aux données stockées dans la colonne.

SetSqlDecimal(Int32, SqlDecimal)

Affecte la valeur SqlDecimal spécifiée aux données stockées dans la colonne.

SetSqlDouble(Int32, SqlDouble)

Affecte la valeur SqlDouble spécifiée aux données stockées dans la colonne.

SetSqlGuid(Int32, SqlGuid)

Affecte la valeur SqlGuid spécifiée aux données stockées dans la colonne.

SetSqlInt16(Int32, SqlInt16)

Affecte la valeur SqlInt16 spécifiée aux données stockées dans la colonne.

SetSqlInt32(Int32, SqlInt32)

Affecte la valeur SqlInt32 spécifiée aux données stockées dans la colonne.

SetSqlInt64(Int32, SqlInt64)

Affecte la valeur SqlInt64 spécifiée aux données stockées dans la colonne.

SetSqlMoney(Int32, SqlMoney)

Affecte la valeur SqlMoney spécifiée aux données stockées dans la colonne.

SetSqlSingle(Int32, SqlSingle)

Affecte la valeur SqlSingle spécifiée aux données stockées dans la colonne.

SetSqlString(Int32, SqlString)

Affecte la valeur SqlString spécifiée aux données stockées dans la colonne.

SetSqlXml(Int32, SqlXml)

Affecte la valeur SqlXml spécifiée aux données stockées dans la colonne.

SetString(Int32, String)

Affecte la valeur String spécifiée aux données stockées dans la colonne.

SetTimeSpan(Int32, TimeSpan)

Définit la valeur de la colonne spécifiée sur TimeSpan.

SetValue(Int32, Object)

Définit une nouvelle valeur, exprimée sous la forme d’un type Common Language Runtime (CLR), pour la colonne spécifiée par le numéro de colonne.

SetValues(Object[])

Définit de nouvelles valeurs pour toutes les colonnes dans le SqlDataRecord. Ces valeurs sont exprimées sous forme de types du Common Language Runtime (CLR).

Implémentations d’interfaces explicites

IDataRecord.GetData(Int32)

Non pris en charge dans cette mise en production.

S’applique à