OdbcDataReader 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 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
- Dziedziczenie
- Dziedziczenie
- Dziedziczenie
- Implementuje
Przykłady
Poniższy przykład tworzy element OdbcConnection, i OdbcCommand.OdbcDataReader Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka element OdbcDataReader, a następnie OdbcConnectionpolecenie .
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
Uwagi
Aby utworzyć obiekt , należy wywołać ExecuteReader metodę OdbcDataReaderOdbcCommand obiektu, a nie bezpośrednio przy użyciu konstruktora.
OdbcDataReader Gdy element jest używany, skojarzony OdbcConnection jest zajęty obsługą OdbcDataReaderelementu , a żadne inne operacje nie mogą być wykonywane na OdbcConnection innym niż jego zamykanie. Tak jest do momentu Close wywołania OdbcDataReader metody . 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 .OdbcDataReader Jednak dokładne zachowanie jest zależne zarówno od sterownika, jak i chronometrażu.
IsClosed i RecordsAffected są jedynymi właściwościami, które można wywołać po OdbcDataReader zamknięciu. Czasami należy wywołać metodę Close , zanim będzie można wywołać metodę RecordsAffected.
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 OdbcDataReader jeden lub więcej wierszy. |
IsClosed |
Wskazuje, czy element OdbcDataReader 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 DbDataReader polach, które nie są ukryte. (Odziedziczone po DbDataReader) |
Metody
Close() |
OdbcDataReader 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ślonego przesunięcia kolumny do buforu jako tablicy, rozpoczynając od przesunięcia określonego 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 tablicy, rozpoczynając od przesunięcia określonego buforu. |
GetColumnSchemaAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader).
Dostawcy powinni zastąpić odpowiednią implementacją.
|
GetData(Int32) |
Zwraca element IDataReader dla określonej kolumny porządkowej. |
GetData(Int32) |
Zwraca zagnieżdżony czytnik danych dla żądanej kolumny. (Odziedziczone po DbDataReader) |
GetDataTypeName(Int32) |
Pobiera nazwę typu danych źródłowych. |
GetDate(Int32) |
Pobiera wartość określonej kolumny jako DateTime obiekt. |
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 OdbcDataReader. |
GetSchemaTableAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetSchemaTable().
Dostawcy powinni zastąpić odpowiednią implementacją.
|
GetStream(Int32) |
Pobiera strumień do pobierania danych z określonej kolumny. (Odziedziczone po DbDataReader) |
GetString(Int32) |
Pobiera wartość określonej kolumny jako String. |
GetTextReader(Int32) |
Pobiera czytnik tekstu w celu pobrania danych z kolumny. (Odziedziczone po DbDataReader) |
GetTime(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() |
OdbcDataReader Przechodzi do następnego wyniku 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() |
OdbcDataReader 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) |
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 wszystkie zasoby używane przez bieżące wystąpienie klasy OdbcDataReader. |
IEnumerable.GetEnumerator() |
Ten interfejs API obsługuje infrastrukturę produktu i nie jest przeznaczony do użycia bezpośrednio z poziomu kodu. 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. |
Cast<TResult>(IEnumerable) |
Rzutuje elementy elementu IEnumerable na określony typ. |
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 |
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