Seek 메서드

SqlCeDataReader.Seek 메서드

지정된 매개 변수와 일치하는 인덱싱된 값을 가진 레코드에 SqlCeDataReader를 적용합니다.

네임스페이스:  System.Data.SqlServerCe
어셈블리:  System.Data.SqlServerCe(System.Data.SqlServerCe.dll)

[SecurityCriticalAttribute]
[SecurityTreatAsSafeAttribute]
[SecurityPermissionAttribute(SecurityAction.Assert, UnmanagedCode = true)]
public bool Seek(
	DbSeekOptions dbSeekOptions,
	params Object[] index
)

매개 변수

dbSeekOptions
유형: System.Data.SqlServerCe.DbSeekOptions
사용할 DbSeekOptions입니다.
index
유형: System.Object[]
레코드의 인덱스입니다.

반환 값

유형: System.Boolean
부울 값. true는 커서가 행에 있음을 나타냅니다.

예외조건
SqlCeException

값을 찾을 수 없거나 다른 오류가 발생한 경우

이 메서드를 사용하면 SELECT 문을 사용하는 경우보다 빠르게 기본 테이블의 행을 검색할 수 있습니다. Seek를 사용하면 SELECT 문에서 WHERE 절을 사용하는 경우보다 인덱스 값을 기반으로 행을 보다 빠르게 검색할 수 있습니다. 예를 들어, 직원 ID가 5인 직원을 검색하려면 SELECT 문을 실행할 수도 있지만 직원 ID 인덱스 값 5와 함께 Seek를 사용하면 매우 효과적입니다.

SeekCommandTypeTableDirect로 설정되고, CommandText가 유효한 기본 테이블 이름으로 설정되며, IndexName이 지정된 기본 테이블의 유효한 인덱스 이름으로 설정된 경우에만 사용할 수 있습니다.

Seek를 사용한 다음에는 SqlCeDataReader가 인덱스 순서에 따라 나머지 행을 반환합니다. SetRange로 지정된 범위를 가진 SqlCeDataReader에서 Seek를 사용하면 Seek는 해당 범위 안에 있는 행만 찾습니다. 자세한 내용은 OLE DB 설명서의 "IRowsetIndex::Seek" 항목을 참조하십시오.

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


표시:
© 2016 Microsoft