SqlDataReader.Close Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

SqlDataReader Menutup objek.

public:
 override void Close();

public override void Close();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Penerapan

Close()

Contoh

Contoh berikut membuat SqlConnection, , SqlCommanddan SqlDataReader. Contohnya membaca data, menulisnya ke jendela konsol. Kode kemudian menutup SqlDataReader. SqlConnection ditutup secara otomatis di akhir using blok kode.

using Microsoft.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))
        {
            connection.Open();

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

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

Keterangan

Anda harus memastikan metode dipanggil Close ketika Anda melalui penggunaan SqlDataReader sebelum menggunakan yang terkait SqlConnection untuk tujuan lain. Metode Close ini dapat dipanggil secara langsung atau melalui Dispose metode , membuang secara langsung atau dalam konteks menggunakan blok pernyataan .

Metode ini Close mengisi nilai untuk parameter output, mengembalikan nilai dan RecordsAffected pada SqlDataReader dengan mengonsumsi hasil yang tertunda. Ini mungkin operasi yang panjang tergantung pada jumlah data yang akan dikonsumsi. Jika nilai output, mengembalikan nilai, dan RecordsAffected tidak penting untuk aplikasi Anda, waktu untuk menutup dapat dipersingkat Cancel dengan memanggil metode objek terkait SqlCommand sebelum Close metode dipanggil.

Perhatian

Jangan memanggil Close atau Dispose pada Koneksi, DataReader, atau objek terkelola lainnya dalam Finalize metode kelas Anda. Dalam finalizer, Anda hanya boleh merilis sumber daya yang tidak dikelola yang dimiliki kelas Anda secara langsung. Jika kelas Anda tidak memiliki sumber daya yang tidak dikelola, jangan sertakan metode Finalize dalam definisi kelas Anda. Untuk informasi lebih lanjut, lihat Pengumpulan Sampah.