XmlMappedRange.Find Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.dll

Denetimdeki XmlMappedRange belirli bilgileri bulur ve bu bilgilerin bulunduğu ilk hücreyi temsil eden bir Range döndürür.

public Microsoft.Office.Interop.Excel.Range Find (object What, object After, object LookIn, object LookAt, object SearchOrder, Microsoft.Office.Interop.Excel.XlSearchDirection SearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, object MatchCase, object MatchByte, object SearchFormat);

abstract member Find : obj * obj * obj * obj * obj * Microsoft.Office.Interop.Excel.XlSearchDirection * obj * obj * obj -> Microsoft.Office.Interop.Excel.Range

Public Function Find (What As Object, Optional After As Object, Optional LookIn As Object, Optional LookAt As Object, Optional SearchOrder As Object, Optional SearchDirection As XlSearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, Optional MatchCase As Object, Optional MatchByte As Object, Optional SearchFormat As Object) As Range

Parametreler

What

Object

Aranacak veriler. Bir dize veya herhangi bir Microsoft Office Excel veri türü olabilir.

After

Object

Aramanın başlamasını istediğiniz hücre. Bu, kullanıcı arabiriminden bir arama yapıldığında etkin hücrenin konumuna karşılık gelir. After Aralıkta tek bir hücre olması gerektiğini unutmayın. Aramanın bu hücreden sonra başlayacağını unutmayın. Yöntem, bu hücreye geri sarana kadar belirtilen hücre aranmaz. Bu bağımsız değişkeni belirtmezseniz, arama aralığın sol üst köşesindeki hücreden sonra başlar.

LookIn

Object

Bilgi türü.

LookAt

Object

Aşağıdaki XlLookAt değerlerden biri olabilir: xlWhole veya xlPart.

SearchOrder

Object

Aşağıdaki XlSearchOrder değerlerden biri olabilir: xlByRows veya xlByColumns.

SearchDirection

XlSearchDirection

Arama yönü. Aşağıdaki XlSearchDirection değerlerden biri olabilir: xlNext veya xlPrevious.

MatchCase

Object

true arama büyük/küçük harfe duyarlı hale getirmek için. false varsayılan değerdir.

MatchByte

Object

Yalnızca çift bayt dil desteğini seçtiyseniz veya yüklediyseniz kullanılır. true çift baytlı karakterlerin yalnızca çift baytlı karakterlerle eşleşmesini sağlamak için; false çift baytlı karakterlerin tek bayt eşdeğerleriyle eşleşmesini sağlamak için.

SearchFormat

Object

Arama biçimi.

Döndürülenler

Range

Range Belirtilen bilgilerin bulunduğu ilk hücreyi temsil eden bir.

Örnekler

Aşağıdaki kod örneği değerini XmlMappedRange "Smith" dizesine ayarlar ve ardından , FindNextve FindPrevious yöntemlerini kullanarak Find"Smith" dizesine sahip ilk hücreyi bulur. Bir XmlMappedRange her zaman tam olarak bir hücre içerdiğinden, her durumda aynı hücre bulunur. Bu kod örneği, geçerli çalışma sayfasının adlı CustomerLastNameCellbir XmlMappedRange içerdiğini varsayar.

private void FindSmith()
{
    this.CustomerLastNameCell.Value2 = "Smith";

    // Use Find to get the range with "Smith".
    Excel.Range range1 = this.CustomerLastNameCell.Find("Smith",
        Excel.XlSearchDirection.xlNext);
    string address1 = range1.get_Address(missing, missing,
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("Find method found the range: " + address1);

    // Use FindNext to get the range with "Smith".
    Excel.Range range2 = this.CustomerLastNameCell.FindNext(range1);
    string address2 = range2.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindNext method found the range: " + address2);

    // Use FindPrevious to get the range with "Smith".
    Excel.Range range3 = this.CustomerLastNameCell.FindPrevious(range2);
    string address3 = range3.get_Address(
        Excel.XlReferenceStyle.xlA1);
    MessageBox.Show("FindPrevious method found the range: " + address3);
}

Private Sub FindSmith()
    Me.CustomerLastNameCell.Value2 = "Smith"

    ' Use Find to get the range with "Smith".
    Dim range1 As Excel.Range = Me.CustomerLastNameCell.Find( _
        "Smith", SearchDirection:=Excel.XlSearchDirection.xlNext)
    Dim address1 As String = range1.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("Find method found the range: " & address1)

    ' Use FindNext to get the range with "Smith".
    Dim range2 As Excel.Range = Me.CustomerLastNameCell.FindNext(range1)
    Dim address2 As String = range2.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindNext method found the range: " & address2)

    ' Use FindPrevious to get the range with "Smith".
    Dim range3 As Excel.Range = Me.CustomerLastNameCell.FindPrevious(range2)
    Dim address3 As String = range3.Address(ReferenceStyle:=Excel.XlReferenceStyle.xlA1)
    MsgBox("FindPrevious method found the range: " & address3)
End Sub

Açıklamalar

Eşleşme bulunmazsa bu yöntem döndürür null .

Bu yöntem, seçimi veya etkin hücreyi etkilemez.

Bu yöntemi her kullandığınızda , LookAt, SearchOrderve MatchByte ayarları LookInkaydedilir. Bu bağımsız değişkenler için değer belirtmezseniz, yöntemini bir sonraki çağırışınızda kaydedilen değerler kullanılır. Bu bağımsız değişkenlerin ayarlanması Bul iletişim kutusundaki ayarları değiştirir ve Bul iletişim kutusundaki ayarların değiştirilmesi, bağımsız değişkenleri atlarsanız kullanılan kaydedilmiş değerleri değiştirir. Sorunları önlemek için, bu yöntemi her kullanışınızda söz konusu bağımsız değişkenleri açıkça ayarlayın.

Aramayı yinelemek Microsoft.Office.Interop.Excel.Range.FindNext* için ve FindPrevious yöntemlerini kullanabilirsiniz.