OdbcDataReader Klass

Definition

Namnområde:
System.Data.Odbc
Sammansättning:
System.Data.dll

Ger ett sätt att läsa en dataström med endast framåtriktade rader från en datakälla. Det går inte att ärva den här klassen.

public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
type OdbcDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IEnumerable
type OdbcDataReader = class
    inherit DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Arv
Object
MarshalByRefObject
OdbcDataReader
Arv
Object
MarshalByRefObject
DbDataReader
OdbcDataReader
Implementeringar
IEnumerable IDataReader IDataRecord IDisposable

Exempel

I följande exempel skapas en OdbcConnection, en OdbcCommandoch en OdbcDataReader. Exemplet läser igenom data och skriver ut dem till konsolen. Slutligen stänger OdbcDataReaderexemplet , och sedan OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

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

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

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

Kommentarer

Om du vill skapa en OdbcDataReadermåste du anropa ExecuteReader -metoden OdbcCommand för objektet i stället för att direkt använda en konstruktor.

OdbcDataReader Medan används är den associerade OdbcConnection upptagen med att hantera OdbcDataReader, och inga andra åtgärder kan utföras på den andra än att stänga denOdbcConnection. Detta är fallet tills Close metoden för OdbcDataReader anropas. Du kan till exempel inte hämta utdataparametrar förrän du har anropat Close.

Ändringar som görs i en resultatuppsättning av en annan process eller tråd medan data läss kan vara synliga för användaren av OdbcDataReader. Det exakta beteendet är dock både drivrutins- och tidsberoende.

IsClosed och RecordsAffected är de enda egenskaper som du kan anropa när har OdbcDataReader stängts. Ibland måste du ringa Close innan du kan ringa RecordsAffected.

Egenskaper

Name Description
Depth

Hämtar ett värde som anger djupet i kapslingen för den aktuella raden.
FieldCount

Hämtar antalet kolumner i den aktuella raden.
HasRows

Hämtar ett värde som anger om innehåller OdbcDataReader en eller flera rader.
IsClosed

Anger om är OdbcDataReader stängd.
Item[Int32]

Hämtar värdet för den angivna kolumnen i sitt interna format med tanke på kolumnens ordningstal.
Item[String]

Hämtar värdet för den angivna kolumnen i sitt ursprungliga format givet kolumnnamnet.
RecordsAffected

Hämtar antalet rader som har ändrats, infogats eller tagits bort genom körning av SQL-instruktionen.
VisibleFieldCount

Hämtar antalet fält i DbDataReader som inte är dolda.

(Ärvd från DbDataReader)

Metoder

Name Description
Close()

Stänger objektet OdbcDataReader .
CreateObjRef(Type)

Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt.

(Ärvd från MarshalByRefObject)
Dispose()

Släpper alla resurser som används av den aktuella instansen DbDataReader av klassen.

(Ärvd från DbDataReader)
Dispose(Boolean)

Släpper de ohanterade resurser som används av DbDataReader och släpper eventuellt de hanterade resurserna.

(Ärvd från DbDataReader)
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Finalize()

Tillåter att objektet försöker frigöra resurser och utföra andra rensningsåtgärder innan det frigörs av skräpinsamling.
GetBoolean(Int32)

Hämtar värdet för den angivna kolumnen som booleskt värde.
GetByte(Int32)

Hämtar värdet för den angivna kolumnen som byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)

Läser en ström med byte från den angivna kolumnförskjutningen till bufferten som en matris, med början vid den specifika buffertförskjutningen.
GetChar(Int32)

Hämtar värdet för den angivna kolumnen som ett tecken.
GetChars(Int32, Int64, Char[], Int32, Int32)

Läser en dataström med tecken från den angivna kolumnförskjutningen till bufferten som en matris, med början vid den specifika buffertförskjutningen.
GetData(Int32)

Returnerar en IDataReader för den angivna kolumnordningen.
GetData(Int32)

Returnerar en kapslad dataläsare för den begärda kolumnen.

(Ärvd från DbDataReader)
GetDataTypeName(Int32)

Hämtar namnet på källdatatypen.
GetDate(Int32)

Hämtar värdet för den angivna kolumnen som ett DateTime objekt.
GetDateTime(Int32)

Hämtar värdet för den angivna kolumnen som ett DateTime objekt.
GetDbDataReader(Int32)

Returnerar ett DbDataReader objekt för den begärda kolumnordningen som kan åsidosättas med en providerspecifik implementering.

(Ärvd från DbDataReader)
GetDecimal(Int32)

Hämtar värdet för den angivna kolumnen som ett Decimal objekt.
GetDouble(Int32)

Hämtar värdet för den angivna kolumnen som ett flyttal med dubbel precision.
GetEnumerator()

Returnerar en IEnumerator som kan användas för att iterera genom raderna i dataläsaren.
GetFieldType(Int32)

Type Hämtar objektets datatyp.
GetFieldValue<T>(Int32)

Hämtar värdet för den angivna kolumnen som den begärda typen.

(Ärvd från DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Asynkront hämtar värdet för den angivna kolumnen som den begärda typen.

(Ärvd från DbDataReader)
GetFieldValueAsync<T>(Int32)

Asynkront hämtar värdet för den angivna kolumnen som den begärda typen.

(Ärvd från DbDataReader)
GetFloat(Int32)

Hämtar värdet för den angivna kolumnen som ett flyttal med enkel precision.
GetGuid(Int32)

Hämtar värdet för den angivna kolumnen som en globalt unik identifierare (GUID).
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetInt16(Int32)

Hämtar värdet för den angivna kolumnen som ett 16-bitars signerat heltal.
GetInt32(Int32)

Hämtar värdet för den angivna kolumnen som ett 32-bitars signerat heltal.
GetInt64(Int32)

Hämtar värdet för den angivna kolumnen som ett 64-bitars signerat heltal.
GetLifetimeService()

Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
GetName(Int32)

Hämtar namnet på den angivna kolumnen.
GetOrdinal(String)

Hämtar kolumnordningen med namnet på kolumnen.
GetProviderSpecificFieldType(Int32)

Hämtar den providerspecifika typen av den angivna kolumnen.

(Ärvd från DbDataReader)
GetProviderSpecificValue(Int32)

Hämtar värdet för den angivna kolumnen som en instans av en providerspecifik typ.

(Ärvd från DbDataReader)
GetProviderSpecificValues(Object[])

Hämtar alla providerspecifika attributkolumner i samlingen för den aktuella raden.

(Ärvd från DbDataReader)
GetSchemaTable()

Returnerar en DataTable som beskriver kolumnmetadata för OdbcDataReader.
GetStream(Int32)

Hämtar en dataström för att hämta data från den angivna kolumnen.

(Ärvd från DbDataReader)
GetString(Int32)

Hämtar värdet för den angivna kolumnen som en String.
GetTextReader(Int32)

Hämtar en textläsare för att hämta data från kolumnen.

(Ärvd från DbDataReader)
GetTime(Int32)

Hämtar värdet för den angivna kolumnen som ett TimeSpan objekt.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValue(Int32)

Hämtar värdet för kolumnen i det angivna ordningstalet i sitt interna format.
GetValues(Object[])

Fyller i en matris med objekt med kolumnvärdena för den aktuella raden.
InitializeLifetimeService()

Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen.

(Ärvd från MarshalByRefObject)
IsDBNull(Int32)

Hämtar ett värde som anger om kolumnen innehåller icke-existerande eller saknade värden.
IsDBNullAsync(Int32, CancellationToken)

Asynkront hämtar ett värde som anger om kolumnen innehåller obefintliga eller saknade värden.

(Ärvd från DbDataReader)
IsDBNullAsync(Int32)

Asynkront hämtar ett värde som anger om kolumnen innehåller obefintliga eller saknade värden.

(Ärvd från DbDataReader)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
MemberwiseClone(Boolean)

Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet.

(Ärvd från MarshalByRefObject)
NextResult()

OdbcDataReader Går vidare till nästa resultat när du läser resultatet av BATCH SQL-instruktioner.
NextResultAsync()

Asynkront avancerar läsaren till nästa resultat när du läser resultatet av en batch med instruktioner.

(Ärvd från DbDataReader)
NextResultAsync(CancellationToken)

Asynkront avancerar läsaren till nästa resultat när du läser resultatet av en batch med instruktioner.

(Ärvd från DbDataReader)
Read()

OdbcDataReader Går vidare till nästa post.
ReadAsync()

Asynkront avancerar läsaren till nästa post i en resultatuppsättning.

(Ärvd från DbDataReader)
ReadAsync(CancellationToken)

Asynkront avancerar läsaren till nästa post i en resultatuppsättning.

(Ärvd från DbDataReader)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Explicita gränssnittsimplementeringar

Name Description
IDataRecord.GetData(Int32)

En beskrivning av den här medlemmen finns i GetData(Int32).

(Ärvd från DbDataReader)
IDisposable.Dispose()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Släpper alla resurser som används av den aktuella instansen OdbcDataReader av klassen.
IEnumerable.GetEnumerator()

Detta API stöder produktinfrastrukturen och är inte avsett att användas direkt från koden.

Returnerar en uppräknare som itererar genom en samling.

Tilläggsmetoder

Name Description
AsParallel(IEnumerable)

Möjliggör parallellisering av en fråga.
AsQueryable(IEnumerable)

Konverterar en IEnumerable till en IQueryable.
CanGetColumnSchema(DbDataReader)

Hämtar ett värde som anger om en DbDataReader kan hämta ett kolumnschema.
Cast<TResult>(IEnumerable)

Omvandlar elementen i en IEnumerable till den angivna typen.
GetColumnSchema(DbDataReader)

Hämtar kolumnschemat (DbColumn samlingen) för en DbDataReader.
OfType<TResult>(IEnumerable)

Filtrerar elementen i en IEnumerable baserat på en angiven typ.

Gäller för

Se även