SqlCeDataReader Class

提供自資料來源讀取資料列之順向 (Forward-Only) 資料流的方法。這個類別無法被繼承。

命名空間: System.Data.SqlServerCe
組件: System.Data.SqlServerCe (在 system.data.sqlserverce.dll)

語法

'宣告
<DefaultMemberAttribute("Item")> _
Public Class SqlCeDataReader
    Inherits DbDataReader

[DefaultMemberAttribute("Item")] 
public class SqlCeDataReader : DbDataReader

[DefaultMemberAttribute(L"Item")] 
public ref class SqlCeDataReader : public DbDataReader

/** @attribute DefaultMemberAttribute("Item") */ 
public class SqlCeDataReader extends DbDataReader

DefaultMemberAttribute("Item") 
public class SqlCeDataReader extends DbDataReader

備註

若要建立 SqlCeDataReader，則必須呼叫 SqlCeCommand 物件的 ExecuteReader 方法，而不是直接使用建構函式 (Constructor)。

當 SqlCeDataReader 在使用中時，相關聯的 SqlCeConnection 會忙於服務 SqlCeDataReader。在這個狀態下，您可以在同一個連接中建立多個讀取器 (Reader)。

SqlCeDataReader 的使用者可能看得到另一個處理序或執行緒在讀取資料時對結果集所做的變更；但是，確切的行為需視這些事件發生的時間而定。

在 SqlCeDataReader 關閉後，IsClosed 和 RecordsAffected 是唯一可以呼叫的屬性。雖然您可以在 SqlCeDataReader 存在時隨時存取 RecordsAffected 屬性，但在傳回 RecordsAffected 的值之前請一定要呼叫 Close，以確保傳回正確的值。

繼承階層

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

範例

下列範例會建立 SqlCeConnection、SqlCeCommand 和 SqlCeDataReader。此範例會讀取資料並將資料寫出到主控台，然後再關閉 SqlCeDataReader 和 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();
}

執行緒安全性

任何公用靜態 (共用 在 Microsoft Visual Basic) 此型別的成員具備執行緒安全。不保證任何執行個體成員安全執行緒。

平台

開發平台

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
版本資訊
.NET Framework 及 NET Compact Framework
支援於 3.5
.NET Framework
支援於 3.0
.NET Compact Framework 及 .Net Framework
支援於 2.0

另請參閱

參考

SqlCeDataReader Members
System.Data.SqlServerCe Namespace