Énumération DbSeekOptions

Article
05/27/2011

Options qui spécifient comment la méthode Seek effectuera une recherche sur un index.

Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs membres.

Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
<FlagsAttribute> _
Public Enumeration DbSeekOptions
'Utilisation
Dim instance As DbSeekOptions

[FlagsAttribute]
public enum DbSeekOptions

[FlagsAttribute]
public enum class DbSeekOptions

[<FlagsAttribute>]
type DbSeekOptions

public enum DbSeekOptions

Membres

	Nom de membre	Description
	FirstEqual	Avance jusqu'à la première ligne correspondante (dans l'ordre d'index) de l'index.
	LastEqual	Avance jusqu'à la dernière ligne correspondante (dans l'ordre d'index) de l'index.
	AfterEqual	Avance jusqu'à la dernière ligne correspondante de l'index. À défaut de ligne correspondante, avance jusqu'à la première ligne contenant des valeurs après la valeur de recherche, dans l'ordre d'index.
	After	Avance jusqu'à la première ligne contenant des valeurs (dans l'ordre d'index) après la valeur de recherche.
	BeforeEqual	Avance jusqu'à la première ligne correspondante de l'index. À défaut de ligne correspondante, avance jusqu'à la dernière ligne contenant des valeurs avant la valeur de recherche, dans l'ordre d'index.
	Before	Avance jusqu'à la dernière ligne contenant des valeurs (dans l'ordre d'index) avant la valeur de recherche.

Exemples

Dans cet exemple, l'option FirstEqual est spécifiée pour l'opération Seek sur l'index.

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

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe

Share via