XmlMappedRange.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 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ü.
- 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 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ı CustomerLastNameCell
bir 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
, SearchOrder
ve MatchByte
ayarları LookIn
kaydedilir. 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.