DbRangeOptions 列挙体

シークするインデックスの範囲を指定する場合は、SetRange メソッドで使用するオプションを指定します。

この列挙体には、メンバー値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

名前空間:  System.Data.SqlServerCe
アセンブリ:  System.Data.SqlServerCe (System.Data.SqlServerCe.dll)

構文

'宣言
<FlagsAttribute> _
Public Enumeration DbRangeOptions
'使用
Dim instance As DbRangeOptions

[FlagsAttribute]
public enum DbRangeOptions

[FlagsAttribute]
public enum class DbRangeOptions

[<FlagsAttribute>]
type DbRangeOptions

public enum DbRangeOptions

メンバー

	メンバー名	説明
	InclusiveStart	範囲に startData 値を含めます。
	InclusiveEnd	範囲に endData 値を含めます。
	ExclusiveStart	範囲から startData 値を除外します。
	ExclusiveEnd	範囲から endData 値を除外します。
	ExcludeNulls	範囲から nullNULL 参照 (Visual Basic では Nothing) 値を除外します。
	Prefix	インデックス値が startData の値で始まる範囲を指定します。Prefix オプションを使用する場合は、endData を nullNULL 参照 (Visual Basic では Nothing) に設定する必要があります。
	Match	インデックス値と startData の値が一致する範囲を指定します。Match オプションを使用する場合は、endData を nullNULL 参照 (Visual Basic では Nothing) に設定する必要があります。
	Default	InclusiveStart フラグと InclusiveEnd フラグの両方を設定するのと同じです。

説明

Match オプションまたは Prefix オプションを指定する場合、endData 値は nullNULL 参照 (Visual Basic では Nothing) にする必要があります。

Match オプションと ExcludeNulls オプションを組み合わせることはできません。

使用例

この例では、SetRange メソッドを呼び出すときに、インデックスに対する Seek 操作の範囲オプションが InclusiveStart または InclusiveEnd として指定されています。

        Try
            Dim conn As New SqlCeConnection("Data Source = MyDatabase.sdf")
            conn.Open()

            Dim cmd As SqlCeCommand = conn.CreateCommand()
            cmd.CommandType = CommandType.TableDirect
            cmd.IndexName = "Orders_PK"
            cmd.CommandText = "Orders"

            ' We are interested in orders that match Order ID = 10020
            '
            cmd.SetRange(DbRangeOptions.Match, New Object() {10020}, Nothing)

            Dim reader As SqlCeDataReader = cmd.ExecuteReader(CommandBehavior.Default)

            While reader.Read()
                MessageBox.Show(String.Format("{0} ; {1}", reader("Order ID"), reader("Order Date")))
            End While

            ' Now we are interested in orders with Order ID between (10020, 10050)
            '
            cmd.SetRange(DbRangeOptions.InclusiveStart Or DbRangeOptions.InclusiveEnd, New Object() {10020}, New Object() {10050})

            reader = cmd.ExecuteReader(CommandBehavior.Default)

            ' Now seek to Order ID = 10045
            '
            Dim onRow As Boolean =  reader.Seek(DbSeekOptions.FirstEqual, New Object() {10045})

            ' Now ,the reader will return rows with Order ID >= 10045 <= 10050
            ' because the range was set to (10020, 10050)
            '
            If onRow Then
                While reader.Read()
                    MessageBox.Show(String.Format("{0} ; {1}", reader("Order ID"), reader("Order Date")))
                End While
            End If
        Catch e As Exception
            MessageBox.Show(e.Message)
        End Try

        try
        {
            SqlCeConnection conn = new SqlCeConnection("Data Source = MyDatabase.sdf");
            conn.Open();

            SqlCeCommand cmd = conn.CreateCommand();
            cmd.CommandType = CommandType.TableDirect;
            cmd.IndexName = "Orders_PK";
            cmd.CommandText = "Orders";

            // We are interested in orders that match Order ID = 10020
            //
            cmd.SetRange(DbRangeOptions.Match, new object[] { 10020 }, null);

            SqlCeDataReader reader = cmd.ExecuteReader(CommandBehavior.Default);

            for (int i = 1; reader.Read(); i++)
            {
                MessageBox.Show(String.Format("{0} ; {1}", reader["Order ID"], reader["Order Date"]));
            }

            // Now we are interested in orders with Order ID between (10020, 10050)
            //
            cmd.SetRange(DbRangeOptions.InclusiveStart | DbRangeOptions.InclusiveEnd,
                new object[] { 10020 }, new object[] { 10050 });

            reader = cmd.ExecuteReader(CommandBehavior.Default);

            // Now seek to Order ID = 10045
            //
            bool onRow = reader.Seek(DbSeekOptions.FirstEqual, new object[] { 10045 });

            // Now ,the reader will return rows with Order ID >= 10045 <= 10050
            // because the range was set to (10020, 10050)
            //
            if (onRow)
            {
                for (int i = 1; reader.Read(); i++)
                {
                    MessageBox.Show(String.Format("{0} ; {1}", reader["Order ID"], reader["Order Date"]));
                }
            }
        }
        catch (Exception e)
        {
            MessageBox.Show(e.Message);
        }

関連項目

参照

System.Data.SqlServerCe 名前空間