SqlDataReader SqlDataReader SqlDataReader SqlDataReader Class

Definição

Fornece uma maneira de ler um fluxo somente de encaminhamento de linhas com base em um banco de dados SQL Server.Provides a way of reading a forward-only stream of rows from a SQL Server database. Essa classe não pode ser herdada.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
Herança
Implementações

Exemplos

O exemplo a seguir cria SqlConnectionum, SqlCommandum e um SqlDataReader.The following example creates a SqlConnection, a SqlCommand, and a SqlDataReader. O exemplo lê os dados, gravando-os na janela do console.The example reads through the data, writing it out to the console window. Em seguida, o código SqlDataReaderfecha o.The code then closes the SqlDataReader. O SqlConnection é fechado automaticamente no final using do bloco de código.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

Comentários

Para criar um SqlDataReader, você deve chamar o ExecuteReader método do SqlCommand objeto, em vez de usar um construtor diretamente.To create a SqlDataReader, you must call the ExecuteReader method of the SqlCommand object, instead of directly using a constructor.

Enquanto o SqlDataReader está sendo usado, o associado SqlConnection está ocupado atendendo SqlDataReaderao, e nenhuma outra operação pode ser executada em SqlConnection outra parte do que fechá-lo.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. Esse é o caso até que Close o método SqlDataReader do seja chamado.This is the case until the Close method of the SqlDataReader is called. Por exemplo, você não pode recuperar parâmetros de saída até depois Closede chamar.For example, you cannot retrieve output parameters until after you call Close.

As alterações feitas em um conjunto de resultados por outro processo ou thread enquanto os dados estão sendo lidos podem ser visíveis para SqlDataReadero usuário do.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. No entanto, o comportamento preciso é dependente de tempo.However, the precise behavior is timing dependent.

IsClosede RecordsAffected são as únicas propriedades que você pode chamar depois que SqlDataReader o é fechado.IsClosed and RecordsAffected are the only properties that you can call after the SqlDataReader is closed. Embora a RecordsAffected Propriedade possa ser acessada SqlDataReader enquanto Exists, Close sempre chame antes de retornar RecordsAffected o valor de para garantir um valor de retorno preciso.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.

Ao usar o acesso sequencial (CommandBehavior.SequentialAccess), um InvalidOperationException será gerado se SqlDataReader a posição for avançada e outra operação de leitura for tentada na coluna anterior.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.

Observação

Para um desempenho ideal SqlDataReader , evita a criação de objetos desnecessários ou a realização de cópias desnecessárias de dados.For optimal performance, SqlDataReader avoids creating unnecessary objects or making unnecessary copies of data. Portanto, várias chamadas para métodos como GetValue retornam uma referência ao mesmo objeto.Therefore, multiple calls to methods such as GetValue return a reference to the same object. Tome cuidado se você estiver modificando o valor subjacente dos objetos retornados por métodos como GetValue.Use caution if you are modifying the underlying value of the objects returned by methods such as GetValue.

Propriedades

Connection Connection Connection Connection

Obtém o SqlConnection associado ao SqlDataReader.Gets the SqlConnection associated with the SqlDataReader.

Depth Depth Depth Depth

Obtém um valor que indica a profundidade de aninhamento da linha atual.Gets a value that indicates the depth of nesting for the current row.

FieldCount FieldCount FieldCount FieldCount

Obtém o número de colunas na linha atual.Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Obtém um valor que indica se o SqlDataReader contém uma ou mais linhas.Gets a value that indicates whether the SqlDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Recupera um valor Booliano que indica se a instância SqlDataReader especificada foi fechada.Retrieves a Boolean value that indicates whether the specified SqlDataReader instance has been closed.

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

Obtém o valor da coluna especificada em seu formato nativo de acordo com o ordinal da coluna.Gets the value of the specified column in its native format given the column ordinal.

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

Obtém o valor da coluna especificada em seu formato nativo de acordo com o nome da coluna.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Obtém o número de linhas alteradas, inseridas ou excluídas pela execução da instrução Transact-SQL.Gets the number of rows changed, inserted, or deleted by execution of the Transact-SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Obtém o número de campos em SqlDataReader que não estão ocultos.Gets the number of fields in the SqlDataReader that are not hidden.

Métodos

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

Fecha o objeto SqlDataReader.Closes the SqlDataReader object.

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

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto 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 o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

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

Obtém o valor da coluna especificada como um booliano.Gets the value of the specified column as a Boolean.

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

Obtém o valor da coluna especificada como um 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)

Lê um fluxo de bytes do deslocamento de coluna especificado no buffer como a matriz iniciada no deslocamento de buffer fornecido.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)

Obtém o valor da coluna especificada como um único caractere.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)

Lê um fluxo de caracteres do deslocamento de coluna especificado no buffer como uma matriz iniciada no deslocamento de buffer fornecido.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)

Retorna um IDataReader para o ordinal da coluna especificada.Returns an IDataReader for the specified column ordinal.

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

Obtém uma cadeia de caracteres que representa o tipo de dados da coluna especificada.Gets a string representing the data type of the specified column.

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

Obtém o valor da coluna especificada como um objeto DateTime.Gets the value of the specified column as a DateTime object.

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

Recupera o valor da coluna especificada como um objeto DateTimeOffset.Retrieves the value of the specified column as a DateTimeOffset object.

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

Obtém o valor da coluna especificada como um objeto Decimal.Gets the value of the specified column as a Decimal object.

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

Obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla.Gets the value of the specified column as a double-precision floating point number.

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

Retorna um IEnumerator que itera pelo SqlDataReader.Returns an IEnumerator that iterates through the SqlDataReader.

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

Obtém o Type que é o tipo de dados do objeto.Gets the Type that is the data type of the object.

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

Obtém de forma síncrona o valor da coluna especificada como um tipo.Synchronously gets the value of the specified column as a type. GetFieldValueAsync<T>(Int32, CancellationToken) é a versão assíncrona deste método.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)

Obtém de forma assíncrona o valor da coluna especificada como um tipo.Asynchronously gets the value of the specified column as a type. GetFieldValue<T>(Int32) é a versão síncrona deste método.GetFieldValue<T>(Int32) is the synchronous version of this method.

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

Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples.Gets the value of the specified column as a single-precision floating point number.

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

Obtém o valor da coluna especificada como um GUID (identificador global exclusivo).Gets the value of the specified column as a globally unique identifier (GUID).

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

Serve como a função de hash padrão.Serves as the default hash function.

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

Obtém o valor da coluna especificada como um inteiro com sinal de 16 bits.Gets the value of the specified column as a 16-bit signed integer.

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

Obtém o valor da coluna especificada como um inteiro com sinal de 32 bits.Gets the value of the specified column as a 32-bit signed integer.

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

Obtém o valor da coluna especificada como um inteiro com sinal de 64 bits.Gets the value of the specified column as a 64-bit signed integer.

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

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.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)

Obtém o nome da coluna especificada.Gets the name of the specified column.

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

Obtém a ordinal da coluna, de acordo com o nome da coluna.Gets the column ordinal, given the name of the column.

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

Obtém um Object que é uma representação do tipo de campo específico do provedor subjacente.Gets an Object that is a representation of the underlying provider-specific field type.

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

Obtém um Object que é uma representação do valor específico do provedor subjacente.Gets an Object that is a representation of the underlying provider specific value.

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

Obtém uma matriz de objetos que são uma representação dos valores específicos do provedor subjacente.Gets an array of objects that are a representation of the underlying provider specific values.

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

Retorna um DataTable que descreve os metadados da coluna do SqlDataReader.Returns a DataTable that describes the column metadata of the SqlDataReader.

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

Obtém o valor da coluna especificada como um SqlBinary.Gets the value of the specified column as a SqlBinary.

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

Obtém o valor da coluna especificada como um SqlBoolean.Gets the value of the specified column as a SqlBoolean.

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

Obtém o valor da coluna especificada como um SqlByte.Gets the value of the specified column as a SqlByte.

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

Obtém o valor da coluna especificada como SqlBytes.Gets the value of the specified column as SqlBytes.

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

Obtém o valor da coluna especificada como SqlChars.Gets the value of the specified column as SqlChars.

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

Obtém o valor da coluna especificada como um SqlDateTime.Gets the value of the specified column as a SqlDateTime.

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

Obtém o valor da coluna especificada como um SqlDecimal.Gets the value of the specified column as a SqlDecimal.

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

Obtém o valor da coluna especificada como um SqlDouble.Gets the value of the specified column as a SqlDouble.

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

Obtém o valor da coluna especificada como um SqlGuid.Gets the value of the specified column as a SqlGuid.

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

Obtém o valor da coluna especificada como um SqlInt16.Gets the value of the specified column as a SqlInt16.

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

Obtém o valor da coluna especificada como um SqlInt32.Gets the value of the specified column as a SqlInt32.

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

Obtém o valor da coluna especificada como um SqlInt64.Gets the value of the specified column as a SqlInt64.

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

Obtém o valor da coluna especificada como um SqlMoney.Gets the value of the specified column as a SqlMoney.

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

Obtém o valor da coluna especificada como um SqlSingle.Gets the value of the specified column as a SqlSingle.

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

Obtém o valor da coluna especificada como um SqlString.Gets the value of the specified column as a SqlString.

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

Retorna o valor dos dados na coluna especificada como um tipo SQL Server.Returns the data value in the specified column as a SQL Server type.

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

Preenche uma matriz de Object que contém os valores de todas as colunas no registro, expressos como tipos do 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)

Obtém o valor da coluna especificada como um valor XML.Gets the value of the specified column as an XML value.

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

Recupera binário, imagem, varbinary, UDT e tipos de dados Variant como um Stream.Retrieves binary, image, varbinary, UDT, and variant data types as a Stream.

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

Obtém o valor da coluna especificada como uma cadeia de caracteres.Gets the value of the specified column as a string.

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

Recupera os tipos de dados Char, NChar, NText, NVarChar, texto, varChar e Variant como um TextReader.Retrieves Char, NChar, NText, NVarChar, text, varChar, and Variant data types as a TextReader.

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

Recupera o valor da coluna especificada como um objeto TimeSpan.Retrieves the value of the specified column as a TimeSpan object.

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

Obtém o Type da instância atual.Gets the Type of the current instance.

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

Obtém o valor da coluna especificada em seu formato nativo.Gets the value of the specified column in its native format.

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

Popula uma matriz de objetos com os valores da coluna da linha atual.Populates an array of objects with the column values of the current row.

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

Recupera dados do tipo XML como um XmlReader.Retrieves data of type XML as an XmlReader.

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

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.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 o CommandBehavior especificado corresponde ao do SqlDataReader.Determines whether the specified CommandBehavior matches that of the SqlDataReader .

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

Obtém um valor que indica se a coluna contém valores ausentes ou inexistente.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)

Uma versão assíncrona de IsDBNull(Int32), que obtém um valor que indica se a coluna contém valores ausentes ou inexistente.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

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

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

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

Leva o leitor de dados ao resultado seguinte ao ler os resultados de instruções Transact-SQL em lote.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)

Uma versão assíncrona de NextResult(), que avança o leitor de dados para o resultado seguinte ao ler os resultados de um lote de instruções 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.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Avança o SqlDataReader para o próximo registro.Advances the SqlDataReader to the next record.

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

Uma versão assíncrona de Read(), que avança o SqlDataReader para o próximo registro.An asynchronous version of Read(), which advances the SqlDataReader to the next record.

O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite do comando.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. As exceções serão relatadas por meio do objeto de tarefa.Exceptions will be reported via the returned Task object.

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

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Implantações explícitas de interface

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

Retorna um IDataReader para o ordinal da coluna especificada.Returns an IDataReader for the specified column ordinal.

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

Libera todos os recursos usados pelo leitor de dados.Releases all resources that are used by the data reader.

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

Retorna um enumerador que pode ser usado para iterar na coleção de item.Returns an enumerator that can be used to iterate through the item collection.

Aplica-se a

Veja também