SqlDataReader SqlDataReader SqlDataReader SqlDataReader Class

Definizione

Consente di leggere un flusso forward-only di righe da un database SQL Server.Provides a way of reading a forward-only stream of rows from a SQL Server database. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable
public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable
type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDisposable
    interface IDataRecord
Public Class SqlDataReader
Inherits DbDataReader
Implements IDisposable
Ereditarietà
Implementazioni

Esempi

L'esempio seguente crea una SqlConnection, una SqlCommande un SqlDataReader.The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. L'esempio legge i dati, scrittura alla finestra della console.The example reads through the data, writing it out to the console window. Il codice quindi lo chiude il SqlDataReader.The code then closes the SqlDataReader. Il SqlConnection viene chiuso automaticamente alla fine del using blocco di codice.The SqlConnection is closed automatically at the end of the using code block.

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

}
Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim str As String = "Data Source=(local);Initial Catalog=Northwind;" _
       & "Integrated Security=SSPI;"
        ReadOrderData(str)
    End Sub

    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()
                ReadSingleRow(CType(reader, IDataRecord))
            End While

            ' Call Close when done reading.
            reader.Close()
        End Using
    End Sub

    Private Sub ReadSingleRow(ByVal record As IDataRecord)
       Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))

    End Sub

End Module

Commenti

Per creare un SqlDataReader, è necessario chiamare il ExecuteReader metodo il SqlCommand oggetto, anziché utilizzare direttamente un costruttore.To create a SqlDataReader, you must call the ExecuteReader method of the SqlCommand object, instead of directly using a constructor.

Mentre il SqlDataReader viene usato, associato SqlConnection sono occupati a soddisfare le SqlDataReader, e non altre operazioni possono essere eseguite sul SqlConnection chiudendola diverso da.While the SqlDataReader is being used, the associated SqlConnection is busy serving the SqlDataReader, and no other operations can be performed on the SqlConnection other than closing it. Questo è il caso finché il Close metodo del SqlDataReader viene chiamato.This is the case until the Close method of the SqlDataReader is called. Ad esempio, è Impossibile recuperare i parametri di output fino a dopo aver chiamato Close.For example, you cannot retrieve output parameters until after you call Close.

Le modifiche apportate a un set di risultati, un altro processo o thread durante la lettura dei dati possono essere visibili all'utente di SqlDataReader.Changes made to a result set by another process or thread while data is being read may be visible to the user of the SqlDataReader. Tuttavia, il comportamento preciso dipende dal tempo.However, the precise behavior is timing dependent.

IsClosed e RecordsAffected sono le uniche proprietà che è possibile chiamare dopo il SqlDataReader viene chiuso.IsClosed and RecordsAffected are the only properties that you can call after the SqlDataReader is closed. Anche se il RecordsAffected può accedere alla proprietà mentre la SqlDataReader esiste, chiamare sempre Close prima di restituire il valore di RecordsAffected per garantire un valore restituito accurato.Although the RecordsAffected property may be accessed while the SqlDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Quando si usa l'accesso sequenziale (CommandBehavior.SequentialAccess), un' InvalidOperationException se verrà generato il SqlDataReader posizione è avanzata e un'altra lettura viene tentata un'operazione su della colonna precedente.When using sequential access (CommandBehavior.SequentialAccess), an InvalidOperationException will be raised if the SqlDataReader position is advanced and another read operation is attempted on the previous column.

Nota

Per ottenere prestazioni ottimali, SqlDataReader evita la creazione di oggetti non necessari o creare inutili copie dei dati.For optimal performance, SqlDataReader avoids creating unnecessary objects or making unnecessary copies of data. Pertanto, più chiamate ai metodi, ad esempio GetValue restituiscono un riferimento allo stesso oggetto.Therefore, multiple calls to methods such as GetValue return a reference to the same object. Prestare attenzione se si modifica il valore sottostante degli oggetti restituiti dai metodi, ad esempio GetValue.Use caution if you are modifying the underlying value of the objects returned by methods such as GetValue.

Proprietà

Connection Connection Connection Connection

Ottiene l'oggetto SqlConnection associato all'oggetto SqlDataReader.Gets the SqlConnection associated with the SqlDataReader.

Depth Depth Depth Depth

Ottiene un valore che indica la profondità dell'annidamento per la riga corrente.Gets a value that indicates the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

Ottiene il numero di colonne nella riga corrente.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Ottiene un valore che indica se la classe SqlDataReader contiene una o più righe.Gets a value that indicates whether the SqlDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Recupera un valore Boolean che indica se l'istanza SqlDataReader specificata è stata chiusa.Retrieves a Boolean value that indicates whether the specified SqlDataReader instance has been closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della colonna.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

Ottiene il valore della colonna specificata nel formato nativo, dato il nome della colonna.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione Transact-SQL.Gets the number of rows changed, inserted, or deleted by execution of the Transact-SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Ottiene il numero di campi non nascosti in SqlDataReader.Gets the number of fields in the SqlDataReader that are not hidden.

Metodi

Close() Close() Close() Close()

Chiude l'oggetto SqlDataReader.Closes the SqlDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Ottiene il valore della colonna specificata come valore Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Ottiene il valore della colonna specificata come byte.Gets the value of the specified column as a byte.

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

Legge un flusso di byte dall'offset di colonna specificato, a partire dalla matrice in corrispondenza dell'offset del buffer.Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Ottiene il valore della colonna specificata come singolo carattere.Gets the value of the specified column as a single character.

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

Legge un flusso di caratteri dall'offset di colonna specificato nel buffer, come una matrice che inizia in corrispondenza dell'offset del buffer determinato.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetColumnSchema() GetColumnSchema() GetColumnSchema() GetColumnSchema()
GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Restituisce IDataReader per l'ordinale di colonna specificato.Returns an IDataReader for the specified column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Ottiene una stringa che rappresenta il tipo di dati della colonna specificata.Gets a string representing the data type of the specified column.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Ottiene il valore della colonna specificata come oggetto DateTime.Gets the value of the specified column as a DateTime object.

GetDateTimeOffset(Int32) GetDateTimeOffset(Int32) GetDateTimeOffset(Int32) GetDateTimeOffset(Int32)

Recupera il valore della colonna specificata sotto forma di oggetto DateTimeOffset.Retrieves the value of the specified column as a DateTimeOffset object.

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Ottiene il valore della colonna specificata come oggetto Decimal.Gets the value of the specified column as a Decimal object.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Ottiene il valore della colonna specificata come numero a virgola mobile con precisione doppia.Gets the value of the specified column as a double-precision floating point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Restituisce un oggetto IEnumerator che esegue l'iterazione di SqlDataReader.Returns an IEnumerator that iterates through the SqlDataReader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Ottiene l'oggetto Type che rappresenta il tipo di dati dell'oggetto.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Ottiene in modo sincrono il valore della colonna specificata sotto forma di tipo.Synchronously gets the value of the specified column as a type. GetFieldValueAsync<T>(Int32, CancellationToken) è la versione asincrona di questo metodo.GetFieldValueAsync<T>(Int32, CancellationToken) is the asynchronous version of this method.

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Ottiene in modo sincrono il valore della colonna specificata come tipo.Asynchronously gets the value of the specified column as a type. GetFieldValue<T>(Int32) è la versione sincrona di questo metodo.GetFieldValue<T>(Int32) is the synchronous version of this method.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Ottiene il valore della colonna specificata come numero a virgola mobile con precisione singola.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Ottiene il valore della colonna specificata come identificatore univoco globale (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Ottiene il valore della colonna specificata come intero con segno a 32 bit.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Ottiene il valore della colonna specificata come integer con segno a 64 bit.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Ottiene il nome della colonna specificata.Gets the name of the specified column.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Ottiene la posizione ordinale della colonna, dato il nome della colonna.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Ottiene un oggetto Object che consiste in una rappresentazione del tipo di campo specifico del provider sottostante.Gets an Object that is a representation of the underlying provider-specific field type.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

Ottiene un oggetto Object che consiste in una rappresentazione del valore specifico del provider sottostante.Gets an Object that is a representation of the underlying provider specific value.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[])

Ottiene una matrice di oggetti che sono una rappresentazione dei valori specifici del provider sottostante.Gets an array of objects that are a representation of the underlying provider specific values.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Restituisce un oggetto DataTable che descrive i metadati della colonna di SqlDataReader.Returns a DataTable that describes the column metadata of the SqlDataReader.

GetSqlBinary(Int32) GetSqlBinary(Int32) GetSqlBinary(Int32) GetSqlBinary(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlBinary.Gets the value of the specified column as a SqlBinary.

GetSqlBoolean(Int32) GetSqlBoolean(Int32) GetSqlBoolean(Int32) GetSqlBoolean(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlBoolean.Gets the value of the specified column as a SqlBoolean.

GetSqlByte(Int32) GetSqlByte(Int32) GetSqlByte(Int32) GetSqlByte(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlByte.Gets the value of the specified column as a SqlByte.

GetSqlBytes(Int32) GetSqlBytes(Int32) GetSqlBytes(Int32) GetSqlBytes(Int32)

Ottiene il valore della colonna specificata sotto forma di un oggetto SqlBytes.Gets the value of the specified column as SqlBytes.

GetSqlChars(Int32) GetSqlChars(Int32) GetSqlChars(Int32) GetSqlChars(Int32)

Ottiene il valore della colonna specificata sotto forma di un oggetto SqlChars.Gets the value of the specified column as SqlChars.

GetSqlDateTime(Int32) GetSqlDateTime(Int32) GetSqlDateTime(Int32) GetSqlDateTime(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlDateTime.Gets the value of the specified column as a SqlDateTime.

GetSqlDecimal(Int32) GetSqlDecimal(Int32) GetSqlDecimal(Int32) GetSqlDecimal(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlDecimal.Gets the value of the specified column as a SqlDecimal.

GetSqlDouble(Int32) GetSqlDouble(Int32) GetSqlDouble(Int32) GetSqlDouble(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlDouble.Gets the value of the specified column as a SqlDouble.

GetSqlGuid(Int32) GetSqlGuid(Int32) GetSqlGuid(Int32) GetSqlGuid(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlGuid.Gets the value of the specified column as a SqlGuid.

GetSqlInt16(Int32) GetSqlInt16(Int32) GetSqlInt16(Int32) GetSqlInt16(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlInt16.Gets the value of the specified column as a SqlInt16.

GetSqlInt32(Int32) GetSqlInt32(Int32) GetSqlInt32(Int32) GetSqlInt32(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlInt32.Gets the value of the specified column as a SqlInt32.

GetSqlInt64(Int32) GetSqlInt64(Int32) GetSqlInt64(Int32) GetSqlInt64(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlInt64.Gets the value of the specified column as a SqlInt64.

GetSqlMoney(Int32) GetSqlMoney(Int32) GetSqlMoney(Int32) GetSqlMoney(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlMoney.Gets the value of the specified column as a SqlMoney.

GetSqlSingle(Int32) GetSqlSingle(Int32) GetSqlSingle(Int32) GetSqlSingle(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlSingle.Gets the value of the specified column as a SqlSingle.

GetSqlString(Int32) GetSqlString(Int32) GetSqlString(Int32) GetSqlString(Int32)

Ottiene il valore della colonna specificata sotto forma di classe SqlString.Gets the value of the specified column as a SqlString.

GetSqlValue(Int32) GetSqlValue(Int32) GetSqlValue(Int32) GetSqlValue(Int32)

Restituisce il valore dei dati della colonna specificata come tipo SQL Server.Returns the data value in the specified column as a SQL Server type.

GetSqlValues(Object[]) GetSqlValues(Object[]) GetSqlValues(Object[]) GetSqlValues(Object[])

Riempie una matrice di oggetti Object che contiene i valori relativi a tutte le colonne del record, espressi come tipi SQL Server.Fills an array of Object that contains the values for all the columns in the record, expressed as SQL Server types.

GetSqlXml(Int32) GetSqlXml(Int32) GetSqlXml(Int32) GetSqlXml(Int32)

Ottiene il valore della colonna specificata come valore XML.Gets the value of the specified column as an XML value.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Recupera i tipi di dati binary, image, varbinary, UDT e variant come Stream.Retrieves binary, image, varbinary, UDT, and variant data types as a Stream.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Ottiene il valore della colonna specificata sotto forma di stringa.Gets the value of the specified column as a string.

GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32)

Recupera i tipi di dati Char, NChar, NText, NVarChar, text, varChar e Variant come TextReader.Retrieves Char, NChar, NText, NVarChar, text, varChar, and Variant data types as a TextReader.

GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32)

Recupera il valore della colonna specificata sotto forma di oggetto TimeSpan.Retrieves the value of the specified column as a TimeSpan object.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Ottiene il valore della colonna specificata nel formato nativo.Gets the value of the specified column in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Popola una matrice di oggetti con i valori della colonna della riga corrente.Populates an array of objects with the column values of the current row.

GetXmlReader(Int32) GetXmlReader(Int32) GetXmlReader(Int32) GetXmlReader(Int32)

Recupera i dati di tipo XML come XmlReader.Retrieves data of type XML as an XmlReader.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior) IsCommandBehavior(CommandBehavior)

Determina se l'oggetto CommandBehavior specificato corrisponde a SqlDataReader.Determines whether the specified CommandBehavior matches that of the SqlDataReader .

IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Versione asincrona di IsDBNull(Int32) che ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

Il token di annullamento può essere usato per richiedere che l'operazione venga abbandonata prima del timeout del comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.Exceptions will be reported via the returned Task object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Sposta il visualizzatore di dati al risultato successivo, durante la lettura dei risultati delle istruzioni Transact-SQL batch.Advances the data reader to the next result, when reading the results of batch Transact-SQL statements.

NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Una versione asincrona di NextResult() che sposta il lettore dati sul risultato successivo durante la lettura dei risultati di un batch di istruzioni Transact-SQLTransact-SQL.An asynchronous version of NextResult(), which advances the data reader to the next result, when reading the results of batch Transact-SQLTransact-SQL statements.

Il token di annullamento può essere usato per richiedere che l'operazione venga abbandonata prima del timeout del comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.Exceptions will be reported via the returned Task object.

Read() Read() Read() Read()

Sposta l'oggetto SqlDataReader al record successivo.Advances the SqlDataReader to the next record.

ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Versione asincrona di Read(), che avanza il SqlDataReader al record successivo.An asynchronous version of Read(), which advances the SqlDataReader to the next record.

Il token di annullamento può essere usato per richiedere che l'operazione venga abbandonata prima del timeout del comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Le eccezioni verranno segnalate tramite l'oggetto attività restituito.Exceptions will be reported via the returned Task object.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Restituisce IDataReader per l'ordinale di colonna specificato.Returns an IDataReader for the specified column ordinal.

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Rilascia tutte le risorse utilizzate dal lettore dati.Releases all resources that are used by the data reader.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Restituisce un enumeratore che può essere utilizzato per scorrere l'insieme di elementi.Returns an enumerator that can be used to iterate through the item collection.

Si applica a

Vedi anche