Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SqlDataReader classe

 

Date de publication : novembre 2016

Fournit un moyen de lire un flux avant uniquement de lignes à partir d’une base de données SQL Server. Cette classe ne peut pas être héritée.

Espace de noms:   System.Data.SqlClient
Assembly:  System.Data (dans System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlClient.SqlDataReader

public class SqlDataReader : DbDataReader, IDataReader, IDisposable, 
	IDataRecord

NomDescription
System_CAPS_protpropertyConnection

Obtient l'objet SqlConnection associé à l'objet SqlDataReader.

System_CAPS_pubpropertyDepth

Obtient une valeur qui indique la profondeur d’imbrication de la ligne actuelle.(Remplace DbDataReader.Depth.)

System_CAPS_pubpropertyFieldCount

Obtient le nombre de colonnes figurant dans la ligne actuelle.(Remplace DbDataReader.FieldCount.)

System_CAPS_pubpropertyHasRows

Obtient une valeur qui indique si le SqlDataReader contient une ou plusieurs lignes.(Remplace DbDataReader.HasRows.)

System_CAPS_pubpropertyIsClosed

Récupère une valeur booléenne qui indique si le texte spécifié SqlDataReader instance a été fermée.(Remplace DbDataReader.IsClosed.)

System_CAPS_pubpropertyItem[Int32]

Obtient la valeur de la colonne spécifiée dans son format natif en fonction de l’ordinal de colonne.(Remplace DbDataReader.Item[Int32].)

System_CAPS_pubpropertyItem[String]

Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de colonne.(Remplace DbDataReader.Item[String].)

System_CAPS_pubpropertyRecordsAffected

Obtient le nombre de lignes modifiées, insérées ou supprimées par l’exécution de l’instruction Transact-SQL.(Remplace DbDataReader.RecordsAffected.)

System_CAPS_pubpropertyVisibleFieldCount

Obtient le nombre de champs dans SqlDataReader qui ne sont pas masqués.(Remplace DbDataReader.VisibleFieldCount.)

NomDescription
System_CAPS_pubmethodClose()

Ferme l'objet SqlDataReader.(Remplace DbDataReader.Close().)

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par l'instance actuelle de la classe DbDataReader.(Hérité de DbDataReader.)

System_CAPS_protmethodDispose(Boolean)

Libère les ressources managées utilisées par le DbDataReader et libère éventuellement les ressources non managées.(Hérité de DbDataReader.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetBoolean(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'une valeur Boolean.(Remplace DbDataReader.GetBoolean(Int32).)

System_CAPS_pubmethodGetByte(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un octet.(Remplace DbDataReader.GetByte(Int32).)

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

Lit un flux d’octets à partir de l’offset de colonne spécifié dans la mémoire tampon d’un tableau commençant à l’offset de mémoire tampon donnée.(Remplace DbDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32).)

System_CAPS_pubmethodGetChar(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un caractère unique.(Remplace DbDataReader.GetChar(Int32).)

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

Lit un flux de caractères à partir de l’offset de colonne spécifié dans la mémoire tampon comme un tableau en commençant à l’offset de mémoire tampon donnée.(Remplace DbDataReader.GetChars(Int32, Int64, Char[], Int32, Int32).)

System_CAPS_pubmethodGetData(Int32)

Retourne un DbDataReader objet pour l’ordinal de colonne demandé.(Hérité de DbDataReader.)

System_CAPS_pubmethodGetDataTypeName(Int32)

Obtient une chaîne représentant le type de données de la colonne spécifiée.(Remplace DbDataReader.GetDataTypeName(Int32).)

System_CAPS_pubmethodGetDateTime(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime.(Remplace DbDataReader.GetDateTime(Int32).)

System_CAPS_pubmethodGetDateTimeOffset(Int32)

Récupère la valeur de la colonne spécifiée comme un DateTimeOffset objet.

System_CAPS_protmethodGetDbDataReader(Int32)

Retourne un objet DbDataReader pour l'ordinal de colonne demandé qui peut être substitué par une implémentation spécifique au fournisseur.(Hérité de DbDataReader.)

System_CAPS_pubmethodGetDecimal(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal.(Remplace DbDataReader.GetDecimal(Int32).)

System_CAPS_pubmethodGetDouble(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante double précision.(Remplace DbDataReader.GetDouble(Int32).)

System_CAPS_pubmethodGetEnumerator()

Retourne un IEnumerator qui effectue une itération dans le SqlDataReader.(Remplace DbDataReader.GetEnumerator().)

System_CAPS_pubmethodGetFieldType(Int32)

Obtient les Type qui correspond au type de données de l’objet.(Remplace DbDataReader.GetFieldType(Int32).)

System_CAPS_pubmethodGetFieldValue<T>(Int32)

Synchrone Obtient la valeur de la colonne spécifiée sous la forme d’un type. GetFieldValueAsync<T> est la version asynchrone de cette méthode.(Remplace DbDataReader.GetFieldValue<T>(Int32).)

System_CAPS_pubmethodGetFieldValueAsync<T>(Int32)

Obtient la valeur de la colonne spécifiée en tant que type de façon asynchrone.(Hérité de DbDataReader.)

System_CAPS_pubmethodGetFieldValueAsync<T>(Int32, CancellationToken)

Obtient la valeur de la colonne spécifiée en tant que type de façon asynchrone. GetFieldValue<T> est la version synchrone de cette méthode.(Remplace DbDataReader.GetFieldValueAsync<T>(Int32, CancellationToken).)

System_CAPS_pubmethodGetFloat(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante simple précision.(Remplace DbDataReader.GetFloat(Int32).)

System_CAPS_pubmethodGetGuid(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’un identificateur global unique (GUID).(Remplace DbDataReader.GetGuid(Int32).)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetInt16(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 16 bits.(Remplace DbDataReader.GetInt16(Int32).)

System_CAPS_pubmethodGetInt32(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 32 bits.(Remplace DbDataReader.GetInt32(Int32).)

System_CAPS_pubmethodGetInt64(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits.(Remplace DbDataReader.GetInt64(Int32).)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodGetName(Int32)

Obtient le nom de la colonne spécifiée.(Remplace DbDataReader.GetName(Int32).)

System_CAPS_pubmethodGetOrdinal(String)

Obtient l’ordinal de colonne, étant donné le nom de la colonne.(Remplace DbDataReader.GetOrdinal(String).)

System_CAPS_pubmethodGetProviderSpecificFieldType(Int32)

Obtient un Object qui est une représentation du type spécifique au fournisseur sous-jacent.(Remplace DbDataReader.GetProviderSpecificFieldType(Int32).)

System_CAPS_pubmethodGetProviderSpecificValue(Int32)

Obtient un Object qui est une représentation de la valeur sous-jacente spécifique au fournisseur.(Remplace DbDataReader.GetProviderSpecificValue(Int32).)

System_CAPS_pubmethodGetProviderSpecificValues(Object[])

Obtient un tableau d’objets qui constituent une représentation des valeurs sous-jacentes spécifiques au fournisseur.(Remplace DbDataReader.GetProviderSpecificValues(Object[]).)

System_CAPS_pubmethodGetSchemaTable()

Retourne un DataTable qui décrit les métadonnées de colonne de SqlDataReader.(Remplace DbDataReader.GetSchemaTable().)

System_CAPS_pubmethodGetSqlBinary(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlBinary.

System_CAPS_pubmethodGetSqlBoolean(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlBoolean.

System_CAPS_pubmethodGetSqlByte(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlByte.

System_CAPS_pubmethodGetSqlBytes(Int32)

Obtient la valeur de la colonne spécifiée sous la forme SqlBytes.

System_CAPS_pubmethodGetSqlChars(Int32)

Obtient la valeur de la colonne spécifiée sous la forme SqlChars.

System_CAPS_pubmethodGetSqlDateTime(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlDateTime.

System_CAPS_pubmethodGetSqlDecimal(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlDecimal.

System_CAPS_pubmethodGetSqlDouble(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlDouble.

System_CAPS_pubmethodGetSqlGuid(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlGuid.

System_CAPS_pubmethodGetSqlInt16(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlInt16.

System_CAPS_pubmethodGetSqlInt32(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlInt32.

System_CAPS_pubmethodGetSqlInt64(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlInt64.

System_CAPS_pubmethodGetSqlMoney(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlMoney.

System_CAPS_pubmethodGetSqlSingle(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlSingle.

System_CAPS_pubmethodGetSqlString(Int32)

Obtient la valeur de la colonne spécifiée comme un SqlString.

System_CAPS_pubmethodGetSqlValue(Int32)

Retourne la valeur de données dans la colonne spécifiée comme un type SQL Server.

System_CAPS_pubmethodGetSqlValues(Object[])

Remplit un tableau de Object qui contient les valeurs pour toutes les colonnes dans l’enregistrement, exprimées en tant que types SQL Server.

System_CAPS_pubmethodGetSqlXml(Int32)

Obtient la valeur de la colonne spécifiée sous la forme d’une valeur XML.

System_CAPS_pubmethodGetStream(Int32)

Récupère binary, image, varbinary, UDT et types de données variant selon une Stream.(Remplace DbDataReader.GetStream(Int32).)

System_CAPS_pubmethodGetString(Int32)

Obtient la valeur de la colonne spécifiée sous forme de chaîne.(Remplace DbDataReader.GetString(Int32).)

System_CAPS_pubmethodGetTextReader(Int32)

Récupère Char, NChar, NText, NVarChar, text, varChar et types de données Variant comme un TextReader.(Remplace DbDataReader.GetTextReader(Int32).)

System_CAPS_pubmethodGetTimeSpan(Int32)

Récupère la valeur de la colonne spécifiée comme un TimeSpan objet.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetValue(Int32)

Obtient la valeur de la colonne spécifiée dans son format natif.(Remplace DbDataReader.GetValue(Int32).)

System_CAPS_pubmethodGetValues(Object[])

Remplit un tableau d’objets avec les valeurs de colonne de la ligne actuelle.(Remplace DbDataReader.GetValues(Object[]).)

System_CAPS_pubmethodGetXmlReader(Int32)

Récupère des données de type XML comme un XmlReader.

System_CAPS_pubmethodInitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodIsCommandBehavior(CommandBehavior)

Détermine si le texte spécifié CommandBehavior correspond à celle de la SqlDataReader .

System_CAPS_pubmethodIsDBNull(Int32)

Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.(Remplace DbDataReader.IsDBNull(Int32).)

System_CAPS_pubmethodIsDBNullAsync(Int32)

Une version asynchrone de IsDBNull, qui obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.(Hérité de DbDataReader.)

System_CAPS_pubmethodIsDBNullAsync(Int32, CancellationToken)

Une version asynchrone de IsDBNull, qui obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l’objet Task retourné.(Remplace DbDataReader.IsDBNullAsync(Int32, CancellationToken).)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle d’actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodNextResult()

Avance le lecteur de données jusqu’au résultat suivant, lors de la lecture des résultats d’instructions par lots Transact-SQL.(Remplace DbDataReader.NextResult().)

System_CAPS_pubmethodNextResultAsync()

Une version asynchrone de NextResult, qui avance le lecteur jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions.

Appelle NextResultAsync avec CancellationToken.None.(Hérité de DbDataReader.)

System_CAPS_pubmethodNextResultAsync(CancellationToken)

Une version asynchrone de NextResult, qui avance le lecteur de données jusqu’au résultat suivant, lors de la lecture des résultats d’un lot Transact-SQL instructions.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l'objet Task retourné.(Remplace DbDataReader.NextResultAsync(CancellationToken).)

System_CAPS_pubmethodRead()

Fait passer le SqlDataReader à l’enregistrement suivant.(Remplace DbDataReader.Read().)

System_CAPS_pubmethodReadAsync()

Une version asynchrone de Read, qui avance le lecteur jusqu'à l’enregistrement suivant d’un jeu de résultats. Cette méthode appelle ReadAsync avec CancellationToken.None.(Hérité de DbDataReader.)

System_CAPS_pubmethodReadAsync(CancellationToken)

Une version asynchrone de Read, les progrès du SqlDataReader à l’enregistrement suivant.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule. Les exceptions seront signalées via l'objet Task retourné.(Remplace DbDataReader.ReadAsync(CancellationToken).)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataRecord.GetData(Int32)

Retourne un IDataReader pour l'ordinal de colonne spécifié.

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

To create a T:System.Data.SqlClient.SqlDataReader, you must call the M:System.Data.SqlClient.SqlCommand.ExecuteReader method of the T:System.Data.SqlClient.SqlCommand object, instead of directly using a constructor.

While the T:System.Data.SqlClient.SqlDataReader is being used, the associated T:System.Data.SqlClient.SqlConnection is busy serving the T:System.Data.SqlClient.SqlDataReader, and no other operations can be performed on the T:System.Data.SqlClient.SqlConnection other than closing it. This is the case until the M:System.Data.SqlClient.SqlDataReader.Close method of the T:System.Data.SqlClient.SqlDataReader is called. For example, you cannot retrieve output parameters until after you call M:System.Data.SqlClient.SqlDataReader.Close.

Changes made to a result set by another process or thread while data is being read may be visible to the user of the SqlDataReader. However, the precise behavior is timing dependent.

IsClosed and RecordsAffected are the only properties that you can call after the SqlDataReader is closed. Although the RecordsAffected property may be accessed while the SqlDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

When using sequential access (F:System.Data.CommandBehavior.SequentialAccess), an T:System.InvalidOperationException will be raised if the T:System.Data.SqlClient.SqlDataReader position is advanced and another read operation is attempted on the previous column.

System_CAPS_noteRemarque

For optimal performance, T:System.Data.SqlClient.SqlDataReader avoids creating unnecessary objects or making unnecessary copies of data. Therefore, multiple calls to methods such as M:System.Data.SqlClient.SqlDataReader.GetValue(System.Int32) return a reference to the same object. Use caution if you are modifying the underlying value of the objects returned by methods such as M:System.Data.SqlClient.SqlDataReader.GetValue(System.Int32).

The following example creates a T:System.Data.SqlClient.SqlConnection, a T:System.Data.SqlClient.SqlCommand, and a T:System.Data.SqlClient.SqlDataReader. The example reads through the data, writing it out to the console window. The code then closes the T:System.Data.SqlClient.SqlDataReader. The T:System.Data.SqlClient.SqlConnection is closed automatically at the end of the using code block.

using System;
using System.Data;
using System.Data.SqlClient;


class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    private static void ReadOrderData(string connectionString)
    {
        string queryString =
            "SELECT OrderID, CustomerID FROM dbo.Orders;";

        using (SqlConnection connection =
                   new SqlConnection(connectionString))
        {
            SqlCommand command =
                new SqlCommand(queryString, connection);
            connection.Open();

            SqlDataReader reader = command.ExecuteReader();

            // Call Read before accessing data.
            while (reader.Read())
            {
                ReadSingleRow((IDataRecord)reader);
            }

            // Call Close when done reading.
            reader.Close();
        }
    }

    private static void ReadSingleRow(IDataRecord record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: