OleDbDataReader Klas

Definitie

Naamruimte:
System.Data.OleDb
Assembly:
System.Data.dll

Biedt een manier om een gegevensrijen van alleen-doorstuurgegevens uit een gegevensbron te lezen. Deze klasse kan niet worden overgenomen.

public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
type OleDbDataReader = class
    inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Overname
Object
MarshalByRefObject
OleDbDataReader
Overname
Object
MarshalByRefObject
DbDataReader
OleDbDataReader
Implementeringen
IEnumerable IDataReader IDataRecord IDisposable

Voorbeelden

In het volgende voorbeeld wordt een OleDbConnection, een OleDbCommanden een OleDbDataReader. In het voorbeeld worden de gegevens gelezen en naar de console geschreven. Ten slotte sluit het voorbeeld de OleDbDataReader en vervolgens de 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

Opmerkingen

Als u een OleDbDataReaderobject wilt maken, moet u de ExecuteReader methode van het OleDbCommand object aanroepen in plaats van rechtstreeks een constructor te gebruiken.

Voordat u het OleDbConnectionobject sluit, sluit u eerst het OleDbDataReader object. U moet het OleDbDataReader object ook sluiten als u van plan bent een OleDbCommand object opnieuw te gebruiken. U kunt bijvoorbeeld geen uitvoerparameters ophalen totdat u het aanroept Close.

Wijzigingen die zijn aangebracht in een resultatenset door een ander proces of een andere thread terwijl gegevens worden gelezen, zijn mogelijk zichtbaar voor de gebruiker van de OleDbDataReader. Het precieze gedrag is echter afhankelijk van timing.

IsClosed en RecordsAffected zijn de enige eigenschappen die u kunt aanroepen nadat de OleDbDataReader is gesloten. Hoewel de RecordsAffected eigenschap toegankelijk is terwijl de OleDbDataReader eigenschap bestaat, moet u altijd aanroepen Close voordat u de waarde RecordsAffected retourneert om een nauwkeurige retourwaarde te garanderen.

Eigenschappen

Name Description
Depth

Hiermee wordt een waarde opgehaald die de diepte van nesten voor de huidige rij aangeeft.
FieldCount

Hiermee haalt u het aantal kolommen in de huidige rij op.
HasRows

Hiermee wordt een waarde opgehaald die aangeeft of de OleDbDataReader rijen een of meer rijen bevatten.
IsClosed

Geeft aan of de gegevenslezer is gesloten.
Item[Int32]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal.
Item[String]

Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam.
RecordsAffected

Hiermee haalt u het aantal rijen op dat is gewijzigd, ingevoegd of verwijderd door de SQL-instructie uit te voeren.
VisibleFieldCount

Hiermee haalt u het aantal velden op OleDbDataReader dat niet verborgen is.

Methoden

Name Description
Close()

Hiermee sluit u het OleDbDataReader object.
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Dispose()

Alle resources die door het huidige exemplaar van de DbDataReader klasse worden gebruikt, worden vrijgegeven.

(Overgenomen van DbDataReader)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de DbDataReader beheerde resources en brengt eventueel de beheerde resources vrij.

(Overgenomen van DbDataReader)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Finalize()

Hiermee kan het object resources vrijmaken en andere opschoonbewerkingen uitvoeren voordat het wordt vrijgemaakt door garbagecollection.
GetBoolean(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een Booleaanse waarde.
GetByte(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)

Leest een stroom van bytes van de opgegeven kolom offset in de buffer als een matrix vanaf de opgegeven buffer offset.
GetChar(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een teken.
GetChars(Int32, Int64, Char[], Int32, Int32)

Leest een stroom tekens van de opgegeven kolom offset in de buffer als een matrix die begint bij de opgegeven buffer offset.
GetData(Int32)

Retourneert een OleDbDataReader object voor de aangevraagde kolomordinaal.
GetDataTypeName(Int32)

Hiermee haalt u de naam van het brongegevenstype op.
GetDateTime(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een DateTime object.
GetDbDataReader(Int32)

Retourneert een DbDataReader object voor de aangevraagde kolomordinaal die kan worden overschreven met een providerspecifieke implementatie.

(Overgenomen van DbDataReader)
GetDecimal(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een Decimal object.
GetDouble(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een drijvendekommagetal met dubbele precisie.
GetEnumerator()

Retourneert een IEnumerator die kan worden gebruikt om de rijen in de gegevenslezer te doorlopen.
GetFieldType(Int32)

Hiermee haalt u het Type gegevenstype van het object op.
GetFieldValue<T>(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als het aangevraagde type.

(Overgenomen van DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Asynchroon haalt de waarde van de opgegeven kolom op als het aangevraagde type.

(Overgenomen van DbDataReader)
GetFieldValueAsync<T>(Int32)

Asynchroon haalt de waarde van de opgegeven kolom op als het aangevraagde type.

(Overgenomen van DbDataReader)
GetFloat(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een drijvendekommagetal met één precisie.
GetGuid(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een GUID (Globally Unique Identifier).
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetInt16(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een 16-bits geheel getal dat is ondertekend.
GetInt32(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een 32-bits geheel getal dat is ondertekend.
GetInt64(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een 64-bits geheel getal dat is ondertekend.
GetLifetimeService()

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetName(Int32)

Hiermee haalt u de naam van de opgegeven kolom op.
GetOrdinal(String)

Hiermee haalt u de kolomordinaal op, op basis van de naam van de kolom.
GetProviderSpecificFieldType(Int32)

Hiermee haalt u het providerspecifieke type van de opgegeven kolom op.

(Overgenomen van DbDataReader)
GetProviderSpecificValue(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een exemplaar van een providerspecifiek type.

(Overgenomen van DbDataReader)
GetProviderSpecificValues(Object[])

Hiermee worden alle providerspecifieke kenmerkkolommen in de verzameling opgehaald voor de huidige rij.

(Overgenomen van DbDataReader)
GetSchemaTable()

Retourneert een DataTable die de kolommetagegevens van de OleDbDataReader.
GetStream(Int32)

Hiermee haalt u een stroom op om gegevens op te halen uit de opgegeven kolom.

(Overgenomen van DbDataReader)
GetString(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een tekenreeks.
GetTextReader(Int32)

Hiermee haalt u een tekstlezer op om gegevens op te halen uit de kolom.

(Overgenomen van DbDataReader)
GetTimeSpan(Int32)

Hiermee haalt u de waarde van de opgegeven kolom op als een TimeSpan object.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetValue(Int32)

Hiermee haalt u de waarde van de kolom op in de opgegeven rangschikk in de systeemeigen indeling.
GetValues(Object[])

Hiermee wordt een matrix met objecten gevuld met de kolomwaarden van de huidige rij.
InitializeLifetimeService()

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
IsDBNull(Int32)

Hiermee wordt een waarde opgehaald die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.
IsDBNullAsync(Int32, CancellationToken)

Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.

(Overgenomen van DbDataReader)
IsDBNullAsync(Int32)

Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.

(Overgenomen van DbDataReader)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
NextResult()

Hiermee wordt de gegevenslezer naar het volgende resultaat doorgevroegd bij het lezen van de resultaten van batch SQL-instructies.
NextResultAsync()

De lezer wordt asynchroon naar het volgende resultaat doorgevroegd bij het lezen van de resultaten van een batch met instructies.

(Overgenomen van DbDataReader)
NextResultAsync(CancellationToken)

De lezer wordt asynchroon naar het volgende resultaat doorgevroegd bij het lezen van de resultaten van een batch met instructies.

(Overgenomen van DbDataReader)
Read()

Hiermee gaat u naar OleDbDataReader de volgende record.
ReadAsync()

De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset.

(Overgenomen van DbDataReader)
ReadAsync(CancellationToken)

De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset.

(Overgenomen van DbDataReader)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Expliciete interface-implementaties

Name Description
IDataRecord.GetData(Int32)

Retourneert een IDataReader voor de opgegeven kolomordinaal.
IDataRecord.GetData(Int32)

Zie voor een beschrijving van dit lid GetData(Int32).

(Overgenomen van DbDataReader)
IDisposable.Dispose()

Deze API ondersteunt de productinfrastructuur en is niet bedoeld om rechtstreeks vanuit de code te gebruiken.

Releases van de resources die worden gebruikt door het huidige exemplaar van de OleDbDataReader klasse.
IEnumerable.GetEnumerator()

Retourneert een enumerator die door een verzameling wordt herhaald.

Extensiemethoden

Name Description
AsParallel(IEnumerable)

Hiermee schakelt u parallelle uitvoering van een query in.
AsQueryable(IEnumerable)

Converteert een IEnumerable naar een IQueryable.
CanGetColumnSchema(DbDataReader)

Hiermee wordt een waarde opgehaald die aangeeft of een DbDataReader kolomschema kan worden opgehaald.
Cast<TResult>(IEnumerable)

Cast de elementen van een IEnumerable naar het opgegeven type.
GetColumnSchema(DbDataReader)

Hiermee haalt u het kolomschema (DbColumn verzameling) voor een DbDataReader.
OfType<TResult>(IEnumerable)

Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type.

Van toepassing op

Zie ook