OleDbCommand.ExecuteReader Méthode

Définition

Envoie CommandText à Connection et génère OleDbDataReader.

Surcharges

ExecuteReader()

Envoie CommandText à Connection et génère OleDbDataReader.

ExecuteReader(CommandBehavior)

Envoie CommandText à Connection et génère OleDbDataReader à l'aide d'une valeur CommandBehavior.

ExecuteReader()

Envoie CommandText à Connection et génère 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

OleDbDataReader

Objet OleDbDataReader.

Exceptions

Impossible d'exécuter une commande au sein d'un contexte de transaction différent de celui dans lequel la connexion a été inscrite à l'origine.

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é a la valeur StoredProcedure , 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 le OleDbConnection , fermez d’abord l' OleDbDataReader objet. Vous devez également fermer l' OleDbDataReader objet si vous envisagez de réutiliser un OleDbCommand objet.

Voir aussi

S’applique à

ExecuteReader(CommandBehavior)

Envoie CommandText à Connection et génère OleDbDataReader à l'aide d'une valeur CommandBehavior.

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 valeurs de l'objet CommandBehavior.

Retours

OleDbDataReader

Objet OleDbDataReader.

Exceptions

Impossible d'exécuter une commande au sein d'un contexte de transaction différent de celui dans lequel la connexion a été inscrite à l'origine.

Exemples

l’exemple suivant crée un OleDbCommand , puis l’exécute en passant une chaîne qui est une instruction Transact-SQL SELECT et une chaîne à utiliser pour se connecter à la source de données. CommandBehavior a la valeur 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' OleDbCommand objet, la .NET Framework Fournisseur de données pour OLE DB effectue la liaison à l’aide de l’interface OLE DB IRow si elle est disponible. Dans le cas contraire, elle utilise l’interface IRowset . Si votre instruction SQL doit normalement retourner une seule ligne, la spécification de SingleRow peut également améliorer les performances de l'application.

Lorsque la CommandType propriété a la valeur StoredProcedure , 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 .

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

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

Voir aussi

S’applique à