NamedRange.Find Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.dll

Denetimdeki NamedRange belirli bilgileri bulur ve bu bilgilerin bulunduğu ilk hücreyi temsil eden bir Range nesne 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 aramasını 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 Bilgilerin bulunduğu ilk hücreyi temsil eden nesne.

Örnekler

Aşağıdaki kod örneği, bir denetimdeki FindNamedRange değere Seashell sahip ilk hücreyi bulmak için yöntemini kullanır. Örnek daha sonra değeri Seashell içeren FindNext bir sonraki hücreyi bulmak ve ardından özgün hücreye dönmek için ve FindPrevious yöntemlerini kullanır. Son olarak, örnek, ilk hücrenin içeriğini değerle Seashell kesmek ve B1 hücresine yapıştırmak için yöntemini kullanırCut.

Bu örnek, belge düzeyinde özelleştirme içindir

private void FindValue()
{
    this.Range["A1"].Value2 = "Barnacle";
    this.Range["A2"].Value2 = "Seashell";
    this.Range["A3"].Value2 = "Star Fish";
    this.Range["A4"].Value2 = "Seashell";
    this.Range["A5"].Value2 = "Clam Shell";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell",
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1"]);
}

Private Sub FindValue()
    Me.Range("A1").Value2 = "Barnacle"
    Me.Range("A2").Value2 = "Seashell"
    Me.Range("A3").Value2 = "Star Fish"
    Me.Range("A4").Value2 = "Seashell"
    Me.Range("A5").Value2 = "Clam Shell"

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Find the first occurrence of "Seashell".
    Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
        False, False, )

    ' Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1)

    ' Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1)

    ' Cut the range with the first "Seashell" and copy it to cell B1.
    Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Range1, "namedRange2")
    namedRange2.Cut(Me.Range("B1"))
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. Yöntemi bir sonraki çağırışınızda bu bağımsız değişkenler için değer belirtmezseniz 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 FindNext için ve FindPrevious yöntemlerini kullanabilirsiniz.

Arama belirtilen arama aralığının sonuna ulaştığında, aralığın başına doğru kaydırılır. Bu metin çevresinde kaydırma işlemi oluştuğunda aramayı durdurmak için, ilk bulunan hücrenin adresini kaydedin ve bulunan her ardışık hücre adresini kaydedilen bu adresle sınayın.

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümleri'nde İsteğe Bağlı Parametreler.