Classe SqlDataReader (System.Data.SqlClient)

Per creare un oggetto SqlDataReader, è necessario chiamare il metodo ExecuteReader dell'oggetto SqlCommand, anziché utilizzare direttamente un costruttore.

Mentre l'oggetto SqlDataReader è in uso, l'oggetto SqlConnection associato è occupato a rendere disponibile l'oggetto SqlDataReader e non sarà possibile eseguire alcuna operazione sull'oggetto SqlConnection se non chiuderlo. almeno fino a quando non viene chiamato il metodo Close dell'oggetto SqlDataReader. Non è possibile, ad esempio, recuperare parametri di output se non dopo aver chiamato il metodo Close.

Le modifiche apportate a un gruppo di risultati da un altro processo o thread durante la lettura dei dati, sono visualizzabili dagli utenti di SqlDataReader. Il comportamento preciso, comunque, dipende dal tempo.

IsClosed e RecordsAffected sono le uniche proprietà che è possibile chiamare dopo la chiusura della classe SqlDataReader. Anche se è possibile accedere alla proprietà RecordsAffected in presenza dell'oggetto SqlDataReader, è preferibile chiamare sempre il metodo Close prima della restituzione del valore della proprietà RecordsAffected per essere certi dell'esattezza del valore restituito.

Nota
Per prestazioni ottimali, l'oggetto SqlDataReader evita la creazione di oggetti non necessari o di copie superflue di dati. Di conseguenza, in caso di più chiamate ai metodi come GetValue verrà restituito un riferimento allo stesso oggetto. Prestare attenzione in caso di modifica del valore sottostante degli oggetti restituiti dai metodi come GetValue.

Nell'esempio che segue vengono creati un oggetto SqlConnection, un oggetto SqlCommand e un oggetto SqlDataReader. I dati sono letti e quindi scritti nella finestra della console. Il codice chiude l'oggetto SqlDataReader. L'oggetto SqlConnection viene chiuso automaticamente alla fine del blocco di codice using.

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

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";

    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti

Altre risorse