OdbcDataReader 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 OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Ereditarietà
- Ereditarietà
- Implementazioni
Esempio
Nell'esempio seguente viene creato un OdbcConnectionoggetto , un OdbcCommande un OdbcDataReaderoggetto . L'esempio legge i dati, scrivendolo nella console. Infine, l'esempio chiude l'oggetto OdbcDataReadere quindi .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
Commenti
Per creare un OdbcDataReaderoggetto , è necessario chiamare il ExecuteReader metodo dell'oggetto OdbcCommand anziché usare direttamente un costruttore.
Mentre l'oggetto viene usato, l'oggetto OdbcDataReader associato OdbcConnection è occupato a servire l'oggetto OdbcDataReadere non è possibile eseguire altre operazioni invece OdbcConnection di chiuderla. Questo è il caso finché non viene chiamato il Close metodo dell'oggetto OdbcDataReader . 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 OdbcDataReader. Tuttavia, il comportamento preciso è dipendente dal driver e dal tempo.
IsClosed e RecordsAffected sono le uniche proprietà che possono essere chiamate dopo la chiusura dell'oggetto OdbcDataReader. A volte, è necessario chiamare prima di poter chiamare CloseRecordsAffected.
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 OdbcDataReader contiene una o più righe. |
IsClosed |
Indica se la classe OdbcDataReader è chiusa. |
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 DbDataReader. (Ereditato da DbDataReader) |
Metodi
Close() |
Chiude l'oggetto OdbcDataReader. |
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 dall'offset della colonna specificata nel buffer come una matrice, a partire dall'offset del buffer specificato. |
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 della colonna specificata nel buffer come una matrice, a partire dall'offset del 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 IDataReader per l'ordinale di colonna specificato. |
GetData(Int32) |
Restituisce un lettore di dati annidati per la colonna richiesta. (Ereditato da DbDataReader) |
GetDataTypeName(Int32) |
Ottiene il nome del tipo di dati di origine. |
GetDate(Int32) |
Ottiene il valore della colonna specificata come oggetto DateTime. |
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() |
Obsoleti.
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 OdbcDataReader. |
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 classe String. |
GetTextReader(Int32) |
Ottiene un lettore di testo per recuperare i dati dalla colonna. (Ereditato da DbDataReader) |
GetTime(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() |
Obsoleti.
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 la classe OdbcDataReader sul risultato successivo durante la lettura dei risultati delle istruzioni batch 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 OdbcDataReader 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) |
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 tutte le risorse usate dall'istanza corrente della classe OdbcDataReader. |
IEnumerable.GetEnumerator() |
Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. 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. |
GetBoolean(DbDataReader, String) |
Ottiene il valore della colonna specificata come valore Boolean. |
GetByte(DbDataReader, String) |
Ottiene il valore della colonna specificata come byte. |
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) |
Legge un numero specificato di byte dalla colonna specificata a partire da un indice specificato e li scrive in un buffer a partire da una posizione specificata nel buffer. |
GetChar(DbDataReader, String) |
Ottiene il valore della colonna specificata come carattere singolo. |
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Legge un numero specificato di caratteri da una colonna specificata a partire da un indice specificato e li scrive in un buffer a partire da una posizione specificata. |
GetData(DbDataReader, String) |
Restituisce un lettore di dati annidati per la colonna richiesta. |
GetDataTypeName(DbDataReader, String) |
Ottiene il nome del tipo di dati della colonna specificata. |
GetDateTime(DbDataReader, String) |
Ottiene il valore della colonna specificata come oggetto DateTime. |
GetDecimal(DbDataReader, String) |
Ottiene il valore della colonna specificata sotto forma di classe Decimal. |
GetDouble(DbDataReader, String) |
Ottiene il valore della colonna specificata come numero a virgola mobile a precisione doppia. |
GetFieldType(DbDataReader, String) |
Ottiene il tipo di dati della colonna specificata. |
GetFieldValue<T>(DbDataReader, String) |
Ottiene il valore della colonna specificata come tipo richiesto. |
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto. |
GetFloat(DbDataReader, String) |
Ottiene il valore della colonna specificata come numero a virgola mobile con precisione singola. |
GetGuid(DbDataReader, String) |
Ottiene il valore della colonna specificata come identificatore univoco globale (GUID). |
GetInt16(DbDataReader, String) |
Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit. |
GetInt32(DbDataReader, String) |
Ottiene il valore della colonna specificata come intero con segno a 32 bit. |
GetInt64(DbDataReader, String) |
Ottiene il valore della colonna specificata come integer con segno a 64 bit. |
GetProviderSpecificFieldType(DbDataReader, String) |
Restituisce il tipo specifico del provider per la colonna indicata. |
GetProviderSpecificValue(DbDataReader, String) |
Ottiene il valore della colonna specificata come istanza di un tipo specifico del provider. |
GetStream(DbDataReader, String) |
Ottiene un flusso per recuperare i dati dalla colonna specificata. |
GetString(DbDataReader, String) |
Ottiene il valore della colonna specificata come istanza di String. |
GetTextReader(DbDataReader, String) |
Ottiene un lettore di testo per recuperare i dati dalla colonna. |
GetValue(DbDataReader, String) |
Ottiene il valore della colonna specificata come istanza di Object. |
IsDBNull(DbDataReader, String) |
Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti. |
IsDBNullAsync(DbDataReader, String, CancellationToken) |
Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti. |
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. |
ConfigureAwait(IAsyncDisposable, Boolean) |
Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono. |
Si applica a
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per