SqlDataReader.Close Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.8.6

SqlDataReader Nesneyi kapatır.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Uygulamalar

Close()

Örnekler

Aşağıdaki örnek, bir SqlConnection, SqlCommandve SqlDataReaderoluşturur. Örnek, konsol penceresine yazarak verileri okur. Kod daha sonra öğesini SqlDataReaderkapatır. SqlConnection, kod bloğunun using sonunda otomatik olarak kapatılır.

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();
            }
        }
    }
}

Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Açıklamalar

başka bir amaçla ilişkili SqlConnection kullanmak için kullanırken SqlDataReader yöntemini açıkça çağırmanız Close gerekir.

Close yöntemi, çıkış parametrelerinin değerlerini doldurur, değerleri döndürür ve RecordsAffectedbüyük veya karmaşık bir sorguyu işlemek için kullanılan bir SqlDataReader sorguyu kapatmak için gereken süreyi artırır. Dönüş değerleri ve bir sorgudan etkilenen kayıt sayısı önemli olmadığında, yöntemini çağırmadan Close önce ilişkili SqlCommand nesnenin Cancel yöntemini çağırarak öğesini kapatmak SqlDataReader için gereken süre azaltılabilir.

Dikkat

Sınıfınızın yönteminde Connection, DataReader veya başka bir yönetilen nesne Finalize çağırmayın CloseDispose veya çağırmayın. Sonlandırıcıda, yalnızca sınıfınızın doğrudan sahip olduğu yönetilmeyen kaynakları serbest bırakmanız gerekir. Sınıfınız yönetilmeyen kaynaklara sahip değilse, sınıf tanımınıza bir Finalize yöntem eklemeyin. Daha fazla bilgi için bkz . Çöp Toplama.

Ayrıca bkz.

• DataAdapters ve DataReaders
• SQL Server ve ADO.NET
• SQL Server Bağlantı Havuzu (ADO.NET)
• ADO.NET’e Genel Bakış