XmlMappedRange.Find メソッド

XmlMappedRange コントロールで特定の情報を検索し、その情報が見つかった最初のセルを表す Range を返します。

名前空間:  Microsoft.Office.Tools.Excel
アセンブリ:  Microsoft.Office.Tools.Excel (Microsoft.Office.Tools.Excel.dll 内)

構文

'宣言
Function Find ( _
    What As Object, _
    After As Object, _
    LookIn As Object, _
    LookAt As Object, _
    SearchOrder As Object, _
    SearchDirection As XlSearchDirection, _
    MatchCase As Object, _
    MatchByte As Object, _
    SearchFormat As Object _
) As Range

Range Find(
    Object What,
    Object After,
    Object LookIn,
    Object LookAt,
    Object SearchOrder,
    XlSearchDirection SearchDirection,
    Object MatchCase,
    Object MatchByte,
    Object SearchFormat
)

パラメーター

• What
  型 : System.Object
  検索するデータです。文字列、または Microsoft Office Excel の任意のデータ型を使用できます。

• After
  型 : System.Object
  検索位置を示すセルです。このセルの次から検索が開始されます。これは、ユーザー インターフェイスから検索を行う場合のアクティブ セルの位置に相当します。 After は範囲内の単一のセルである必要があります。検索はこのセルの次から開始されることに注意してください。指定したセル自体が検索されるのは、メソッドがラップしてそのセルに戻ってきたときです。この引数を指定しなかった場合、検索は範囲の左上隅のセルの後から開始されます。

• LookIn
  型 : System.Object
  情報の種類です。

• LookAt
  型 : System.Object
  XlLookAt 値 (xlWhole または xlPart) のどちらかです。

• SearchOrder
  型 : System.Object
  XlSearchOrder 値 (xlByRows または xlByColumns) のどちらかです。

• SearchDirection
  型 : Microsoft.Office.Interop.Excel.XlSearchDirection
  検索の方向です。
  次のいずれかの XlSearchDirection 値です。
  xlNext または xlPrevious。

• MatchCase
  型 : System.Object
  検索で大文字と小文字を区別する場合は true です。既定値 false です。

• MatchByte
  型 : System.Object
  2 バイト言語サポートを選択またはインストールした場合のみ使用します。2 バイト文字を 2 バイト文字にのみ一致させる場合は true。2 バイト文字を、等価な 1 バイト文字に一致させる場合は false。

• SearchFormat
  型 : System.Object
  検索形式です。

戻り値

型 : Microsoft.Office.Interop.Excel.Range
指定した情報が見つかった最初のセルを表す Range を返します。

解説

このメソッドは、一致するものが見つからなかった場合には nullnull 参照 (Visual Basic では Nothing) を返します。

このメソッドは、選択またはアクティブ セルに影響を与えません。

LookIn、LookAt、SearchOrder、および MatchByte の各設定値は、このメソッドを使用するたびに保存されます。これらの引数に値を指定しなかった場合、次回メソッドを呼び出すと、保存されている値が使用されます。これらの引数を設定すると、[検索] ダイアログ ボックスの設定も変更されます。[検索] ダイアログ ボックスの設定を変更すると、引数を省略したときに使用される保存値も変更されます。この問題を避けるには、このメソッドを使用するたびに、これらの引数を明示的に設定します。

FindNext メソッドおよび FindPrevious メソッドを使用すると、検索を繰り返すことができます。

例

次のコード例は、XmlMappedRange の値を文字列 "Smith" に設定し、Find、FindNext、および FindPrevious の各メソッドを使用して、文字列 "Smith" が含まれている最初のセルを検索します。XmlMappedRange に含まれているのは常に 1 つのセルのみなので、毎回同じセルが見つかります。このコード例では、現在のワークシートに CustomerLastNameCell という名前の XmlMappedRange が含まれているものと仮定しています。

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

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);
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

XmlMappedRange インターフェイス

Microsoft.Office.Tools.Excel 名前空間