OdbcDataReader Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje způsob čtení datového proudu pouze dopředného proudu řádků dat ze zdroje dat. Tuto třídu nelze zdědit.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic sealed class OdbcDataReader : System.Data.Common.DbDataReaderpublic sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReadertype OdbcDataReader = class
inherit DbDataReadertype OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerablePublic NotInheritable Class OdbcDataReader
Inherits DbDataReaderPublic NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable- Dědičnost
- Dědičnost
- Implementuje
Příklady
Následující příklad vytvoří OdbcConnection, OdbcCommanda 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, je nutné volat ExecuteReader metodu OdbcCommand objektu namísto přímého použití konstruktoru.
Při použití OdbcDataReader je přidružená OdbcConnection zaneprázdněna obsluhou OdbcDataReadera na OdbcConnection není možné provádět žádné jiné operace než jeho zavření. To je případ, dokud Close metoda OdbcDataReader není volána. 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 volat Close, než budete moct volat RecordsAffected.
Vlastnosti
| 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 OdbcDataReader uzavřena. |
| 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čet polí v DbDataReader, které nejsou skryté. (Zděděno od DbDataReader) |
Metody
| Close() |
Zavře objekt OdbcDataReader. |
| CloseAsync() |
Asynchronně zavře objekt DbDataReader. (Zděděno od DbDataReader) |
| 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í třídy DbDataReader. (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) |
| DisposeAsync() |
Asynchronně uvolní všechny prostředky používané aktuální instancí třídy DbDataReader. (Zděděno od DbDataReader) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| Finalize() |
Umožňuje objektu, aby se pokusil uvolnit prostředky a provést další operace čištění před uvolněním paměti. |
| 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. |
| GetColumnSchemaAsync(CancellationToken) |
Toto je asynchronní verze GetColumnSchema(DbDataReader).
Poskytovatelé by měli přepsat příslušnou implementací.
Volitelně je možné respektovat |
| GetData(Int32) |
Vrátí IDataReader pro zadaný řadový sloupec. |
| 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) |
Vrátí objekt DbDataReader pro požadovaný řadový sloupec, který lze přepsat implementací specifickou 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() |
Vrátí IEnumerator, který lze použít k iteraci řádků v čtečce dat. |
| GetFieldType(Int32) |
Získá Type, 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, 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() |
Zastaralé.
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í DataTable, která popisuje metadata sloupců OdbcDataReader. |
| GetSchemaTableAsync(CancellationToken) |
Toto je asynchronní verze GetSchemaTable().
Poskytovatelé by měli přepsat příslušnou implementací.
Volitelně je možné respektovat |
| 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() |
Zastaralé.
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 objektu MarshalByRefObject. (Zděděno od MarshalByRefObject) |
| NextResult() |
Při čtení výsledků dávkových příkazů SQL přejde OdbcDataReader 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 OdbcDataReader na 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í
| IDataRecord.GetData(Int32) |
Popis tohoto člena najdete v tématu GetData(Int32). (Zděděno od DbDataReader) |
| IDisposable.Dispose() |
Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Uvolní všechny prostředky používané aktuální instancí třídy OdbcDataReader. |
| IEnumerable.GetEnumerator() |
Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Vrátí enumerátor, který iteruje kolekcí. |
Metody rozšíření
| CanGetColumnSchema(DbDataReader) |
Získá hodnotu, která označuje, zda DbDataReader může získat schéma sloupce. |
| GetColumnSchema(DbDataReader) |
Získá schéma sloupce (DbColumn kolekce) pro DbDataReader. |
| GetBoolean(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako logickou hodnotu. |
| GetByte(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako bajt. |
| GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) |
Načte zadaný počet bajtů ze zadaného sloupce počínaje zadaným indexem a zapíše je do vyrovnávací paměti počínaje zadanou pozicí v vyrovnávací paměti. |
| GetChar(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako jeden znak. |
| GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Přečte zadaný počet znaků ze zadaného sloupce počínaje zadaným indexem a zapíše je do vyrovnávací paměti počínaje zadanou pozicí. |
| GetData(DbDataReader, String) |
Vrátí vnořenou čtečku dat pro požadovaný sloupec. |
| GetDataTypeName(DbDataReader, String) |
Získá název datového typu zadaného sloupce. |
| GetDateTime(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako DateTime objektu. |
| GetDecimal(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako Decimal. |
| GetDouble(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s dvojitou přesností. |
| GetFieldType(DbDataReader, String) |
Získá datový typ zadaného sloupce. |
| GetFieldValue<T>(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako požadovaný typ. |
| GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ. |
| GetFloat(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s jednoduchou přesností. |
| GetGuid(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID). |
| GetInt16(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako 16bitové celé číslo se signed. |
| GetInt32(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako 32bitové signed integer. |
| GetInt64(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako 64bitové celé číslo se signedem. |
| GetProviderSpecificFieldType(DbDataReader, String) |
Získá typ konkrétního zprostředkovatele zadaného sloupce. |
| GetProviderSpecificValue(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako instanci typu specifického pro zprostředkovatele. |
| GetStream(DbDataReader, String) |
Získá datový proud pro načtení dat ze zadaného sloupce. |
| GetString(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako instanci String. |
| GetTextReader(DbDataReader, String) |
Získá čtečku textu pro načtení dat ze sloupce. |
| GetValue(DbDataReader, String) |
Získá hodnotu zadaného sloupce jako instanci Object. |
| IsDBNull(DbDataReader, String) |
Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty. |
| IsDBNullAsync(DbDataReader, String, CancellationToken) |
Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty. |
| Cast<TResult>(IEnumerable) |
Přetypuje prvky IEnumerable na zadaný typ. |
| OfType<TResult>(IEnumerable) |
Filtruje prvky IEnumerable na základě zadaného typu. |
| AsParallel(IEnumerable) |
Umožňuje paralelizaci dotazu. |
| AsQueryable(IEnumerable) |
Převede IEnumerable na IQueryable. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití. |
Platí pro
Viz také
-
datových sad a datových sad
