Partager via


OleDbCommand.ExecuteReader Méthode

Définition

Envoie la CommandText valeur à l’élément Connection et génère un OleDbDataReader.

Surcharges

Nom Description
ExecuteReader()

Envoie la CommandText valeur à l’élément Connection et génère un OleDbDataReader.

ExecuteReader(CommandBehavior)

Envoie la CommandText valeur à l’objet Connection, et génère une OleDbDataReader valeur à l’aide de l’une CommandBehavior des valeurs.

ExecuteReader()

Source:
OleDbCommand.cs
Source:
OleDbCommand.cs
Source:
OleDbCommand.cs
Source:
OleDbCommand.cs

Envoie la CommandText valeur à l’élément Connection et génère un OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();
public System.Data.OleDb.OleDbDataReader ExecuteReader();
override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader () As OleDbDataReader

Retours

Objet OleDbDataReader.

Exceptions

Impossible d’exécuter une commande dans un contexte de transaction qui diffère du contexte dans lequel la connexion a été initialement inscrite.

Exemples

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

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}
Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    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.

Avant de fermer l’objet OleDbConnection, fermez d’abord l’objet OleDbDataReader . Vous devez également fermer l’objet OleDbDataReader si vous envisagez de réutiliser un OleDbCommand objet.

Voir aussi

S’applique à

ExecuteReader(CommandBehavior)

Source:
OleDbCommand.cs
Source:
OleDbCommand.cs
Source:
OleDbCommand.cs
Source:
OleDbCommand.cs

Envoie la CommandText valeur à l’objet Connection, et génère une OleDbDataReader valeur à l’aide de l’une CommandBehavior des valeurs.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.OleDb.OleDbDataReader ExecuteReader(System.Data.CommandBehavior behavior);
override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader
member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Paramètres

behavior
CommandBehavior

Une des CommandBehavior valeurs.

Retours

Objet OleDbDataReader.

Exceptions

Impossible d’exécuter une commande dans un contexte de transaction qui diffère du contexte dans lequel la connexion a été initialement inscrite.

Exemples

L’exemple suivant crée un OleDbCommand, 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.

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}
Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

Remarques

Lorsque vous spécifiez SingleRow avec la ExecuteReader méthode de l’objet OleDbCommand , le fournisseur de données .NET Framework pour OLE DB effectue une liaison à l’aide de l’interface IRow OLE DB s’il est disponible. Sinon, il utilise l’interface IRowset . Si votre instruction SQL est censée retourner une seule ligne, la spécification peut également améliorer les performances de SingleRow l’application.

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.

Il OleDbDataReader prend en charge un mode spécial qui permet de lire efficacement les valeurs binaires volumineuses. Pour plus d’informations, consultez le SequentialAccess paramètre pour CommandBehavior.

Avant de fermer l’objet OleDbConnection, fermez d’abord l’objet OleDbDataReader . Vous devez également fermer l’objet OleDbDataReader si vous envisagez de réutiliser un OleDbCommand objet. Si la OleDbDataReader valeur est créée avec CommandBehavior la valeur définie CloseConnection, la fermeture de la connexion se ferme OleDbDataReader automatiquement.

Voir aussi

S’applique à