NamedRange.Find Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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ü.
- 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 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
, SearchOrder
ve MatchByte
ayarları LookIn
kaydedilir. 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.