OleDbDataReader Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v11.0.0-preview.2.26159.112

Zdroj:

OleDbDataReader.cs

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 OleDbDataReader sealed : System::Data::Common::DbDataReader

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReader

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Dědičnost

Object

DbDataReader

OleDbDataReader

Atributy

RequiresDynamicCodeAttribute

Příklady

Následující příklad vytvoří OleDbConnection, , OleDbCommanda a OleDbDataReader. Příklad čte data a zapíše je do konzoly. Nakonec příklad zavře OleDbDataReader a pak .OleDbConnection

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Poznámky

Chcete-li vytvořit OleDbDataReader, musíte volat ExecuteReader metodu objektu OleDbCommand namísto přímo pomocí konstruktoru.

Před zavření objektu OleDbConnectionOleDbDataReader nejprve zavřete. Pokud chcete objekt znovu použítOleDbCommand, musíte objekt zavřítOleDbDataReader. 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 OleDbDataReader. Přesné chování je však závislé na načasování.

IsClosed a RecordsAffected jsou jedinými vlastnostmi, které můžete volat po zavření OleDbDataReader . Ačkoli vlastnost RecordsAffected může být přístupná, zatímco OleDbDataReader existuje, vždy volání Close před vrácením hodnoty RecordsAffected , která zaručuje přesnou návratovou hodnotu.

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 OleDbDataReader obsahuje jeden nebo více řádků.
IsClosed	Určuje, jestli je čtečka dat zavřená.
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 OleDbDataReader

Metody

Name	Description
Close()	OleDbDataReader Zavře objekt.
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 začínající na daném posunu 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 začínající na daném posunu vyrovnávací paměti.
GetData(Int32)	OleDbDataReader Vrátí objekt pro požadovaný řadový sloupec.
GetDataTypeName(Int32)	Získá název zdrojového datového typu.
GetDateTime(Int32)	Získá hodnotu zadaného sloupce jako DateTime objektu.
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.
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).
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.
GetName(Int32)	Získá název zadaného sloupce.
GetOrdinal(String)	Získá řadový sloupec s názvem sloupce.
GetSchemaTable()	Vrátí hodnotu DataTable , která popisuje metadata OleDbDataReadersloupce .
GetString(Int32)	Získá hodnotu zadaného sloupce jako řetězec.
GetTimeSpan(Int32)	Získá hodnotu zadaného sloupce jako TimeSpan objektu.
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.
IsDBNull(Int32)	Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
NextResult()	Při čtení výsledků dávkových příkazů SQL přejde čtečka dat na další výsledek.
Read()	Přejde na OleDbDataReader další záznam.

Viz také

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