DbSeekOptions Enumeration

Artikel
01/14/2011

Optionen, die angeben, wie die Seek-Methode in einem Index sucht.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration DbSeekOptions

[FlagsAttribute] 
public enum DbSeekOptions

[FlagsAttribute] 
public enum class DbSeekOptions

/** @attribute FlagsAttribute() */ 
public enum DbSeekOptions

FlagsAttribute 
public enum DbSeekOptions

Member

Membername	Beschreibung
After	Wechselt in der Reihenfolge des Indexes zur ersten Zeile nach dem Suchwert, die Werte enthält.
AfterEqual	Wechselt zur letzten übereinstimmenden Zeile im Index. Wechselt in der Reihenfolge des Index zur ersten Zeile nach dem Suchwert, die Werte enthält, wenn keine übereinstimmenden Zeilen vorhanden sind.
Before	Wechselt in der Reihenfolge des Indexes zur letzten Zeile vor dem Suchwert, die Werte enthält.
BeforeEqual	Wechselt zur ersten übereinstimmenden Zeile im Index. Wechselt in der Reihenfolge des Index zur letzten Zeile vor dem Suchwert, die Werte enthält, wenn keine übereinstimmenden Zeilen vorhanden sind.
FirstEqual	Wechselt in der Reihenfolge des Indexes zur ersten übereinstimmenden Zeile im Index.
LastEqual	Wechselt in der Reihenfolge des Indexes zur letzten übereinstimmenden Zeile im Index.

Beispiel

In diesem Beispiel wird die Option FirstEqual für die Seek-Operation im Index angegeben.

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

Plattformen

Entwicklungsplattformen

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
Versionsinformationen
.NET Framework und NET Compact Framework
Unterstützt in 3.5
.NET Framework
Unterstützt in 3.0
.NET Compact Framework und .Net Framework
Unterstützt in 2.0

Siehe auch

Verweis

System.Data.SqlServerCe Namespace

Share via