OleDbCommand.ExecuteReader Metode

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.3.24172.9

CommandText Mengirim ke Connection dan membangun OleDbDataReader.

Overload

ExecuteReader()	CommandText Mengirim ke Connection dan membangun OleDbDataReader.
ExecuteReader(CommandBehavior)	CommandText Mengirim ke Connection, dan menyusun OleDbDataReader menggunakan salah CommandBehavior satu nilai.

ExecuteReader()

Sumber:

OleDbCommand.cs

CommandText Mengirim ke Connection dan membangun OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

Mengembalikan

OleDbDataReader

Sebuah objekOleDbDataReader.

Pengecualian

InvalidOperationException

Tidak dapat menjalankan perintah dalam konteks transaksi yang berbeda dari konteks di mana koneksi awalnya terdaftar.

Contoh

Contoh berikut membuat OleDbCommand, lalu menjalankannya dengan meneruskan string yang merupakan pernyataan SQL SELECT, dan string yang digunakan untuk menyambungkan ke sumber data.

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

Keterangan

CommandType Ketika properti diatur ke StoredProcedure, CommandText properti harus diatur ke nama prosedur tersimpan. Perintah menjalankan prosedur tersimpan ini saat Anda memanggil ExecuteReader.

Sebelum Anda menutup OleDbConnection, tutup objek terlebih dahulu OleDbDataReader . Anda juga harus menutup OleDbDataReader objek jika Anda berencana untuk menggunakan OleDbCommand kembali objek.

Lihat juga

• Bekerja dengan Perintah

ExecuteReader(CommandBehavior)

Sumber:

OleDbCommand.cs

CommandText Mengirim ke Connection, dan menyusun OleDbDataReader menggunakan salah CommandBehavior satu nilai.

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

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Parameter

behavior

CommandBehavior

Salah CommandBehavior satu nilai.

Mengembalikan

OleDbDataReader

Sebuah objekOleDbDataReader.

Pengecualian

InvalidOperationException

Tidak dapat menjalankan perintah dalam konteks transaksi yang berbeda dari konteks di mana koneksi awalnya terdaftar.

Contoh

Contoh berikut membuat OleDbCommand, lalu menjalankannya dengan meneruskan string yang merupakan pernyataan T-SQL SELECT, dan string yang digunakan untuk menyambungkan ke sumber data. CommandBehavior diatur ke 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

Keterangan

Saat Anda menentukan SingleRow dengan ExecuteReader metode OleDbCommand objek , Penyedia Data .NET Framework untuk OLE DB melakukan pengikatan menggunakan antarmuka OLE DB IRow jika tersedia. Jika tidak, ia menggunakan antarmuka IRowset . Jika pernyataan SQL Anda diharapkan hanya mengembalikan satu baris, menentukan SingleRow juga dapat meningkatkan performa aplikasi.

CommandType Ketika properti diatur ke StoredProcedure, CommandText properti harus diatur ke nama prosedur tersimpan. Perintah menjalankan prosedur tersimpan ini saat Anda memanggil ExecuteReader.

OleDbDataReader mendukung mode khusus yang memungkinkan nilai biner besar dibaca secara efisien. Untuk informasi selengkapnya, lihat SequentialAccess pengaturan untuk CommandBehavior.

Sebelum Anda menutup OleDbConnection, tutup objek terlebih dahulu OleDbDataReader . Anda juga harus menutup OleDbDataReader objek jika Anda berencana untuk menggunakan OleDbCommand kembali objek. OleDbDataReader Jika dibuat dengan CommandBehavior diatur ke CloseConnection, menutup OleDbDataReader menutup koneksi secara otomatis.

Lihat juga

• Bekerja dengan Perintah