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í dopředného datového proudu řádků ze zdroje dat. Tato třída se nemůže dědit.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Dědičnost
- Dědičnost
- Dědičnost
- Implementuje
Příklady
Následující příklad vytvoří OdbcConnection, a OdbcCommandOdbcDataReader. Příklad čte data a zapisuje je do konzoly. Nakonec příklad zavře OdbcDataReadera potom 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 namísto přímého použití konstruktoru.
OdbcDataReader Během použití je přidružená OdbcConnection služba zaneprázdněna obsluhou OdbcDataReadera žádné jiné operace nelze provádět s OdbcConnection jiným než jeho zavřením. To je tento případ, dokud Close není volána metoda OdbcDataReader . Například nemůžete 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 OdbcDataReader. Přesné chování je však závislé na ovladači i načasování.
IsClosed a RecordsAffected jsou jediné vlastnosti, které můžete volat po zavření objektu OdbcDataReader . Někdy je potřeba zavolat Close , než budete moct zavolat 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á označuje, zda OdbcDataReader obsahuje jeden nebo více řádků. |
IsClosed |
Určuje, zda OdbcDataReader je uzavřena. |
Item[Int32] |
Získá hodnotu zadaného sloupce v jeho nativním formátu vzhledem k pořadové číslo sloupci. |
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ých, vložených nebo odstraněných spuštěním příkazu SQL. |
VisibleFieldCount |
Získá počet polí v objektu DbDataReader , která nejsou skryta. (Zděděno od DbDataReader) |
Metody
Close() |
Zavře objekt OdbcDataReader . |
CloseAsync() |
Asynchronně zavře DbDataReader objekt. (Zděděno od DbDataReader) |
CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící 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é nástrojem DbDataReader 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) |
Finalize() |
Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění předtím, než je uvolněna uvolňováním paměti. |
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) |
Načte stream 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ě |
GetData(Int32) |
Vrátí hodnotu IDataReader pro zadanou řadovou číslo sloupce. |
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řadové číslo požadovaného sloupce, který 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é podepsané celé číslo. |
GetInt32(Int32) |
Získá hodnotu zadaného sloupce jako 32bitové podepsané celé číslo. |
GetInt64(Int32) |
Získá hodnotu zadaného sloupce jako 64bitové podepsané celé číslo. |
GetLifetimeService() |
Zastaralé.
Načte aktuální životnost objektu služby, 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á pořadové číslo sloupce 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 instanci typu specifického pro zprostředkovatele. (Zděděno od DbDataReader) |
GetProviderSpecificValues(Object[]) |
Získá všechny sloupce atributů specifické pro poskytovatele 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ě |
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() |
Type Získá z aktuální instance. (Zděděno od Object) |
GetValue(Int32) |
Získá hodnotu sloupce v zadaném pořadovém čísla v jeho nativním formátu. |
GetValues(Object[]) |
Naplní pole objektů hodnotami sloupců aktuálního řádku. |
InitializeLifetimeService() |
Zastaralé.
Získá životnost objektu služby, který řídí zásady ž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) |
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) |
MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
NextResult() |
Přejde na OdbcDataReader další výsledek při čtení výsledků dávkových příkazů SQL. |
NextResultAsync() |
Při čtení výsledků dávky příkazů asynchronně posune čtenáře na další výsledek. (Zděděno od DbDataReader) |
NextResultAsync(CancellationToken) |
Při čtení výsledků dávky příkazů asynchronně posune čtenáře na další výsledek. (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ů dotazu. (Zděděno od DbDataReader) |
ReadAsync(CancellationToken) |
Asynchronně posune čtenáře na další záznam v sadě výsledků dotazu. (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í OdbcDataReader třídy . |
IEnumerable.GetEnumerator() |
Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Vrací enumerátor procházející kolekci. |
Metody rozšíření
CanGetColumnSchema(DbDataReader) |
Získá hodnotu, která označuje, zda DbDataReader lze získat schéma sloupce. |
GetColumnSchema(DbDataReader) |
Získá schéma sloupce (DbColumn kolekci DbDataReader) pro . |
Cast<TResult>(IEnumerable) |
Přetypuje prvky objektu na IEnumerable zadaný typ. |
OfType<TResult>(IEnumerable) |
Filtruje prvky objektu IEnumerable na základě zadaného typu. |
AsParallel(IEnumerable) |
Umožňuje paralelizaci dotazu. |
AsQueryable(IEnumerable) |
Převede objekt na IEnumerableIQueryable. |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro