OleDbDataReader Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Umożliwia odczytywanie strumienia danych tylko do przodu z źródła danych. Klasa ta nie może być dziedziczona.
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
inherit DbDataReader
type OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Dziedziczenie
- Dziedziczenie
- Implementuje
Przykłady
Poniższy przykład tworzy element OleDbConnection, i OleDbCommand.OleDbDataReader Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka element OleDbDataReader , a następnie polecenie 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 , należy wywołać ExecuteReader metodę OleDbDataReaderOleDbCommand obiektu, a nie bezpośrednio przy użyciu konstruktora.
Przed zamknięciem OleDbConnectionobiektu należy najpierw zamknąć 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, gdy dane są odczytywane, mogą być widoczne dla użytkownika .OleDbDataReader Jednak dokładne zachowanie zależy od chronometrażu.
IsClosed i RecordsAffected są jedynymi właściwościami, które można wywołać po OleDbDataReader zamknięciu. RecordsAffected Chociaż właściwość może być dostępna, gdy OleDbDataReader istnieje, zawsze wywołaj przed Close 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 zawiera OleDbDataReader 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 przy użyciu nazwy kolumny. |
RecordsAffected |
Pobiera liczbę wierszy zmienionych, wstawionych lub usuniętych przez wykonanie instrukcji SQL. |
VisibleFieldCount |
Pobiera liczbę pól w OleDbDataReader polach, które nie są ukryte. |
Metody
Close() |
OleDbDataReader Zamyka obiekt. |
CloseAsync() |
Asynchronicznie zamyka DbDataReader obiekt. (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 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) |
Finalize() |
Umożliwia obiektowi próbę zwolnienia zasobów i wykonanie innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci. |
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ęcie 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 przesunięcia określonej 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 |
GetData(Int32) |
OleDbDataReader Zwraca obiekt żą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 żą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 element IEnumerator , który 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ą podpisaną. |
GetInt32(Int32) |
Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą podpisaną. |
GetInt64(Int32) |
Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą podpisaną. |
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ę, 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 element DataTable opisujący metadane kolumny elementu OleDbDataReader. |
GetSchemaTableAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetSchemaTable().
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
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 TimeSpan obiekt. |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
GetValue(Int32) |
Pobiera wartość kolumny w określonym formacie natywnym. |
GetValues(Object[]) |
Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza. |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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 Objectelementu . (Odziedziczone po Object) |
MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
NextResult() |
Przechodzi do następnego wyniku czytnika danych podczas odczytywania wyników instrukcji SQL wsadowych. |
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 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) |
Zwraca element IDataReader dla określonej kolumny porządkowej. |
IDataRecord.GetData(Int32) |
Aby uzyskać opis tego elementu członkowskiego, zobacz GetData(Int32). (Odziedziczone po DbDataReader) |
IDisposable.Dispose() |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. Zwalnia zasoby używane przez bieżące wystąpienie klasy OleDbDataReader. |
IEnumerable.GetEnumerator() |
Zwraca moduł wyliczający, który iteruje po kolekcji. |
Metody rozszerzania
CanGetColumnSchema(DbDataReader) |
Pobiera wartość wskazującą, czy DbDataReader można uzyskać schemat kolumny. |
GetColumnSchema(DbDataReader) |
Pobiera schemat kolumny (DbColumn kolekcja) dla elementu 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ę na 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 DateTime obiekt. |
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 unikatowy identyfikator globalny (GUID). |
GetInt16(DbDataReader, String) |
Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą podpisaną. |
GetInt32(DbDataReader, String) |
Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą podpisaną. |
GetInt64(DbDataReader, String) |
Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą podpisaną. |
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 klasy String. |
GetTextReader(DbDataReader, String) |
Pobiera czytnik tekstu w celu pobrania danych z kolumny. |
GetValue(DbDataReader, String) |
Pobiera wartość określonej kolumny jako wystąpienie klasy 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 elementu IEnumerable do określonego typu. |
OfType<TResult>(IEnumerable) |
Filtruje elementy elementu IEnumerable na podstawie określonego typu. |
AsParallel(IEnumerable) |
Umożliwia równoległość zapytania. |
AsQueryable(IEnumerable) |
Konwertuje element IEnumerable na .IQueryable |
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguruje sposób oczekiwania na zadania zwracane z asynchronicznego jednorazowego wykonania. |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla