OleDbDataReader Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v8.0.0

Źródło:

OleDbDataReader.cs

Zapewnia sposób odczytywania strumienia danych tylko do przodu wierszy ze źródła danych. Klasa ta nie może być dziedziczona.

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

DbDataReader

OleDbDataReader

Przykłady

Poniższy przykład tworzy elementy OleDbConnection, i OleDbCommandOleDbDataReader. Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka element 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ć obiekt OleDbDataReader, należy wywołać ExecuteReader metodę OleDbCommand obiektu zamiast bezpośrednio przy użyciu konstruktora.

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

Zmiany wprowadzone w zestawie wyników przez inny proces lub wątek podczas odczytywania danych mogą być widoczne dla użytkownika obiektu 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 OleDbDataReader zamknięciu. RecordsAffected Mimo że dostęp do właściwości może być uzyskiwany, gdy OleDbDataReader właściwość istnieje, zawsze należy wywołać Close metodę przed zwróceniem wartości w RecordsAffected celu zagwarantowania dokładnej wartości zwracanej.

Właściwości

Depth	Pobiera wartość wskazującą głębokość zagnieżdżania dla bieżącego wiersza.
FieldCount	Pobiera liczbę kolumn w bieżącym wierszu.
HasRows	Pobiera wartość wskazującą, czy OleDbDataReader element zawiera co najmniej jeden wiersz.
IsClosed	Wskazuje, czy czytnik danych jest zamknięty.
Item[Int32]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę liczbę porządkową 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 polach OleDbDataReader , które nie są ukryte.

Metody

Close()	OleDbDataReader Zamyka obiekt.
CloseAsync()	Asynchronicznie zamyka DbDataReader obiekt. (Odziedziczone po DbDataReader)
Dispose()	Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbDataReader i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbDataReader)
DisposeAsync()	Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie DbDataReader klasy. (Odziedziczone po DbDataReader)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (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ęcia 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ślonego przesunięcia kolumny do buforu jako tablicę rozpoczynającą się od danego przesunięcia buforu.
GetColumnSchemaAsync(CancellationToken)	Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne 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) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbDataReader)
GetData(Int32)	OleDbDataReader Zwraca obiekt dla żądanej kolumny porządkowej.
GetDataTypeName(Int32)	Pobiera nazwę typu danych źródłowych.
GetDateTime(Int32)	Pobiera wartość określonej kolumny jako DateTime obiekt.
GetDbDataReader(Int32)	DbDataReader Zwraca obiekt dla żądanej kolumny porządkowej, który można zastąpić implementacją specyficzną dla dostawcy. (Odziedziczone po DbDataReader)
GetDecimal(Int32)	Pobiera wartość określonej kolumny jako Decimal obiekt.
GetDouble(Int32)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.
GetEnumerator()	Zwraca wartość IEnumerator , która może służyć do iterowania wierszy w czytniku danych.
GetFieldType(Int32)	Type Pobiera typ 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 unikatowy identyfikator globalny (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.
GetName(Int32)	Pobiera nazwę określonej kolumny.
GetOrdinal(String)	Pobiera porządkową kolumnę, podając 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 obiekt DataTable , który opisuje metadane kolumny elementu OleDbDataReader.
GetSchemaTableAsync(CancellationToken)	Jest to asynchroniczna wersja programu GetSchemaTable(). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne 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() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbDataReader)
GetStream(Int32)	Pobiera strumień w celu pobrania 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 TimeSpan obiekt.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(Int32)	Pobiera wartość kolumny w określonym kodzie porządkowym w formacie natywnym.
GetValues(Object[])	Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza.
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 Objectelementu . (Odziedziczone po Object)
NextResult()	Rozwija czytnik danych do następnego wyniku podczas odczytywania wyników instrukcji batch SQL.
NextResultAsync()	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
Read()	OleDbDataReader Przechodzi do następnego rekordu.
ReadAsync()	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Metody rozszerzania

Zobacz też

• Elementy DataAdapter i DataReader