Condividi tramite

Classe SqlCeDataReader

  • Articolo

Fornisce un modo per leggere un flusso di righe di dati forward-only da un'origine dati. Questa classe non può essere ereditata.

Gerarchia di ereditarietà

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

Spazio dei nomi  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Sintassi

'Dichiarazione
Public Class SqlCeDataReader _
    Inherits DbDataReader
'Utilizzo
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

Nel tipo SqlCeDataReader sono esposti i membri seguenti.

Proprietà

  Nome Descrizione
Proprietà pubblica Depth Ottiene un valore che indica il livello di nidificazione della riga corrente. Esegue l'override di DbDataReader.Depth.
Proprietà pubblica FieldCount Ottiene il numero di colonne nella clausola SELECT della query. Esegue l'override di DbDataReader.FieldCount.
Proprietà pubblica HasRows Ottiene un valore che indica se l'oggetto SqlCeDataReader contiene una o più righe. Esegue l'override di DbDataReader.HasRows.
Proprietà pubblica HiddenFieldCount Infrastruttura.
Proprietà pubblica IsClosed Indica se il visualizzatore di dati è chiuso. Esegue l'override di DbDataReader.IsClosed.
Proprietà pubblica Item[Int32] Ottiene il valore della colonna specificata nel formato nativo in base all'ordinale di colonna. Esegue l'override di DbDataReader.Item[Int32].
Proprietà pubblica Item[String] Ottiene il valore della colonna specificata nel formato nativo in base al nome della colonna. Esegue l'override di DbDataReader.Item[String].
Proprietà pubblica RecordsAffected Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL. Esegue l'override di DbDataReader.RecordsAffected.
Proprietà pubblica VisibleFieldCount (ereditato da DbDataReader)

In alto

Metodi

  Nome Descrizione
Metodo pubblico Close Chiude l'oggetto SqlCeDataReader. Esegue l'override di DbDataReader.Close().
Metodo pubblico CreateObjRef (ereditato da MarshalByRefObject)
Metodo pubblico Dispose() Infrastruttura. Rilascia le risorse utilizzate da questo oggetto SqlCeDataReader.
Metodo protetto Dispose(Boolean) Rilascia le risorse non gestite utilizzate da questo oggetto SqlCeDataReader e, facoltativamente, anche le risorse gestite. Esegue l'override di DbDataReader.Dispose(Boolean).
Metodo pubblico Equals (ereditato da Object)
Metodo protetto Finalize Rilascia risorse non gestite ed esegue altre operazioni di pulizia prima che l'oggetto SqlCeDataReader sia recuperato dalla procedura di Garbage Collection. Esegue l'override di Object.Finalize().
Metodo pubblico GetBoolean Ottiene il valore della colonna specificata come valore Boolean. Esegue l'override di DbDataReader.GetBoolean(Int32).
Metodo pubblico GetByte Ottiene il valore della colonna specificata sotto forma di byte. Esegue l'override di DbDataReader.GetByte(Int32).
Metodo pubblico GetBytes Legge un flusso di byte dall'offset di colonna indicato nel buffer come matrice a partire dall'offset del buffer specificato. Esegue l'override di DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).
Metodo pubblico GetChar Non supportato nel provider di dati .NET Compact Framework per SQL Server Compact. Esegue l'override di DbDataReader.GetChar(Int32).
Metodo pubblico GetChars Legge un flusso di caratteri dall'offset di colonna indicato nel buffer come matrice a partire dall'offset del buffer specificato. Esegue l'override di DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).
Metodo pubblico GetData (ereditato da DbDataReader)
Metodo pubblico GetDataTypeName Ottiene il nome del tipo di dati di origine. Esegue l'override di DbDataReader.GetDataTypeName(Int32).
Metodo pubblico GetDateTime Ottiene il valore della colonna specificata come oggetto DateTime. Esegue l'override di DbDataReader.GetDateTime(Int32).
Metodo protetto GetDbDataReader (ereditato da DbDataReader)
Metodo pubblico GetDecimal Ottiene il valore della colonna specificata come oggetto Decimal. Esegue l'override di DbDataReader.GetDecimal(Int32).
Metodo pubblico GetDouble Ottiene il valore della colonna specificata come numero a virgola mobile a precisione doppia. Esegue l'override di DbDataReader.GetDouble(Int32).
Metodo pubblico GetEnumerator Infrastruttura. Esegue l'override di DbDataReader.GetEnumerator().
Metodo pubblico GetFieldType Ottiene l'oggetto Type che rappresenta il tipo di dati dell'oggetto. Esegue l'override di DbDataReader.GetFieldType(Int32).
Metodo pubblico GetFloat Ottiene il valore della colonna specificata sotto forma di numero a virgola mobile a precisione singola. Esegue l'override di DbDataReader.GetFloat(Int32).
Metodo pubblico GetGuid Ottiene il valore della colonna specificata come identificatore univoco globale (GUID). Esegue l'override di DbDataReader.GetGuid(Int32).
Metodo pubblico GetHashCode (ereditato da Object)
Metodo pubblico GetInt16 Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit. Esegue l'override di DbDataReader.GetInt16(Int32).
Metodo pubblico GetInt32 Ottiene il valore della colonna specificata sotto forma di intero con segno a 32 bit. Esegue l'override di DbDataReader.GetInt32(Int32).
Metodo pubblico GetInt64 Ottiene il valore della colonna specificata sotto forma di intero con segno a 64 bit. Esegue l'override di DbDataReader.GetInt64(Int32).
Metodo pubblico GetLifetimeService (ereditato da MarshalByRefObject)
Metodo pubblico GetName Ottiene il nome della colonna specificata. Esegue l'override di DbDataReader.GetName(Int32).
Metodo pubblico GetOrdinal Ottiene l'ordinale di colonna, in base al nome della colonna. Esegue l'override di DbDataReader.GetOrdinal(String).
Metodo pubblico GetProviderSpecificFieldType Ottiene un oggetto Object che consiste in una rappresentazione del tipo di campo specifico del provider sottostante. Esegue l'override di DbDataReader.GetProviderSpecificFieldType(Int32).
Metodo pubblico GetProviderSpecificValue (ereditato da DbDataReader)
Metodo pubblico GetProviderSpecificValues (ereditato da DbDataReader)
Metodo pubblico GetSchemaTable Restituisce una classe DataTable che descrive i metadati della colonna della classe SqlCeDataReader. Esegue l'override di DbDataReader.GetSchemaTable().
Metodo pubblico GetSqlBinary Ottiene il valore della colonna specificata come oggetto SqlBinary.
Metodo pubblico GetSqlBoolean Ottiene il valore della colonna specificata come oggetto SqlBoolean.
Metodo pubblico GetSqlByte Ottiene il valore della colonna specificata come oggetto SqlByte.
Metodo pubblico GetSqlDateTime Ottiene il valore della colonna specificata come oggetto SqlDateTime.
Metodo pubblico GetSqlDecimal Ottiene il valore della colonna specificata come oggetto SqlDecimal.
Metodo pubblico GetSqlDouble Ottiene il valore della colonna specificata come oggetto SqlDouble.
Metodo pubblico GetSqlGuid Ottiene il valore della colonna specificata come oggetto SqlGuid.
Metodo pubblico GetSqlInt16 Ottiene il valore della colonna specificata come oggetto SqlInt16.
Metodo pubblico GetSqlInt32 Ottiene il valore della colonna specificata come oggetto SqlInt32.
Metodo pubblico GetSqlInt64 Ottiene il valore della colonna specificata come oggetto SqlInt64.
Metodo pubblico GetSqlMoney Ottiene il valore della colonna specificata come oggetto SqlMoney.
Metodo pubblico GetSqlSingle Ottiene il valore della colonna specificata come oggetto SqlSingle.
Metodo pubblico GetSqlString Ottiene il valore della colonna specificata come oggetto SqlString.
Metodo pubblico GetString Ottiene il valore della colonna specificata sotto forma di stringa. Esegue l'override di DbDataReader.GetString(Int32).
Metodo pubblico GetType (ereditato da Object)
Metodo pubblico GetValue Ottiene il valore della colonna in corrispondenza dell'ordinale specificato nel formato nativo. Esegue l'override di DbDataReader.GetValue(Int32).
Metodo pubblico GetValues Ottiene tutte le colonne attributo nella riga corrente. Esegue l'override di DbDataReader.GetValues(array<Object[]).
Metodo pubblico InitializeLifetimeService (ereditato da MarshalByRefObject)
Metodo protetto IsCommandBehavior Determina se l'oggetto CommandBehavior specificato corrisponde a quello di questo oggetto SqlCeDataReader.
Metodo pubblico IsDBNull Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti. Esegue l'override di DbDataReader.IsDBNull(Int32).
Metodo protetto MemberwiseClone() (ereditato da Object)
Metodo protetto MemberwiseClone(Boolean) (ereditato da MarshalByRefObject)
Metodo pubblico NextResult Non supportato nel provider di dati .NET Compact Framework per SQL Server Compact. Esegue l'override di DbDataReader.NextResult().
Metodo protetto OnMove Infrastruttura.
Metodo pubblico Read Sposta l'oggetto SqlCeDataReader al record successivo. Esegue l'override di DbDataReader.Read().
Metodo pubblico Seek Posiziona l'oggetto SqlCeDataReader sul record con valori indicizzati corrispondenti ai parametri specificati.
Metodo pubblico ToString (ereditato da Object)

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IDataRecord.GetData (ereditato da DbDataReader)

In alto

Osservazioni

Per creare un oggetto SqlCeDataReader, è necessario chiamare il metodo ExecuteReader dell'oggetto SqlCeCommand, anziché utilizzare direttamente un costruttore.

Mentre l'oggetto SqlCeDataReader è in uso, l'oggetto SqlCeConnection associato è occupato nel rendere disponibile l'oggetto SqlCeDataReader. In questo stato, è possibile creare più visualizzatori nella stessa connessione.

Le modifiche apportate a un set di risultati da un altro processo o thread durante la lettura dei dati sono visibili agli utenti di SqlCeDataReader, tuttavia il comportamento preciso dipende da quando vengono apportate.

IsClosed e RecordsAffected sono le uniche proprietà che è possibile chiamare dopo la chiusura dell'oggetto SqlCeDataReader. Anche se è possibile accedere alla proprietà RecordsAffected in qualsiasi momento in presenza dell'oggetto SqlCeDataReader, è preferibile chiamare sempre il metodo Close prima della restituzione del valore della proprietà RecordsAffected per assicurare un valore restituito preciso.

Esempi

Nell'esempio che segue vengono creati un oggetto SqlCeConnection, un oggetto SqlCeCommand e un oggetto SqlCeDataReader. Nell'esempio che segue, i dati, dopo essere stati letti, vengono scritti sulla console e quindi vengono chiusi gli oggetti SqlCeDataReader e SqlCeConnection.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

Protezione dei thread

I membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.SqlServerCe