SqlDataReader.Close Methode

Definitie

Hiermee sluit u het SqlDataReader object.

public:
 virtual void Close();
public:
 override void Close();
public void Close();
public override void Close();
abstract member Close : unit -> unit
override this.Close : unit -> unit
override this.Close : unit -> unit
Public Sub Close ()
Public Overrides Sub Close ()

Implementeringen

Voorbeelden

In het volgende voorbeeld wordt een SqlConnection, a SqlCommanden een SqlDataReader. In het voorbeeld worden de gegevens gelezen en naar het consolevenster geschreven. De code sluit vervolgens de SqlDataReader. De SqlConnection code wordt automatisch aan het einde van het using codeblok gesloten.

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

Opmerkingen

U moet de methode expliciet aanroepen wanneer u de CloseSqlDataReader methode gebruikt om de bijbehorende SqlConnection te gebruiken voor een ander doel.

De Close methode vult de waarden voor uitvoerparameters in, retourwaarden en RecordsAffectedverhoogt de tijd die nodig is om een SqlDataReader query te sluiten die is gebruikt voor het verwerken van een grote of complexe query. Wanneer de retourwaarden en het aantal records dat wordt beïnvloed door een query niet significant zijn, kan de tijd die nodig is om de SqlDataReader gegevens te sluiten, worden verminderd door de Cancel methode van het gekoppelde SqlCommand object aan te roepen voordat de methode wordt Close aangeroepen.

Caution

Close Dispose Roep geen verbinding, een DataReader of een ander beheerd object aan in de Finalize methode van uw klasse. In een finalizer moet u alleen onbeheerde resources vrijgeven die rechtstreeks eigendom zijn van uw klasse. Als uw klasse geen onbeheerde resources bezit, neemt u Finalize geen methode op in uw klassedefinitie. Zie Garbagecollection voor meer informatie.

Van toepassing op

Zie ook