SqlDataReader.Close Méthode

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.dll

Ferme l’objet SqlDataReader .

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

Implémente

Close()

Exemples

L’exemple suivant crée un SqlConnection, un SqlCommandet un SqlDataReader. L’exemple lit les données, en l’écrivant dans la fenêtre de console. Le code ferme ensuite le SqlDataReader. La SqlConnection fermeture est automatiquement à la fin du using bloc de code.

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

Remarques

Vous devez appeler explicitement la Close méthode lorsque vous utilisez la SqlDataReader méthode pour utiliser l’objet associé SqlConnection à tout autre objectif.

La Close méthode remplit les valeurs des paramètres de sortie, des valeurs de retour et RecordsAffected, en augmentant le temps nécessaire à la fermeture d’une SqlDataReader requête volumineuse ou complexe. Lorsque les valeurs de retour et le nombre d’enregistrements affectés par une requête ne sont pas significatifs, le temps nécessaire à la fermeture de l’objet SqlDataReader peut être réduit en appelant la Cancel méthode de l’objet associé SqlCommand avant d’appeler la Close méthode.

Avertissement

N’appelez Close pas ou Dispose sur une connexion, un DataReader ou tout autre objet managé dans la Finalize méthode de votre classe. Dans un finaliseur, vous devez uniquement libérer des ressources non managées que votre classe possède directement. Si votre classe ne possède pas de ressource non managée, n'incluez pas une méthode Finalize dans la définition de classe. Pour plus d’informations, consultez Collecte des ordures.

S’applique à

Voir aussi