OleDbDataReader Klasa

Definicja

Zapewnia sposób odczytywania strumienia danych tylko do przodu z źródła danych.Provides a way of reading a forward-only stream of data rows from a data source. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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
OleDbDataReader
Dziedziczenie
Dziedziczenie
OleDbDataReader
Implementuje

Przykłady

Poniższy przykład tworzy OleDbConnection , OleDbCommand a i OleDbDataReader .The following example creates an OleDbConnection, an OleDbCommand, and an OleDbDataReader. Przykład odczytuje dane, pisząc je w konsoli programu.The example reads through the data, writing it out to the console. Na koniec przykład zamyka program, OleDbDataReader a następnie OleDbConnection .Finally, the example closes the OleDbDataReader and then the 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ć OleDbDataReader , należy wywołać ExecuteReader metodę OleDbCommand obiektu, zamiast bezpośrednio korzystać z konstruktora.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Przed zamknięciem programu OleDbConnection należy najpierw zamknąć OleDbDataReader obiekt.Before you close the OleDbConnection, first close the OleDbDataReader object. Należy również zamknąć obiekt, OleDbDataReader Jeśli planujesz resuse a OleDbCommand obiektu. Na przykład nie można pobrać parametrów wyjściowych do momentu wywołania Close .You must also close the OleDbDataReader object if you plan to resuse an OleDbCommand object.For example, you cannot retrieve output parameters until after you call Close.

Zmiany wprowadzone w wyniku określonym przez inny proces lub wątek podczas odczytywania danych mogą być widoczne dla użytkownika OleDbDataReader .Changes made to a result set by another process or thread while data is being read may be visible to the user of the OleDbDataReader. Jednak precyzyjne zachowanie jest zależne od chronometrażu.However, the precise behavior is timing dependent.

IsClosed i RecordsAffected są jedynymi właściwościami, które można wywołać po zakończeniu OleDbDataReader .IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Mimo że RecordsAffected Właściwość można uzyskać OleDbDataReader , gdy istnieje, zawsze wywołuj Close przed zwróceniem wartości, RecordsAffected Aby zagwarantować dokładną wartość zwracaną.Although the RecordsAffected property may be accessed while the OleDbDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Właściwości

Depth

Pobiera wartość wskazującą głębokość zagnieżdżenia dla bieżącego wiersza.Gets a value that indicates the depth of nesting for the current row.

FieldCount

Pobiera liczbę kolumn w bieżącym wierszu.Gets the number of columns in the current row.

HasRows

Pobiera wartość wskazującą, czy OleDbDataReader zawiera jeden lub więcej wierszy.Gets a value that indicates whether the OleDbDataReader contains one or more rows.

IsClosed

Wskazuje, czy czytnik danych jest zamknięty.Indicates whether the data reader is closed.

Item[Int32]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się numer porządkowy kolumny.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się nazwa kolumny.Gets the value of the specified column in its native format given the column name.

RecordsAffected

Pobiera liczbę wierszy zmienionych, wstawionych lub usuniętych przez wykonanie instrukcji SQL.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount

Pobiera liczbę pól w OleDbDataReader , które nie są ukryte.Gets the number of fields in the OleDbDataReader that are not hidden.

Metody

Close()

Zamyka OleDbDataReader obiekt.Closes the OleDbDataReader object.

CloseAsync()

Asynchronicznie zamyka DbDataReader obiekt.Asynchronously closes the DbDataReader object.

(Odziedziczone po DbDataReader)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Odziedziczone po DbDataReader)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbDataReader i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(Odziedziczone po DbDataReader)
DisposeAsync()

Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie DbDataReader klasy.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Odziedziczone po DbDataReader)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Finalize()

Umożliwia obiektowi podjęcie próby zwolnienia zasobów i wykonywanie innych operacji czyszczenia przed odinstalowaniem ich przez wyrzucanie elementów bezużytecznych.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetBoolean(Int32)

Pobiera wartość określonej kolumny jako wartość logiczną.Gets the value of the specified column as a Boolean.

GetByte(Int32)

Pobiera wartość określonej kolumny jako bajt.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Odczytuje strumień bajtów z przesunięcia określonego kolumny do bufora jako tablicę rozpoczynającą się od danego przesunięcia buforu.Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given buffer offset.

GetChar(Int32)

Pobiera wartość określonej kolumny jako znak.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32)

Odczytuje strumień znaków z przesunięcia określonego kolumny do bufora jako tablicę, rozpoczynając od danego przesunięcia buforu.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetColumnSchemaAsync(CancellationToken)

Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader) .This is the asynchronous version of GetColumnSchema(DbDataReader). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetColumnSchema(DbDataReader) wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetColumnSchema(DbDataReader) program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

(Odziedziczone po DbDataReader)
GetData(Int32)

Zwraca OleDbDataReader obiekt dla liczby porządkowej żądanej kolumny.Returns an OleDbDataReader object for the requested column ordinal.

GetDataTypeName(Int32)

Pobiera nazwę typu danych źródłowych.Gets the name of the source data type.

GetDateTime(Int32)

Pobiera wartość określonej kolumny jako DateTime obiekt.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Zwraca DbDataReader obiekt dla numeru porządkowego kolumny, który może zostać zastąpiony przez implementację specyficzną dla dostawcy.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Odziedziczone po DbDataReader)
GetDecimal(Int32)

Pobiera wartość określonej kolumny jako Decimal obiekt.Gets the value of the specified column as a Decimal object.

GetDouble(Int32)

Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.Gets the value of the specified column as a double-precision floating-point number.

GetEnumerator()

Zwraca wartość IEnumerator , która może być używana do iteracji w wierszach w czytniku danych.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32)

Pobiera Type , który jest typem danych obiektu.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

Pobiera wartość określonej kolumny jako żądany typ.Gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32)

Asynchronicznie Pobiera wartość określonej kolumny jako żądany typ.Asynchronously gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Asynchronicznie Pobiera wartość określonej kolumny jako żądany typ.Asynchronously gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFloat(Int32)

Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.Gets the value of the specified column as a single-precision floating-point number.

GetGuid(Int32)

Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetInt16(Int32)

Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetName(Int32)

Pobiera nazwę określonej kolumny.Gets the name of the specified column.

GetOrdinal(String)

Pobiera numer porządkowy kolumny, uwzględniając nazwę kolumny.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

Pobiera typ specyficzny dla dostawcy dla określonej kolumny.Gets the provider-specific type of the specified column.

(Odziedziczone po DbDataReader)
GetProviderSpecificValue(Int32)

Pobiera wartość określonej kolumny jako wystąpienie typu określonego dla dostawcy.Gets the value of the specified column as an instance of a provider-specific type.

(Odziedziczone po DbDataReader)
GetProviderSpecificValues(Object[])

Pobiera wszystkie kolumny atrybutów specyficzne dla dostawcy w kolekcji dla bieżącego wiersza.Gets all provider-specific attribute columns in the collection for the current row.

(Odziedziczone po DbDataReader)
GetSchemaTable()

Zwraca DataTable , który opisuje metadane kolumn OleDbDataReader .Returns a DataTable that describes the column metadata of the OleDbDataReader.

GetSchemaTableAsync(CancellationToken)

Jest to asynchroniczna wersja programu GetSchemaTable() .This is the asynchronous version of GetSchemaTable(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetSchemaTable() wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetSchemaTable() program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

(Odziedziczone po DbDataReader)
GetStream(Int32)

Pobiera strumień służący do pobierania danych z określonej kolumny.Gets a stream to retrieve data from the specified column.

(Odziedziczone po DbDataReader)
GetString(Int32)

Pobiera wartość określonej kolumny jako ciąg.Gets the value of the specified column as a string.

GetTextReader(Int32)

Pobiera czytnik tekstu służący do pobierania danych z kolumny.Gets a text reader to retrieve data from the column.

(Odziedziczone po DbDataReader)
GetTimeSpan(Int32)

Pobiera wartość określonej kolumny jako TimeSpan obiekt.Gets the value of the specified column as a TimeSpan object.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(Int32)

Pobiera wartość kolumny o określonym numerze porządkowym w formacie natywnym.Gets the value of the column at the specified ordinal in its native format.

GetValues(Object[])

Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
IsDBNull(Int32)

Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(Int32)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Odziedziczone po DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Odziedziczone po DbDataReader)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
NextResult()

Przesuwa czytnik danych do następnego wyniku, odczytując wyniki instrukcji wsadowych SQL.Advances the data reader to the next result, when reading the results of batch SQL statements.

NextResultAsync()

Asynchronicznie przesuwa czytnik do następnego wyniku podczas odczytywania wyników partii instrukcji.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)

Asynchronicznie przesuwa czytnik do następnego wyniku podczas odczytywania wyników partii instrukcji.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Odziedziczone po DbDataReader)
Read()

Przechodzi OleDbDataReader do następnego rekordu.Advances the OleDbDataReader to the next record.

ReadAsync()

Asynchronicznie przesuwa czytnik do następnego rekordu w zestawie wyników.Asynchronously advances the reader to the next record in a result set.

(Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)

Asynchronicznie przesuwa czytnik do następnego rekordu w zestawie wyników.Asynchronously advances the reader to the next record in a result set.

(Odziedziczone po DbDataReader)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IDataReader.Close()

Aby uzyskać opis tego elementu członkowskiego, zobacz Close() .For a description of this member, see Close().

(Odziedziczone po DbDataReader)
IDataReader.GetSchemaTable()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetSchemaTable() .For a description of this member, see GetSchemaTable().

(Odziedziczone po DbDataReader)
IDataRecord.GetData(Int32)

Zwraca wartość IDataReader dla określonej liczby porządkowej kolumny.Returns an IDataReader for the specified column ordinal.

IDataRecord.GetData(Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz GetData(Int32) .For a description of this member, see 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.Releases the resources used by the current instance of the OleDbDataReader class.

IEnumerable.GetEnumerator()

Zwraca moduł wyliczający, który iteruje po kolekcji.Returns an enumerator that iterates through a collection.

Metody rozszerzania

CanGetColumnSchema(DbDataReader)

Pobiera wartość wskazującą, czy DbDataReader można uzyskać schemat kolumny.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Pobiera schemat kolumny ( DbColumn kolekcję) dla DbDataReader .Gets the column schema (DbColumn collection) for a DbDataReader.

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też