SqlCeDataReader

.NET Framework クラス ライブラリ リファレンス

SqlCeDataReader クラス

データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Class SqlCeDataReader
    Inherits DbDataReader

Visual Basic (使用法)

Dim instance As SqlCeDataReader

C#

public class SqlCeDataReader : DbDataReader

C++

public ref class SqlCeDataReader : public
 DbDataReader

J#

public class SqlCeDataReader extends DbDataReader

JScript

public class SqlCeDataReader extends
 DbDataReader

解説

SqlCeDataReader を作成するには、コンストラクタを直接使用せずに、SqlCeCommand オブジェクトの ExecuteReader メソッドを呼び出す必要があります。

SqlCeDataReader の使用中は、関連付けられた SqlCeConnection は、その SqlCeDataReader によって使用されるためビジー状態になります。この状態では、同じ接続で複数のリーダーを作成できます。

データの読み取り中に別のプロセスまたはスレッドが結果セットに加えた変更が、SqlCeDataReader のユーザーに表示されることがあります。実際の動作は、いつ変更が行われたかによって決まります。

SqlCeDataReader を閉じた後に呼び出すことができるのは、IsClosed プロパティと RecordsAffected プロパティだけです。RecordsAffected プロパティは、SqlCeDataReader が存在している間はいつでも呼び出すことができますが、正しい戻り値を得るために、RecordsAffected の値を取得する前には、必ず Close を呼び出してください。

使用例

SqlCeConnection、SqlCeCommand、および SqlCeDataReader を作成する例を次に示します。この例では、データを読み取り、コンソールに出力した後で、SqlCeDataReader と SqlCeConnection を閉じます。

Visual Basic

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

C#

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();
}

継承階層

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

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeDataReader メンバ
System.Data.SqlServerCe 名前空間

SqlCeDataReader プロパティ

パブリック プロパティ

	名前	説明
	Depth	オーバーライドされます。 現在の行の入れ子の深さを示す値を取得します。
	FieldCount	オーバーライドされます。 現在の行の列数を取得します。
	HasRows	オーバーライドされます。
	IsClosed	オーバーライドされます。 データ リーダーが閉じているかどうかを示します。
	Item	オーバーロードされます。 オーバーライドされます。 特定の列の値をネイティブ形式で取得します。
	RecordsAffected	オーバーライドされます。 SQL ステートメントによって変更、挿入、または削除された行数を取得します。
	VisibleFieldCount	DbDataReader の非表示ではないフィールドの数を取得します。 ( DbDataReader から継承されます。)

参照

関連項目

SqlCeDataReader クラス
System.Data.SqlServerCe 名前空間

SqlCeDataReader メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	オーバーライドされます。 SqlCeDataReader オブジェクトを閉じます。
	Dispose	オーバーロードされます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBoolean	オーバーライドされます。 指定した列の値をブール値として取得します。
	GetByte	オーバーライドされます。 指定した列の値をバイトとして取得します。
	GetBytes	オーバーライドされます。 指定した列オフセットからのバイト ストリームを、配列としてバッファに読み込みます。読み込みは、指定したバッファ オフセットから開始されます。
	GetChar	オーバーライドされます。 .NET Compact Framework Data Provider for SQL Server Mobile ではサポートされていません。
	GetChars	オーバーライドされます。 指定した列オフセットからの文字ストリームを、配列としてバッファに読み込みます。読み込みは、指定したバッファ オフセットから開始されます。
	GetData	要求された列の序数の DbDataReader オブジェクトを返します。 ( DbDataReader から継承されます。)
	GetDataTypeName	オーバーライドされます。 ソースのデータ型の名前を取得します。
	GetDateTime	オーバーライドされます。 指定した列の値を DateTime オブジェクトとして取得します。
	GetDecimal	オーバーライドされます。 指定した列の値を Decimal オブジェクトとして取得します。
	GetDouble	オーバーライドされます。 指定した列の値を倍精度浮動小数点数値として取得します。
	GetEnumerator	オーバーライドされます。
	GetFieldType	オーバーライドされます。 オブジェクトのデータ型である Type を取得します。
	GetFloat	オーバーライドされます。 指定した列の値を単精度浮動小数点数として取得します。
	GetGuid	オーバーライドされます。 指定した列の値をグローバル一意識別子 (GUID) として取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetInt16	オーバーライドされます。 指定した列の値を 16 ビット符号付き整数として取得します。
	GetInt32	オーバーライドされます。 指定した列の値を 32 ビット符号付き整数として取得します。
	GetInt64	オーバーライドされます。 指定した列の値を 64 ビット符号付き整数として取得します。
	GetName	オーバーライドされます。 指定した列の名前を取得します。
	GetOrdinal	オーバーライドされます。 列の名前を指定して、列の序数を取得します。
	GetProviderSpecificFieldType	オーバーライドされます。
	GetProviderSpecificValue	指定した列の値を Object のインスタンスとして取得します。 ( DbDataReader から継承されます。)
	GetProviderSpecificValues	現在の行のコレクション内にあるすべてのプロバイダ固有の属性列を取得します。 ( DbDataReader から継承されます。)
	GetSchemaTable	オーバーライドされます。 SqlCeDataReader の列メタデータを記述する DataTable を返します。
	GetSqlBinary	指定した列の値を SqlBinary として取得します。
	GetSqlBoolean	指定した列の値を SqlBoolean として取得します。
	GetSqlByte	指定した列の値を SqlByte として取得します。
	GetSqlDateTime	指定した列の値を SqlDateTime として取得します。
	GetSqlDecimal	指定した列の値を SqlDecimal として取得します。
	GetSqlDouble	指定した列の値を SqlDouble として取得します。
	GetSqlGuid	指定した列の値を SqlGuid として取得します。
	GetSqlInt16	指定した列の値を SqlInt16 として取得します。
	GetSqlInt32	指定した列の値を SqlInt32 として取得します。
	GetSqlInt64	指定した列の値を SqlInt64 として取得します。
	GetSqlMoney	指定した列の値を SqlMoney として取得します。
	GetSqlSingle	指定した列の値を SqlSingle として取得します。
	GetSqlString	指定した列の値を SqlString として取得します。
	GetString	オーバーライドされます。 指定した列の値を文字列として取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetValue	オーバーライドされます。 指定した序数の列の値をネイティブ形式で取得します。
	GetValues	オーバーライドされます。 現在の行のすべての属性列を取得します。
	IsDBNull	オーバーライドされます。 列に格納されている値が存在しない値または欠損値かどうかを示す値を取得します。
	NextResult	オーバーライドされます。 .NET Compact Framework Data Provider for SQL Server Mobile ではサポートされていません。
	Read	オーバーライドされます。 SqlCeDataReader を次のレコードに進めます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Seek	SqlCeDataReader を、指定したパラメータに一致するインデックス値が存在するレコードに配置します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 DbDataReader によって使用されているリソースを解放します。 ( DbDataReader から継承されます。)
	Finalize	オーバーライドされます。
	GetDbDataReader	プロバイダ固有の実装でオーバーライドできる、要求された列の序数の DbDataReader オブジェクトを返します。 ( DbDataReader から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnMove

明示的インターフェイスの実装

	名前	説明
	System.Data.IDataRecord.GetData

参照

関連項目

SqlCeDataReader クラス
System.Data.SqlServerCe 名前空間

SqlCeDataReader メンバ

データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。

SqlCeDataReader データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Depth	オーバーライドされます。 現在の行の入れ子の深さを示す値を取得します。
	FieldCount	オーバーライドされます。 現在の行の列数を取得します。
	HasRows	オーバーライドされます。
	IsClosed	オーバーライドされます。 データ リーダーが閉じているかどうかを示します。
	Item	オーバーロードされます。 オーバーライドされます。 特定の列の値をネイティブ形式で取得します。
	RecordsAffected	オーバーライドされます。 SQL ステートメントによって変更、挿入、または削除された行数を取得します。
	VisibleFieldCount	DbDataReader の非表示ではないフィールドの数を取得します。(DbDataReader から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Close	オーバーライドされます。 SqlCeDataReader オブジェクトを閉じます。
	Dispose	オーバーロードされます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBoolean	オーバーライドされます。 指定した列の値をブール値として取得します。
	GetByte	オーバーライドされます。 指定した列の値をバイトとして取得します。
	GetBytes	オーバーライドされます。 指定した列オフセットからのバイト ストリームを、配列としてバッファに読み込みます。読み込みは、指定したバッファ オフセットから開始されます。
	GetChar	オーバーライドされます。 .NET Compact Framework Data Provider for SQL Server Mobile ではサポートされていません。
	GetChars	オーバーライドされます。 指定した列オフセットからの文字ストリームを、配列としてバッファに読み込みます。読み込みは、指定したバッファ オフセットから開始されます。
	GetData	要求された列の序数の DbDataReader オブジェクトを返します。 (DbDataReader から継承されます。)
	GetDataTypeName	オーバーライドされます。 ソースのデータ型の名前を取得します。
	GetDateTime	オーバーライドされます。 指定した列の値を DateTime オブジェクトとして取得します。
	GetDecimal	オーバーライドされます。 指定した列の値を Decimal オブジェクトとして取得します。
	GetDouble	オーバーライドされます。 指定した列の値を倍精度浮動小数点数値として取得します。
	GetEnumerator	オーバーライドされます。
	GetFieldType	オーバーライドされます。 オブジェクトのデータ型である Type を取得します。
	GetFloat	オーバーライドされます。 指定した列の値を単精度浮動小数点数として取得します。
	GetGuid	オーバーライドされます。 指定した列の値をグローバル一意識別子 (GUID) として取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetInt16	オーバーライドされます。 指定した列の値を 16 ビット符号付き整数として取得します。
	GetInt32	オーバーライドされます。 指定した列の値を 32 ビット符号付き整数として取得します。
	GetInt64	オーバーライドされます。 指定した列の値を 64 ビット符号付き整数として取得します。
	GetName	オーバーライドされます。 指定した列の名前を取得します。
	GetOrdinal	オーバーライドされます。 列の名前を指定して、列の序数を取得します。
	GetProviderSpecificFieldType	オーバーライドされます。
	GetProviderSpecificValue	指定した列の値を Object のインスタンスとして取得します。 (DbDataReader から継承されます。)
	GetProviderSpecificValues	現在の行のコレクション内にあるすべてのプロバイダ固有の属性列を取得します。 (DbDataReader から継承されます。)
	GetSchemaTable	オーバーライドされます。 SqlCeDataReader の列メタデータを記述する DataTable を返します。
	GetSqlBinary	指定した列の値を SqlBinary として取得します。
	GetSqlBoolean	指定した列の値を SqlBoolean として取得します。
	GetSqlByte	指定した列の値を SqlByte として取得します。
	GetSqlDateTime	指定した列の値を SqlDateTime として取得します。
	GetSqlDecimal	指定した列の値を SqlDecimal として取得します。
	GetSqlDouble	指定した列の値を SqlDouble として取得します。
	GetSqlGuid	指定した列の値を SqlGuid として取得します。
	GetSqlInt16	指定した列の値を SqlInt16 として取得します。
	GetSqlInt32	指定した列の値を SqlInt32 として取得します。
	GetSqlInt64	指定した列の値を SqlInt64 として取得します。
	GetSqlMoney	指定した列の値を SqlMoney として取得します。
	GetSqlSingle	指定した列の値を SqlSingle として取得します。
	GetSqlString	指定した列の値を SqlString として取得します。
	GetString	オーバーライドされます。 指定した列の値を文字列として取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetValue	オーバーライドされます。 指定した序数の列の値をネイティブ形式で取得します。
	GetValues	オーバーライドされます。 現在の行のすべての属性列を取得します。
	IsDBNull	オーバーライドされます。 列に格納されている値が存在しない値または欠損値かどうかを示す値を取得します。
	NextResult	オーバーライドされます。 .NET Compact Framework Data Provider for SQL Server Mobile ではサポートされていません。
	Read	オーバーライドされます。 SqlCeDataReader を次のレコードに進めます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Seek	SqlCeDataReader を、指定したパラメータに一致するインデックス値が存在するレコードに配置します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Dispose	オーバーロードされます。 DbDataReader によって使用されているリソースを解放します。 (DbDataReader から継承されます。)
	Finalize	オーバーライドされます。
	GetDbDataReader	プロバイダ固有の実装でオーバーライドできる、要求された列の序数の DbDataReader オブジェクトを返します。 (DbDataReader から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnMove

明示的インターフェイスの実装

	名前	説明
	System.Data.IDataRecord.GetData

参照

関連項目

SqlCeDataReader クラス
System.Data.SqlServerCe 名前空間