SqlCeCommand.IndexName 属性
指定要打开的索引。
命名空间: System.Data.SqlServerCe
程序集: System.Data.SqlServerCe（在 system.data.sqlserverce.dll 中）
语法
声明
Public Property IndexName As String
用法
Dim instance As SqlCeCommand
Dim value As String
value = instance.IndexName
instance.IndexName = value
public string IndexName { get; set; }
public:
property String^ IndexName {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_IndexName ()
/** @property */
public void set_IndexName (String value)
public function get IndexName () : String
public function set IndexName (value : String)
不适用。
属性值
要打开的索引的名称。
备注
IndexName 使 SqlCeDataReader 能够按照指定索引中的行顺序从基表中检索行。这样就可以在不使用 SELECT 语句的情况下按顺序检索行。例如，要使用雇员 ID 检索雇员，客户端可以执行 SELECT * FROM Employees ORDER BY EmployeeID，但如果使用 IndexName 属性从索引进行读取，则可以更快地返回结果。只有 CommandType 设置为 BaseTable 且 CommandText 设置为包含指定索引的有效基表，才可以对一个命令使用该属性。
如果使用 IndexName 属性从索引中检索行，则将按索引顺序从基表中检索所有行。若要对返回的行施加限制，应使用 SetRange；若要在索引中查找特定的值，应使用 Seek。
示例
下面的示例打开一个基表，并使用索引来快速从指定的范围检索值。
Dim cmd As SqlCeCommand = conn.CreateCommand()
cmd.CommandType = CommandType.TableDirect
' This is the name of the base table
'
cmd.CommandText = "Orders"
'Assume: Index contains three columns [int, datetime, money]
'
cmd.IndexName = "SomeIndex"
Dim start(2) As Object
Dim [end](0) As Object
start(0) = 1
start(1) = New SqlDateTime(1996, 1, 1)
start(2) = New SqlMoney(10.0)
[end](0) = 5
cmd.SetRange(DbRangeOptions.InclusiveStart Or DbRangeOptions.InclusiveEnd, start, [end])
Dim rdr As SqlCeDataReader = cmd.ExecuteReader()
rdr.Seek(DbSeekOptions.AfterEqual, 1, New SqlDateTime(1997, 1, 1), New SqlMoney(10.5))
While rdr.Read()
' Read data the usual way
'
End While
rdr.Close()
SqlCeCommand cmd = conn.CreateCommand();
cmd.CommandType = CommandType.TableDirect;
// This is the name of the base table
//
cmd.CommandText = "Orders";
//Assume: Index contains three columns [int, datetime, money]
//
cmd.IndexName = "SomeIndex";
object[] start = new object[3];
object[] end = new object[1];
start[0] = 1;
start[1] = new SqlDateTime(1996, 1, 1);
start[2] = new SqlMoney(10.00);
end[0] = 5;
cmd.SetRange(DbRangeOptions.InclusiveStart | DbRangeOptions.InclusiveEnd, start, end);
SqlCeDataReader rdr = cmd.ExecuteReader();
rdr.Seek(DbSeekOptions.AfterEqual, 1, new SqlDateTime(1997, 1, 1), new SqlMoney(10.50));
while (rdr.Read())
{
// Read data the usual way
//
}
rdr.Close();
平台
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。
版本信息
.NET Framework
受以下版本支持：3.0
.NET Compact Framework
受以下版本支持：2.0、1.0