SqlCeDataReader Class

데이터 원본에서 데이터 행의 정방향 전용 스트림을 읽는 방법을 제공합니다. 이 클래스는 상속될 수 없습니다.

네임스페이스: 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 메서드를 호출해야 합니다.

SqlCeDataReader 사용 중에는 관련 SqlCeConnection이 SqlCeDataReader의 역할을 수행합니다. 이 상태에서 같은 연결에 여러 판독기를 만들 수 있습니다.

데이터를 읽는 동안 다른 프로세스나 스레드에서 결과 집합을 변경하면 SqlCeDataReader의 사용자가 이를 볼 수 있지만 세부 동작은 이러한 상황이 발생한 시점에 따라 달라집니다.

IsClosed와 RecordsAffected는 SqlCeDataReader를 닫은 후에 호출할 수 있는 유일한 속성입니다. 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();
}

스레드 보안

이 유형의 모든 public static(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