SqlDataReader.Close Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.SqlClient.dll

Balíček:

System.Data.SqlClient v4.8.6

SqlDataReader Zavře objekt.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Implementuje

Close()

Příklady

Následující příklad vytvoří SqlConnection, SqlCommanda .SqlDataReader Příklad přečte data a zapíše je do okna konzoly. Kód pak zavře .SqlDataReader Objekt SqlConnection se automaticky zavře na konci using bloku kódu.

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

Poznámky

Pokud chcete použít přidruženou metodu Close pro jakýkoli jiný účel, musíte explicitně volat metoduSqlDataReader.SqlConnection

Metoda Close vyplní hodnoty pro výstupní parametry, vrátí hodnoty a RecordsAffectedzvýší dobu potřebnou k zavření objektu SqlDataReader , který byl použit ke zpracování velkého nebo složitého dotazu. Pokud návratové hodnoty a počet záznamů ovlivněných dotazem nejsou významné, může být doba potřebná k uzavření objektu SqlDataReader zkrácena voláním Cancel metody přidruženého SqlCommand objektu před voláním Close metody.

Upozornění

Nevolejte Close ani Dispose na Připojení, DataReader ani žádný jiný spravovaný objekt v Finalize metodě vaší třídy. V finalizátoru byste měli uvolnit pouze nespravované prostředky, které vaše třída vlastní přímo. Pokud vaše třída nevlastní žádné nespravované prostředky, nezahrnujte do definice třídy metodu Finalize . Další informace najdete v tématu Uvolňování paměti.

Viz také

• Adaptéry a čtečky dat
• SQL Server a ADO.NET
• Sdružování připojení SQL Serveru (ADO.NET)
• Přehled ADO.NET