SqlCommand.ExecuteReader Méthode

Source:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlDataReader ^ ExecuteReader();

public System.Data.SqlClient.SqlDataReader ExecuteReader();

override this.ExecuteReader : unit -> System.Data.SqlClient.SqlDataReader

member this.ExecuteReader : unit -> System.Data.SqlClient.SqlDataReader

Public Function ExecuteReader () As SqlDataReader

Retours

Objet SqlDataReader.

Exceptions

Exemples

L’exemple suivant crée un SqlCommand, puis l’exécute en passant une chaîne qui est une instruction SELECT Transact-SQL et une chaîne à utiliser pour se connecter à la source de données.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        connection.Open();

        SqlCommand command = new SqlCommand(queryString, connection);
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As New SqlCommand(queryString, connection)
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Remarques

Lorsque la CommandType propriété est définie StoredProceduresur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.

La fonctionnalité MARS (Multiple Active Result Set) permet plusieurs actions à l’aide de la même connexion.

Si vous utilisez ExecuteReader ou BeginExecuteReader pour accéder aux données XML, SQL Server retourne tous les résultats XML supérieurs à 2 033 caractères de longueur dans plusieurs lignes de 2 033 caractères chacun. Pour éviter ce comportement, utilisez ExecuteXmlReader ou BeginExecuteXmlReader lisez des requêtes FOR XML.

Voir aussi

• Extraction et modification de données dans ADO.NET
• SQL Server et ADO.NET
• Vue d'ensemble d’ADO.NET

Source:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.SqlClient.SqlDataReader ExecuteReader(System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.SqlClient.SqlDataReader

member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.SqlClient.SqlDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

Paramètres

Retours

Objet SqlDataReader.

Exceptions

Exemples

L’exemple suivant crée un SqlCommand, puis l’exécute en passant une chaîne qui est une instruction SELECT Transact-SQL et une chaîne à utiliser pour se connecter à la source de données. CommandBehavior est défini sur CloseConnection.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        connection.Open();
        using(SqlDataReader reader =
            command.ExecuteReader(CommandBehavior.CloseConnection))
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = _
            command.ExecuteReader(CommandBehavior.CloseConnection)
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Remarques

Lorsque la CommandType propriété est définie StoredProceduresur , la CommandText propriété doit être définie sur le nom de la procédure stockée. La commande exécute cette procédure stockée lorsque vous appelez ExecuteReader.

La fonctionnalité MARS (Multiple Active Result Set) permet plusieurs actions à l’aide de la même connexion.

Si vous utilisez ExecuteReader ou BeginExecuteReader pour accéder aux données XML, SQL Server retourne tous les résultats XML supérieurs à 2 033 caractères de longueur dans plusieurs lignes de 2 033 caractères chacun. Pour éviter ce comportement, utilisez ExecuteXmlReader ou BeginExecuteXmlReader lisez des requêtes FOR XML.

Voir aussi

• Connexion et récupération de données dans ADO.NET
• Utilisation du fournisseur de données .NET Framework pour SQL Server
• Vue d'ensemble d’ADO.NET