SqlCeCommand.SetRange 方法
限制 SqlCeDataReader 将读取的行集。
命名空间: System.Data.SqlServerCe
程序集: System.Data.SqlServerCe(在 System.Data.SqlServerCe.dll 中)
语法
声明
Public Sub SetRange ( _
dbRangeOptions As DbRangeOptions, _
startData As Object(), _
endData As Object() _
)
用法
Dim instance As SqlCeCommand
Dim dbRangeOptions As DbRangeOptions
Dim startData As Object()
Dim endData As Object()
instance.SetRange(dbRangeOptions, startData, _
endData)
public void SetRange(
DbRangeOptions dbRangeOptions,
Object[] startData,
Object[] endData
)
public:
void SetRange(
DbRangeOptions dbRangeOptions,
array<Object^>^ startData,
array<Object^>^ endData
)
member SetRange :
dbRangeOptions:DbRangeOptions *
startData:Object[] *
endData:Object[] -> unit
public function SetRange(
dbRangeOptions : DbRangeOptions,
startData : Object[],
endData : Object[]
)
参数
- dbRangeOptions
类型:System.Data.SqlServerCe.DbRangeOptions
指定范围时使用的选项。
- startData
类型:array<System.Object[]
范围的起始键值。
- endData
类型:array<System.Object[]
范围的结束键值。
异常
异常 | 条件 |
---|---|
InvalidOperationException | 尚未设置 IndexName 属性。 |
注释
此方法可用于代替 SELECT 语句,能够以更快的速度从基表中检索行集。可以不在 SELECT 语句中使用 WHERE 子句,而使用 SetRange 来基于行的索引值迅速检索行集。例如,要检索雇员 ID 在 1 到 5 之间的一组雇员,可以执行 SELECT 语句,但如果将雇员 ID 索引范围设置为 1 至 5,则将大大提高性能。
只有当将 CommandType 设置为 TableDirect,将 CommandText 设置为有效基表名称,并将 IndexName 设置为指定基表中的有效索引名称时,才可以使用此方法。当使用 SetRange 时,从 ExecuteReader 返回的 SqlCeDataReader 将只返回指定索引中的键值符合该范围的那些行。
在指定了范围的 SqlCeDataReader 上使用 Seek 时,Seek 将只搜索指定范围内的行。有关 SetRange 的详细信息,请参阅 OLE DB 文档中的“IRowsetIndex::SetRange”主题。
示例
下面的示例使用 SqlCeDataReader 的索引从顺序表检索数据。对其执行 Seek 操作的索引范围是由 SetRange 方法指定的。
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);
}