OdbcDataReader Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v8.0.0

Zdroj:

OdbcDataReader.cs

Poskytuje způsob čtení datového proudu řádků dat ze zdroje dat, který je jen dopředný. Tuto třídu nelze dědit.

public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader

public sealed class OdbcDataReader : System.Data.Common.DbDataReader

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Dědičnost

Object

DbDataReader

OdbcDataReader

Příklady

Následující příklad vytvoří OdbcConnection, a OdbcCommandOdbcDataReader. Příklad přečte data a zapíše je do konzoly. Nakonec příklad zavře OdbcDataReadera pak 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

Poznámky

Chcete-li vytvořit OdbcDataReader, je nutné volat ExecuteReader metodu objektu OdbcCommand , nikoli přímo pomocí konstruktoru.

OdbcDataReader Během použití je přidružená OdbcConnection služba zaneprázdněna obsluhou OdbcDataReadera nelze provádět OdbcConnection žádné jiné operace kromě jeho zavření. To je případ, dokud Close není volána metoda OdbcDataReader metody . Například nelze načíst výstupní parametry, dokud nevoláte Close.

Změny provedené v sadě výsledků jiným procesem nebo vláknem během čtení dat můžou být viditelné uživateli objektu OdbcDataReader. Přesné chování je však závislé na ovladači a načasování.

IsClosed a RecordsAffected jsou jediné vlastnosti, které můžete volat po OdbcDataReader zavření. Někdy musíte zavolat Close , abyste mohli zavolat RecordsAffected.

Vlastnosti

Depth	Získá hodnotu, která označuje hloubku vnoření aktuálního řádku.
FieldCount	Získá počet sloupců v aktuálním řádku.
HasRows	Získá hodnotu, která označuje, zda OdbcDataReader obsahuje jeden nebo více řádků.
IsClosed	Určuje, jestli OdbcDataReader je uzavřená.
Item[Int32]	Získá hodnotu zadaného sloupce v jeho nativním formátu zadanou pořadovou řadu sloupců.
Item[String]	Získá hodnotu zadaného sloupce v jeho nativním formátu vzhledem k názvu sloupce.
RecordsAffected	Získá počet řádků změněn, vložen nebo odstraněn spuštěním příkazu SQL.
VisibleFieldCount	Získá počet polí v polích DbDataReader , které nejsou skryté. (Zděděno od DbDataReader)

Metody

Close()	OdbcDataReader Zavře objekt.
CloseAsync()	Asynchronně zavře DbDataReader objekt. (Zděděno od DbDataReader)
Dispose()	Uvolní všechny prostředky používané aktuální instancí DbDataReader třídy. (Zděděno od DbDataReader)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbDataReader nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DbDataReader)
DisposeAsync()	Asynchronně uvolní všechny prostředky používané aktuální instancí DbDataReader třídy. (Zděděno od DbDataReader)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetBoolean(Int32)	Získá hodnotu zadaného sloupce jako logická hodnota.
GetByte(Int32)	Získá hodnotu zadaného sloupce jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Načte stream bajtů ze zadaného posunu sloupce do vyrovnávací paměti jako pole, počínaje konkrétním posunem vyrovnávací paměti.
GetChar(Int32)	Získá hodnotu zadaného sloupce jako znak.
GetChars(Int32, Int64, Char[], Int32, Int32)	Přečte datový proud znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole, počínaje konkrétním posunem vyrovnávací paměti.
GetColumnSchemaAsync(CancellationToken)	Toto je asynchronní verze nástroje GetColumnSchema(DbDataReader). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být ctěna. Výchozí implementace vyvolá synchronní GetColumnSchema(DbDataReader) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla předána cancellationToken. Výjimky vyvolané nástrojem GetColumnSchema(DbDataReader) budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. (Zděděno od DbDataReader)
GetData(Int32)	Vrátí čtečku vnořených dat pro požadovaný sloupec. (Zděděno od DbDataReader)
GetDataTypeName(Int32)	Získá název zdrojového datového typu.
GetDate(Int32)	Získá hodnotu zadaného sloupce jako DateTime objekt.
GetDateTime(Int32)	Získá hodnotu zadaného sloupce jako DateTime objekt.
GetDbDataReader(Int32)	DbDataReader Vrátí objekt pro požadovanou řadovou řadu sloupců, kterou lze přepsat implementací specifickou pro zprostředkovatele. (Zděděno od DbDataReader)
GetDecimal(Int32)	Získá hodnotu zadaného sloupce jako Decimal objekt.
GetDouble(Int32)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinou čárkou s dvojitou přesností.
GetEnumerator()	Vrátí hodnotu IEnumerator , která se dá použít k iteraci řádky ve čtečce dat.
GetFieldType(Int32)	Type Získá objekt, který je datový typ objektu.
GetFieldValue<T>(Int32)	Získá hodnotu zadaného sloupce jako požadovaný typ. (Zděděno od DbDataReader)
GetFieldValueAsync<T>(Int32)	Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ. (Zděděno od DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ. (Zděděno od DbDataReader)
GetFloat(Int32)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinou čárkou s jednou přesností.
GetGuid(Int32)	Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID).
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetInt16(Int32)	Získá hodnotu zadaného sloupce jako 16bitové celé číslo se signoum sadou.
GetInt32(Int32)	Získá hodnotu zadaného sloupce jako celé číslo se 32bitovým signýmým.
GetInt64(Int32)	Získá hodnotu zadaného sloupce jako celé číslo se 64 bitem.
GetName(Int32)	Získá název zadaného sloupce.
GetOrdinal(String)	Získá řadový sloupec vzhledem k názvu sloupce.
GetProviderSpecificFieldType(Int32)	Získá typ konkrétního zprostředkovatele zadaného sloupce. (Zděděno od DbDataReader)
GetProviderSpecificValue(Int32)	Získá hodnotu zadaného sloupce jako instance typu specifického pro zprostředkovatele. (Zděděno od DbDataReader)
GetProviderSpecificValues(Object[])	Získá všechny sloupce atributu specifické pro zprostředkovatele v kolekci pro aktuální řádek. (Zděděno od DbDataReader)
GetSchemaTable()	Vrátí hodnotu DataTable , která popisuje metadata sloupce objektu OdbcDataReader.
GetSchemaTableAsync(CancellationToken)	Toto je asynchronní verze nástroje GetSchemaTable(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být ctěna. Výchozí implementace vyvolá synchronní GetSchemaTable() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla předána cancellationToken. Výjimky vyvolané nástrojem GetSchemaTable() budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. (Zděděno od DbDataReader)
GetStream(Int32)	Získá datový proud pro načtení dat ze zadaného sloupce. (Zděděno od DbDataReader)
GetString(Int32)	Získá hodnotu zadaného sloupce jako String.
GetTextReader(Int32)	Získá čtečku textu pro načtení dat ze sloupce. (Zděděno od DbDataReader)
GetTime(Int32)	Získá hodnotu zadaného sloupce jako TimeSpan objekt.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu sloupce v zadaném ordinálu v jeho nativním formátu.
GetValues(Object[])	Naplní pole objektů hodnotami sloupců aktuálního řádku.
IsDBNull(Int32)	Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
IsDBNullAsync(Int32)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty. (Zděděno od DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty. (Zděděno od DbDataReader)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
NextResult()	Přejde na OdbcDataReader další výsledek při čtení výsledků dávkových příkazů SQL.
NextResultAsync()	Asynchronně posune čtenáře na další výsledek při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
NextResultAsync(CancellationToken)	Asynchronně posune čtenáře na další výsledek při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
Read()	Přejde na OdbcDataReader další záznam.
ReadAsync()	Asynchronně posune čtenáře na další záznam v sadě výsledků. (Zděděno od DbDataReader)
ReadAsync(CancellationToken)	Asynchronně posune čtenáře na další záznam v sadě výsledků. (Zděděno od DbDataReader)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Metody rozšíření

Viz také

• Adaptéry a čtečky dat