OleDbDataReader Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un modo per leggere un flusso di righe di dati forward-only da un'origine dati. La classe non può essere ereditata.
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
- Ereditarietà
- Ereditarietà
- Ereditarietà
- Implementazioni
Esempio
Nell'esempio seguente viene creato un OleDbConnectionoggetto , un OleDbCommandoggetto e un oggetto OleDbDataReader. L'esempio legge i dati, scrivendoli nella console. Infine, l'esempio chiude OleDbDataReader e quindi .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
Commenti
Per creare un OleDbDataReaderoggetto , è necessario chiamare il ExecuteReader metodo dell'oggetto OleDbCommand anziché usare direttamente un costruttore.
Prima di chiudere l'oggetto OleDbConnection, chiudere prima di tutto l'oggetto OleDbDataReader . È inoltre necessario chiudere l'oggetto OleDbDataReader se si prevede di ripristinare un OleDbCommand oggetto. Ad esempio, non è possibile recuperare i parametri di output fino a quando non si chiama Close.
Le modifiche apportate a un set di risultati da un altro processo o thread durante la lettura dei dati possono essere visibili all'utente dell'oggetto OleDbDataReader. Tuttavia, il comportamento preciso dipende dal tempo.
IsClosed e RecordsAffected sono le uniche proprietà che possono essere chiamate dopo la chiusura dell'oggetto OleDbDataReader. Anche se è possibile accedere alla RecordsAffected proprietà mentre OleDbDataReader esiste, chiamare Close sempre prima di restituire il valore di RecordsAffected per garantire un valore restituito accurato.
Proprietà
Depth |
Ottiene un valore che indica la profondità dell'annidamento per la riga corrente. |
FieldCount |
Ottiene il numero di colonne nella riga corrente. |
HasRows |
Ottiene un valore che indica se la classe OleDbDataReader contiene una o più righe. |
IsClosed |
Indica se il visualizzatore di dati è chiuso. |
Item[Int32] |
Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della colonna. |
Item[String] |
Ottiene il valore della colonna specificata nel formato nativo, dato il nome della colonna. |
RecordsAffected |
Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL. |
VisibleFieldCount |
Ottiene il numero di campi non nascosti in OleDbDataReader. |
Metodi
Close() |
Chiude l'oggetto OleDbDataReader. |
CloseAsync() |
Chiude in modo asincrono l'oggetto DbDataReader. (Ereditato da DbDataReader) |
CreateObjRef(Type) |
Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject) |
Dispose() |
Rilascia tutte le risorse usate dall'istanza corrente della classe DbDataReader. (Ereditato da DbDataReader) |
Dispose(Boolean) |
Rilascia le risorse non gestite usate da DbDataReader e, facoltativamente, le risorse gestite. (Ereditato da DbDataReader) |
DisposeAsync() |
Rilascia in modo asincrono le risorse usate dall'istanza corrente della classe DbDataReader. (Ereditato da DbDataReader) |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
Finalize() |
Consente all'oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga recuperato da Garbage Collection. |
GetBoolean(Int32) |
Ottiene il valore della colonna specificata come valore Boolean. |
GetByte(Int32) |
Ottiene il valore della colonna specificata come byte. |
GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Legge un flusso di byte dalla colonna specificata nel buffer come una matrice a partire dall'offset del buffer determinato. |
GetChar(Int32) |
Ottiene il valore della colonna specificata sotto forma di carattere. |
GetChars(Int32, Int64, Char[], Int32, Int32) |
Legge un flusso di caratteri dall'offset di colonna specificato nel buffer sotto forma di matrice, a partire dall'offset di buffer specificato. |
GetColumnSchemaAsync(CancellationToken) |
Si tratta della versione asincrona di GetColumnSchema(DbDataReader).
I provider devono eseguire l'override con un'implementazione appropriata.
|
GetData(Int32) |
Restituisce un oggetto OleDbDataReader per l'ordinale della colonna richiesto. |
GetDataTypeName(Int32) |
Ottiene il nome del tipo di dati di origine. |
GetDateTime(Int32) |
Ottiene il valore della colonna specificata come oggetto DateTime. |
GetDbDataReader(Int32) |
Restituisce un oggetto DbDataReader per l'ordinale di colonna richiesto, di cui è possibile eseguire l'override tramite un'implementazione specifica del provider. (Ereditato da DbDataReader) |
GetDecimal(Int32) |
Ottiene il valore della colonna specificata come oggetto Decimal. |
GetDouble(Int32) |
Ottiene il valore della colonna specificata sotto forma di numero a virgola mobile e precisione doppia. |
GetEnumerator() |
Restituisce un oggetto IEnumerator che può essere utilizzato per scorrere le righe nel lettore di dati. |
GetFieldType(Int32) |
Ottiene l'oggetto Type che rappresenta il tipo di dati dell'oggetto. |
GetFieldValue<T>(Int32) |
Ottiene il valore della colonna specificata come tipo richiesto. (Ereditato da DbDataReader) |
GetFieldValueAsync<T>(Int32) |
Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto. (Ereditato da DbDataReader) |
GetFieldValueAsync<T>(Int32, CancellationToken) |
Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto. (Ereditato da DbDataReader) |
GetFloat(Int32) |
Ottiene il valore della colonna specificata sotto forma di numero in virgola mobile e precisione singola. |
GetGuid(Int32) |
Ottiene il valore della colonna specificata come identificatore univoco globale (GUID). |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetInt16(Int32) |
Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit. |
GetInt32(Int32) |
Ottiene il valore della colonna specificata come intero con segno a 32 bit. |
GetInt64(Int32) |
Ottiene il valore della colonna specificata come integer con segno a 64 bit. |
GetLifetimeService() |
Obsoleta.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
GetName(Int32) |
Ottiene il nome della colonna specificata. |
GetOrdinal(String) |
Ottiene la posizione ordinale della colonna, dato il nome della colonna. |
GetProviderSpecificFieldType(Int32) |
Restituisce il tipo specifico del provider per la colonna indicata. (Ereditato da DbDataReader) |
GetProviderSpecificValue(Int32) |
Ottiene il valore della colonna specificata come istanza di un tipo specifico del provider. (Ereditato da DbDataReader) |
GetProviderSpecificValues(Object[]) |
Ottiene tutte le colonne attributo specifiche del provider nella raccolta per la riga corrente. (Ereditato da DbDataReader) |
GetSchemaTable() |
Restituisce un oggetto DataTable che descrive i metadati della colonna di OleDbDataReader. |
GetSchemaTableAsync(CancellationToken) |
Si tratta della versione asincrona di GetSchemaTable().
I provider devono eseguire l'override con un'implementazione appropriata.
|
GetStream(Int32) |
Ottiene un flusso per recuperare i dati dalla colonna specificata. (Ereditato da DbDataReader) |
GetString(Int32) |
Ottiene il valore della colonna specificata sotto forma di stringa. |
GetTextReader(Int32) |
Ottiene un lettore di testo per recuperare i dati dalla colonna. (Ereditato da DbDataReader) |
GetTimeSpan(Int32) |
Ottiene il valore della colonna specificata come oggetto TimeSpan. |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
GetValue(Int32) |
Ottiene il valore della colonna in corrispondenza dell'ordinale specificato nel formato nativo. |
GetValues(Object[]) |
Popola una matrice di oggetti con i valori della colonna della riga corrente. |
InitializeLifetimeService() |
Obsoleta.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
IsDBNull(Int32) |
Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti. |
IsDBNullAsync(Int32) |
Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti. (Ereditato da DbDataReader) |
IsDBNullAsync(Int32, CancellationToken) |
Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti. (Ereditato da DbDataReader) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
NextResult() |
Sposta il lettore dati al risultato successivo durante la lettura dei risultati di un batch di istruzioni SQL. |
NextResultAsync() |
Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni. (Ereditato da DbDataReader) |
NextResultAsync(CancellationToken) |
Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni. (Ereditato da DbDataReader) |
Read() |
Sposta l'oggetto OleDbDataReader al record successivo. |
ReadAsync() |
Sposta in modo asincrono il lettore al record successivo in un set di risultati. (Ereditato da DbDataReader) |
ReadAsync(CancellationToken) |
Sposta in modo asincrono il lettore al record successivo in un set di risultati. (Ereditato da DbDataReader) |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IDataRecord.GetData(Int32) |
Restituisce IDataReader per l'ordinale di colonna specificato. |
IDataRecord.GetData(Int32) |
Per una descrizione di questo membro, vedere GetData(Int32). (Ereditato da DbDataReader) |
IDisposable.Dispose() |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Rilascia le risorse usate dall'istanza corrente della classe OleDbDataReader. |
IEnumerable.GetEnumerator() |
Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta. |
Metodi di estensione
CanGetColumnSchema(DbDataReader) |
Ottiene un valore che indica se un oggetto DbDataReader può ottenere uno schema di colonna. |
GetColumnSchema(DbDataReader) |
Ottiene lo schema di colonne (raccolta DbColumn) per un oggetto DbDataReader. |
Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato. |
OfType<TResult>(IEnumerable) |
Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato. |
AsParallel(IEnumerable) |
Consente la parallelizzazione di una query. |
AsQueryable(IEnumerable) |
Converte un oggetto IEnumerable in un oggetto IQueryable. |