OdbcDataReader Třída

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.dll

Poskytuje způsob čtení datového proudu pouze dopředného proudu řádků dat ze zdroje dat. Tato třída se nemůže 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

MarshalByRefObject

DbDataReader

OdbcDataReader

Příklady

Následující příklad vytvoří OdbcConnection, , OdbcCommanda a OdbcDataReader. Příklad č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, musíte volat ExecuteReader metodu objektu OdbcCommand namísto přímo pomocí konstruktoru.

Zatímco se OdbcDataReader používá, přidružené OdbcConnection je zaneprázdněn obsluha OdbcDataReadera žádné jiné operace nelze provádět na OdbcConnection jiném než uzavření. Jedná se o případ, dokud Close se nevolá metoda OdbcDataReader . Například nelze načíst výstupní parametry, dokud nebudete volat Close.

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

IsClosed a RecordsAffected jsou jedinými vlastnostmi, které můžete volat po zavření OdbcDataReader . Někdy musíte zavolat Close , než budete moct volat RecordsAffected.

Vlastnosti

Name	Description
Depth	Získá hodnotu, která označuje hloubku vnoření pro aktuální řádek.
FieldCount	Získá počet sloupců v aktuálním řádku.
HasRows	Získá hodnotu, která určuje, zda OdbcDataReader obsahuje jeden nebo více řádků.
IsClosed	Určuje, zda je uzavřena OdbcDataReader .
Item[Int32]	Získá hodnotu zadaného sloupce v jeho nativním formátu vzhledem k pořadí 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četpolích DbDataReader (Zděděno od DbDataReader)

Metody

Name	Description
Close()	OdbcDataReader Zavře objekt.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
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 a volitelně uvolní spravované prostředky. (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 logickou hodnotu.
GetByte(Int32)	Získá hodnotu zadaného sloupce jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Načte datový proud 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)	Nač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.
GetData(Int32)	Vrátí vnořenou čtečku 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 objektu.
GetDateTime(Int32)	Získá hodnotu zadaného sloupce jako DateTime objektu.
GetDbDataReader(Int32)	DbDataReader Vrátí objekt pro požadovaný řadový sloupec, který lze přepsat pomocí implementace specifické pro zprostředkovatele. (Zděděno od DbDataReader)
GetDecimal(Int32)	Získá hodnotu zadaného sloupce jako Decimal objektu.
GetDouble(Int32)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s dvojitou přesností.
GetEnumerator()	IEnumerator Vrátí hodnotu, kterou lze použít k iteraci řádků v čtečce dat.
GetFieldType(Int32)	Type Získá to datový typ objektu.
GetFieldValue<T>(Int32)	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)
GetFieldValueAsync<T>(Int32)	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í desetinnou čárkou s jednoduchou přesností.
GetGuid(Int32)	Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID).
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetInt16(Int32)	Získá hodnotu zadaného sloupce jako 16bitové celé číslo se signed.
GetInt32(Int32)	Získá hodnotu zadaného sloupce jako 32bitové signed integer.
GetInt64(Int32)	Získá hodnotu zadaného sloupce jako 64bitové celé číslo se signedem.
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetName(Int32)	Získá název zadaného sloupce.
GetOrdinal(String)	Získá řadový sloupec s názvem 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 instanci typu specifického pro zprostředkovatele. (Zděděno od DbDataReader)
GetProviderSpecificValues(Object[])	Získá všechny sloupce atributů specifické pro zprostředkovatele v kolekci pro aktuální řádek. (Zděděno od DbDataReader)
GetSchemaTable()	Vrátí hodnotu DataTable , která popisuje metadata OdbcDataReadersloupce .
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 objektu.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu sloupce v zadaném pořadovém formátu v nativním formátu.
GetValues(Object[])	Naplní pole objektů hodnotami sloupců aktuálního řádku.
InitializeLifetimeService()	Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
IsDBNull(Int32)	Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
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)
IsDBNullAsync(Int32)	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 Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
NextResult()	Při OdbcDataReader čtení výsledků dávkových příkazů SQL přejde na další výsledek.
NextResultAsync()	Asynchronně přejde čtenáře na další výsledek při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
NextResultAsync(CancellationToken)	Asynchronně přejde č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ě přejde čtenáře na další záznam v sadě výsledků. (Zděděno od DbDataReader)
ReadAsync(CancellationToken)	Asynchronně přejde č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)

Explicitní implementace rozhraní

Name	Description
IDataRecord.GetData(Int32)	Popis tohoto člena naleznete v tématu GetData(Int32). (Zděděno od DbDataReader)

Metody rozšíření

Name	Description
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede IEnumerable na IQueryable.
CanGetColumnSchema(DbDataReader)	Získá hodnotu, která označuje, zda DbDataReader může získat schéma sloupce.
Cast<TResult>(IEnumerable)	Přetypuje prvky IEnumerable na zadaný typ.
GetColumnSchema(DbDataReader)	Získá schéma sloupce (DbColumnkolekce) pro .DbDataReader
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.

Viz také

• Datové adaptéry a čtečky dat