OdbcDataReader Klasa

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

System.Data.Odbc v8.0.0

Źródło:

OdbcDataReader.cs

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

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

Dziedziczenie

Object

DbDataReader

OdbcDataReader

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)
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ś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ą. cancellationToken Opcjonalnie 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 przekazano już anulowane cancellationToken. Wyjątki zgłoszone przez GetColumnSchema(DbDataReader) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki 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 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ą.
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ą. cancellationToken Opcjonalnie 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 przekazano już anulowane cancellationToken. Wyjątki zgłoszone przez GetSchemaTable() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki 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 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.
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()	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)

Metody rozszerzania

Zobacz też

• Elementy DataAdapter i DataReader