XmlMappedRange.Find Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menemukan informasi tertentu dalam XmlMappedRange kontrol, dan mengembalikan yang Range mewakili sel pertama tempat informasi tersebut ditemukan.
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
Parameter
- What
- Object
Data yang akan dicari. Bisa berupa string atau tipe data Microsoft Office Excel apa pun.
- After
- Object
Sel setelah anda ingin pencarian dimulai. Ini sesuai dengan posisi sel aktif ketika pencarian dilakukan dari antarmuka pengguna. Perhatikan bahwa After
harus berupa sel tunggal dalam rentang. Ingatlah bahwa pencarian dimulai setelah sel ini; sel yang ditentukan tidak dicari sampai metode membungkus kembali ke sel ini. Jika Anda tidak menentukan argumen ini, pencarian dimulai setelah sel di sudut kiri atas rentang.
- LookIn
- Object
Jenis informasi.
- SearchOrder
- Object
Bisa menjadi salah satu nilai berikut XlSearchOrder : xlByRows atau xlByColumns.
- SearchDirection
- XlSearchDirection
Arah pencarian. Bisa menjadi salah satu nilai berikut XlSearchDirection : xlNext atau xlPrevious.
- MatchCase
- Object
true
untuk membuat kasus pencarian sensitif. Nilai defaultnya adalah false
.
- MatchByte
- Object
Digunakan hanya jika Anda telah memilih atau menginstal dukungan bahasa byte ganda. true
agar karakter byte ganda hanya cocok dengan karakter byte ganda; false
agar karakter byte ganda cocok dengan setara dengan byte tunggal mereka.
- SearchFormat
- Object
Format pencarian.
Mengembalikan
Range yang mewakili sel pertama tempat informasi yang ditentukan ditemukan.
Contoh
Contoh kode berikut menetapkan nilai ke XmlMappedRange string "Smith", lalu menggunakan Findmetode , FindNext, dan FindPrevious untuk menemukan sel pertama dengan string "Smith". XmlMappedRange Karena selalu berisi tepat satu sel, sel yang sama ditemukan di setiap kasus. Contoh kode ini mengasumsikan bahwa lembar kerja saat ini berisi yang XmlMappedRange bernama CustomerLastNameCell
.
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
Keterangan
Metode ini mengembalikan null
jika tidak ada kecocokan yang ditemukan.
Metode ini tidak mempengaruhi pilihan atau sel aktif.
Pengaturan untuk LookIn
, LookAt
, SearchOrder
, dan MatchByte
disimpan setiap kali Anda menggunakan metode ini. Jika Anda tidak menentukan nilai untuk argumen ini, saat berikutnya Anda memanggil metode yang digunakan nilai tersimpan. Mengatur argumen ini mengubah pengaturan dalam kotak dialog Temukan, dan mengubah pengaturan dalam kotak dialog Temukan mengubah nilai tersimpan yang digunakan jika Anda menghilangkan argumen. Untuk menghindari masalah, atur argumen ini secara eksplisit setiap kali Anda menggunakan metode ini.
Anda dapat menggunakan Microsoft.Office.Interop.Excel.Range.FindNext* metode dan FindPrevious untuk mengulangi pencarian.