OleDbDataReader Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v9.0.0-preview.7.24405.7

Źródło:

OleDbDataReader.cs

Zapewnia sposób odczytywania strumienia danych tylko do przodu wierszy ze źródła danych. Tej klasy nie można dziedziczyć.

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

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

type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Dziedziczenie

Object

MarshalByRefObject

DbDataReader

OleDbDataReader

Przykłady

Poniższy przykład tworzy OleDbConnection, OleDbCommandi OleDbDataReader. Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka OleDbDataReader, a następnie 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

Uwagi

Aby utworzyć OleDbDataReader, należy wywołać metodę ExecuteReader obiektu OleDbCommand zamiast bezpośrednio przy użyciu konstruktora.

Przed zamknięciem OleDbConnectionnajpierw zamknij obiekt OleDbDataReader. Należy również zamknąć obiekt OleDbDataReader, jeśli planujesz ponowne użycie obiektu OleDbCommand. Na przykład nie można pobrać parametrów wyjściowych do momentu wywołania polecenia Close.

Zmiany wprowadzone w zestawie wyników przez inny proces lub wątek podczas odczytywania danych mogą być widoczne dla użytkownika OleDbDataReader. Jednak dokładne zachowanie zależy od czasu.

IsClosed i RecordsAffected są jedynymi właściwościami, które można wywołać po zamknięciu OleDbDataReader. Mimo że dostęp do właściwości RecordsAffected można uzyskać, gdy OleDbDataReader istnieje, zawsze należy wywołać Close przed zwróceniem wartości RecordsAffected, aby zagwarantować dokładną wartość zwracaną.

Właściwości

Depth	Pobiera wartość wskazującą głębokość zagnieżdżania bieżącego wiersza.
FieldCount	Pobiera liczbę kolumn w bieżącym wierszu.
HasRows	Pobiera wartość wskazującą, czy OleDbDataReader zawiera jeden lub więcej wierszy.
IsClosed	Wskazuje, czy czytnik danych jest zamknięty.
Item[Int32]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę porządkowość kolumny.
Item[String]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę nazwę kolumny.
RecordsAffected	Pobiera liczbę wierszy zmienionych, wstawionych lub usuniętych przez wykonanie instrukcji SQL.
VisibleFieldCount	Pobiera liczbę pól w OleDbDataReader, które nie są ukryte.

Metody

Close()	Zamyka obiekt OleDbDataReader.
CloseAsync()	Asynchronicznie zamyka obiekt DbDataReader. (Odziedziczone po DbDataReader)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DbDataReader i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DbDataReader)
DisposeAsync()	Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetBoolean(Int32)	Pobiera wartość określonej kolumny jako wartość logiczną.
GetByte(Int32)	Pobiera wartość określonej kolumny jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Odczytuje strumień bajtów z określonej kolumny przesunięte do buforu jako tablicę rozpoczynającą się od danego przesunięcia buforu.
GetChar(Int32)	Pobiera wartość określonej kolumny jako znak.
GetChars(Int32, Int64, Char[], Int32, Int32)	Odczytuje strumień znaków z określonej kolumny przesunięcia do buforu jako tablicy rozpoczynającej się od danego przesunięcia buforu.
GetColumnSchemaAsync(CancellationToken)	Jest to asynchroniczna wersja GetColumnSchema(DbDataReader). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetColumnSchema(DbDataReader) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetColumnSchema(DbDataReader) będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbDataReader)
GetData(Int32)	Zwraca obiekt OleDbDataReader dla żądanej porządkowej kolumny.
GetDataTypeName(Int32)	Pobiera nazwę typu danych źródłowych.
GetDateTime(Int32)	Pobiera wartość określonej kolumny jako obiekt DateTime.
GetDbDataReader(Int32)	Zwraca obiekt DbDataReader dla żądanej porządkowej kolumny, którą można zastąpić implementacją specyficzną dla dostawcy. (Odziedziczone po DbDataReader)
GetDecimal(Int32)	Pobiera wartość określonej kolumny jako obiekt Decimal.
GetDouble(Int32)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.
GetEnumerator()	Zwraca IEnumerator, których można użyć do iterowania wierszy w czytniku danych.
GetFieldType(Int32)	Pobiera Type, który jest typem danych obiektu.
GetFieldValue<T>(Int32)	Pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFloat(Int32)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.
GetGuid(Int32)	Pobiera wartość określonej kolumny jako globalnie unikatowy identyfikator (GUID).
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInt16(Int32)	Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.
GetInt32(Int32)	Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.
GetInt64(Int32)	Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetName(Int32)	Pobiera nazwę określonej kolumny.
GetOrdinal(String)	Pobiera porządkową kolumnę, biorąc pod uwagę nazwę kolumny.
GetProviderSpecificFieldType(Int32)	Pobiera typ specyficzny dla dostawcy określonej kolumny. (Odziedziczone po DbDataReader)
GetProviderSpecificValue(Int32)	Pobiera wartość określonej kolumny jako wystąpienie typu specyficznego dla dostawcy. (Odziedziczone po DbDataReader)
GetProviderSpecificValues(Object[])	Pobiera wszystkie kolumny atrybutów specyficzne dla dostawcy w kolekcji dla bieżącego wiersza. (Odziedziczone po DbDataReader)
GetSchemaTable()	Zwraca DataTable opisujący metadane kolumny OleDbDataReader.
GetSchemaTableAsync(CancellationToken)	Jest to asynchroniczna wersja GetSchemaTable(). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetSchemaTable() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchemaTable() będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbDataReader)
GetStream(Int32)	Pobiera strumień do pobierania danych z określonej kolumny. (Odziedziczone po DbDataReader)
GetString(Int32)	Pobiera wartość określonej kolumny jako ciąg.
GetTextReader(Int32)	Pobiera czytnik tekstu w celu pobrania danych z kolumny. (Odziedziczone po DbDataReader)
GetTimeSpan(Int32)	Pobiera wartość określonej kolumny jako obiekt TimeSpan.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(Int32)	Pobiera wartość kolumny w określonym kodzie w formacie natywnym.
GetValues(Object[])	Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza.
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
IsDBNull(Int32)	Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
IsDBNullAsync(Int32)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject. (Odziedziczone po MarshalByRefObject)
NextResult()	Rozwija czytnik danych do następnego wyniku podczas odczytywania wyników instrukcji sql wsadowych.
NextResultAsync()	Asynchronicznie zwiększa czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)	Asynchronicznie zwiększa czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
Read()	Przechodzi OleDbDataReader do następnego rekordu.
ReadAsync()	Asynchronicznie zwiększa czytelnika do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytelnika do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IDataRecord.GetData(Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz GetData(Int32). (Odziedziczone po DbDataReader)

Metody rozszerzania

CanGetColumnSchema(DbDataReader)	Pobiera wartość wskazującą, czy DbDataReader może uzyskać schemat kolumny.
GetColumnSchema(DbDataReader)	Pobiera schemat kolumny (kolekcjaDbColumn) dla DbDataReader.
GetBoolean(DbDataReader, String)	Pobiera wartość określonej kolumny jako wartość logiczną.
GetByte(DbDataReader, String)	Pobiera wartość określonej kolumny jako bajt.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Odczytuje określoną liczbę bajtów z określonej kolumny rozpoczynającej się od określonego indeksu i zapisuje je w buforze rozpoczynającym się od określonej pozycji w buforze.
GetChar(DbDataReader, String)	Pobiera wartość określonej kolumny jako pojedynczy znak.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Odczytuje określoną liczbę znaków z określonej kolumny rozpoczynającej się od określonego indeksu i zapisuje je w buforze rozpoczynającym się od określonej pozycji.
GetData(DbDataReader, String)	Zwraca zagnieżdżony czytnik danych dla żądanej kolumny.
GetDataTypeName(DbDataReader, String)	Pobiera nazwę typu danych określonej kolumny.
GetDateTime(DbDataReader, String)	Pobiera wartość określonej kolumny jako obiekt DateTime.
GetDecimal(DbDataReader, String)	Pobiera wartość określonej kolumny jako Decimal.
GetDouble(DbDataReader, String)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.
GetFieldType(DbDataReader, String)	Pobiera typ danych określonej kolumny.
GetFieldValue<T>(DbDataReader, String)	Pobiera wartość określonej kolumny jako żądany typ.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ.
GetFloat(DbDataReader, String)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.
GetGuid(DbDataReader, String)	Pobiera wartość określonej kolumny jako globalnie unikatowy identyfikator (GUID).
GetInt16(DbDataReader, String)	Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.
GetInt32(DbDataReader, String)	Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.
GetInt64(DbDataReader, String)	Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.
GetProviderSpecificFieldType(DbDataReader, String)	Pobiera typ specyficzny dla dostawcy określonej kolumny.
GetProviderSpecificValue(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie typu specyficznego dla dostawcy.
GetStream(DbDataReader, String)	Pobiera strumień do pobierania danych z określonej kolumny.
GetString(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie String.
GetTextReader(DbDataReader, String)	Pobiera czytnik tekstu w celu pobrania danych z kolumny.
GetValue(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie Object.
IsDBNull(DbDataReader, String)	Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
Cast<TResult>(IEnumerable)	Rzutuje elementy IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje IEnumerable na IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.

Zobacz też

• DataAdapters i DataReaders