OdbcDataReader Klasa

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

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

Źródło:

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

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

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Dziedziczenie

Object

MarshalByRefObject

DbDataReader

OdbcDataReader

Przykłady

Poniższy przykład tworzy OdbcConnection, OdbcCommandi OdbcDataReader. Przykład odczytuje dane, zapisuj je w konsoli. Na koniec przykład zamyka OdbcDataReader, a następnie OdbcConnection.

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ć OdbcDataReader, należy wywołać metodę ExecuteReader obiektu OdbcCommand zamiast bezpośrednio przy użyciu konstruktora.

Gdy OdbcDataReader jest używany, skojarzony OdbcConnection jest zajęty obsługą OdbcDataReaderi nie można wykonać żadnych innych operacji na OdbcConnection innym niż jego zamykanie. Dzieje się tak do momentu wywołania metody CloseOdbcDataReader. 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 OdbcDataReader. Jednak dokładne zachowanie jest zależne zarówno od sterownika, jak i czasu.

IsClosed i RecordsAffected są jedynymi właściwościami, które można wywołać po zamknięciu OdbcDataReader. Czasami należy wywołać Close, zanim będzie można zadzwonić RecordsAffected.

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 OdbcDataReader zawiera jeden lub więcej wierszy.
IsClosed	Wskazuje, czy 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, 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 DbDataReader, które nie są ukryte. (Odziedziczone po DbDataReader)

Metody

Close()	Zamyka obiekt OdbcDataReader.
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ęcia do buforu jako tablicy, zaczynają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 określonej kolumny przesunięcia do buforu jako tablicy, zaczynając od przesunięcia określonego 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 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 obiekt DateTime.
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 OdbcDataReader.
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 String.
GetTextReader(Int32)	Pobiera czytnik tekstu w celu pobrania danych z kolumny. (Odziedziczone po DbDataReader)
GetTime(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()	Przechodzi OdbcDataReader do następnego wyniku podczas odczytywania wyników instrukcji batch SQL.
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 OdbcDataReader 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