Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Interfaccia IDataReader

 

Consente di leggere uno o più flussi forward-only di set di risultati ottenuti eseguendo un comando in corrispondenza di un'origine dati e viene implementata dai provider di dati .NET Framework che accedono a database relazionali.

Spazio dei nomi:   System.Data
Assembly:  System.Data (in System.Data.dll)

public interface IDataReader : IDisposable, IDataRecord

NomeDescrizione
System_CAPS_pubpropertyDepth

Ottiene un valore che indica il livello di annidamento della riga corrente.

System_CAPS_pubpropertyFieldCount

Ottiene il numero di colonne nella riga corrente.(Ereditato da IDataRecord.)

System_CAPS_pubpropertyIsClosed

Ottiene un valore che indica se il lettore dati è chiuso.

System_CAPS_pubpropertyItem[Int32]

Ottiene la colonna che si trova in corrispondenza dell'indice specificato.(Ereditato da IDataRecord.)

System_CAPS_pubpropertyItem[String]

Ottiene la colonna con il nome specificato.(Ereditato da IDataRecord.)

System_CAPS_pubpropertyRecordsAffected

Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL.

NomeDescrizione
System_CAPS_pubmethodClose()

Chiude l'oggetto IDataReader.

System_CAPS_pubmethodDispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.(Ereditato da IDisposable.)

System_CAPS_pubmethodGetBoolean(Int32)

Ottiene il valore della colonna specificata come valore Boolean.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetByte(Int32)

Ottiene il valore dell'intero senza segno a 8 bit della colonna specificata.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetBytes(Int32, Int64, Byte[], Int32, Int32)

Legge un flusso di byte dall'offset di colonna specificato nel buffer come matrice, a partire dall'offset del buffer specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetChar(Int32)

Ottiene il valore del carattere della colonna specificata.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetChars(Int32, Int64, Char[], Int32, Int32)

Legge un flusso di caratteri dall'offset di colonna specificato nel buffer come matrice, a partire dall'offset del buffer specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetData(Int32)

Restituisce IDataReader per l'ordinale di colonna specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetDataTypeName(Int32)

Ottiene le informazioni sul tipo di dati per il campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetDateTime(Int32)

Ottiene il valore dei dati di data e ora del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetDecimal(Int32)

Ottiene il valore numerico con posizione fissa del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetDouble(Int32)

Ottiene il numero a virgola mobile con precisione doppia del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetFieldType(Int32)

Ottiene le informazioni relative a Type corrispondenti al tipo di Object che verrebbe restituito da GetValue.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetFloat(Int32)

Ottiene il numero a virgola mobile con precisione singola del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetGuid(Int32)

Restituisce il valore GUID del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetInt16(Int32)

Ottiene il valore dell'intero con segno a 16 bit del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetInt32(Int32)

Ottiene il valore dell'intero con segno a 32 bit del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetInt64(Int32)

Ottiene il valore dell'intero con segno a 64 bit del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetName(Int32)

Ottiene il nome del campo da trovare.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetOrdinal(String)

Restituisce l'indice del campo denominato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetSchemaTable()

Restituisce un oggetto DataTable che descrive i metadati della colonna di IDataReader.

System_CAPS_pubmethodGetString(Int32)

Ottiene il valore stringa del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetValue(Int32)

Restituisce il valore del campo specificato.(Ereditato da IDataRecord.)

System_CAPS_pubmethodGetValues(Object[])

Popola una matrice di oggetti con i valori della colonna del record corrente.(Ereditato da IDataRecord.)

System_CAPS_pubmethodIsDBNull(Int32)

Indica se il campo specificato è impostato su Null.(Ereditato da IDataRecord.)

System_CAPS_pubmethodNextResult()

Sposta il lettore dati al risultato successivo durante la lettura dei risultati di un batch di istruzioni SQL.

System_CAPS_pubmethodRead()

Sposta l'oggetto IDataReader al record successivo.

Il IDataReader e IDataRecord interfacce consentono a una classe che eredita implementare un DataReader (classe), che fornisce un mezzo per la lettura di uno o più flussi forward-only di set di risultati. Per ulteriori informazioni sulle classi DataReader, vedi Recupero di dati mediante un DataReader.

Un'applicazione crea un'istanza di IDataReader interfaccia direttamente, ma crea un'istanza di una classe che eredita IDataReader.

Le classi che ereditano IDataReader deve implementare i membri ereditati e in genere definire membri aggiuntivi per aggiungere funzionalità specifiche del provider.

Le modifiche apportate a un gruppo di risultati da un altro processo o thread durante la lettura di dati possono essere visibili all'utente di una classe che implementa un IDataReader. Tuttavia, il comportamento preciso è provider dipende sia temporizzazione.

Note per gli implementatori:

Per promuovere la coerenza fra i provider di dati .NET Framework, assegnare un nome alla classe che eredita il form Prv Command, dove Prv è il prefisso uniforme assegnato a tutte le classi in uno specifico spazio dei nomi provider di dati .NET Framework. Ad esempio, Sql è il prefisso del SqlDataAdapter classe il System.Data.SqlClient dello spazio dei nomi.

Non è possibile creare un'istanza di un DataReader direttamente alla classe. Invece possibile ottenere il DataReader istanza tramite il ExecuteReader metodo il Command oggetto. Pertanto, è necessario contrassegnare DataReader costruttori come interni.

Nell'esempio seguente crea istanze di classi derivate, SqlConnection, SqlCommand, e SqlDataReader. Nell'esempio legge i dati, scrivono nella console. Infine, l'esempio chiude il SqlDataReader, quindi il SqlConnection.

using System;
using System.Data;
using System.Data.SqlClient;


class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    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())
            {
                ReadSingleRow((IDataRecord)reader);
            }

            // Call Close when done reading.
            reader.Close();
        }
    }

    private static void ReadSingleRow(IDataRecord record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: