OdbcDataReader Klas

Definitie

Naamruimte:
System.Data.Odbc
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 OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
type OdbcDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IEnumerable
type OdbcDataReader = class
    inherit DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Overname
Object
MarshalByRefObject
OdbcDataReader
Overname
Object
MarshalByRefObject
DbDataReader
OdbcDataReader
Implementeringen
IEnumerable IDataReader IDataRecord IDisposable

Voorbeelden

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

Opmerkingen

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

Terwijl het OdbcDataReader wordt gebruikt, is de gekoppelde OdbcConnection bezig met het leveren van de OdbcDataReaderene bewerking en kunnen er geen andere bewerkingen worden uitgevoerd op de OdbcConnection andere dan het sluiten ervan. Dit is het geval totdat de Close methode van de OdbcDataReader aangeroepen methode wordt aangeroepen. 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 OdbcDataReader. Het precieze gedrag is echter zowel stuurprogramma- als timingafhankelijk.

IsClosed en RecordsAffected zijn de enige eigenschappen die u kunt aanroepen nadat de OdbcDataReader is gesloten. Soms moet u bellen Close voordat u kunt bellen RecordsAffected.

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 OdbcDataReader rijen een of meer rijen bevatten.
IsClosed

Geeft aan of de OdbcDataReader gesloten is.
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 DbDataReader dat niet verborgen is.

(Overgenomen van DbDataReader)

Methoden

Name Description
Close()

Hiermee sluit u het OdbcDataReader 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, te beginnen bij de specifieke 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 matrix, te beginnen bij de specifieke buffer offset.
GetData(Int32)

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

Retourneert een geneste gegevenslezer voor de aangevraagde kolom.

(Overgenomen van DbDataReader)
GetDataTypeName(Int32)

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

Hiermee haalt u de waarde van de opgegeven kolom op als een DateTime object.
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 OdbcDataReader.
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 String.
GetTextReader(Int32)

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

(Overgenomen van DbDataReader)
GetTime(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 gaat u naar OdbcDataReader het volgende resultaat 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 OdbcDataReader 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)

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.

Alle resources die door het huidige exemplaar van de OdbcDataReader klasse worden gebruikt, worden vrijgegeven.
IEnumerable.GetEnumerator()

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

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