Metodo XmlMappedRange.Find

  • Articolo

Trova informazioni specifiche in un controllo XmlMappedRange e restituisce un oggetto Range che rappresenta la prima cella nella quale sono state trovate le informazioni.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • What
    Tipo: System.Object
    Dati da cercare.Può essere una stringa o qualsiasi tipo di dati di Microsoft Office Excel.
  • After
    Tipo: System.Object
    Cella dopo la quale si desidera iniziare la ricerca.Corrisponde alla posizione della cella attiva quando una ricerca viene eseguita dall'interfaccia utente.Il parametro After deve essere una singola cella nell'intervallo.Tenere presente che la ricerca viene avviata dopo questa cella. La ricerca verrà eseguita nella cella specificata solo quando il metodo completerà il ciclo e tornerà a questa cella.Se non si specifica questo argomento, la ricerca verrà avviata dopo la cella nell'angolo superiore sinistro dell'intervallo.
  • MatchCase
    Tipo: System.Object
    true per rilevare la distinzione tra maiuscole e minuscole durante la ricerca.Il valore predefinito è false.
  • MatchByte
    Tipo: System.Object
    Utilizzato solo se è stato selezionato o installato il supporto per caratteri DBCS (Double-Byte Character Set). true affinché i caratteri DBCS corrispondano solo a caratteri DBCS; false affinché i caratteri DBCS corrispondano agli equivalenti caratteri SBCS.

Valore restituito

Tipo: Microsoft.Office.Interop.Excel.Range
Oggetto Range che rappresenta la prima cella in cui vengono trovate le informazioni specificate.

Note

Il metodo restituisce nullriferimento null (Nothing in Visual Basic) se non viene trovata alcuna corrispondenza.

Questo metodo non influisce sulla selezione o sulla cella attiva.

Le impostazioni dei parametri LookIn, LookAt, SearchOrder e MatchByte vengono salvate ogni volta che si utilizza questo metodo.Se non si specificano i valori per questi argomenti, per la successiva chiamata al metodo saranno utilizzati i valori salvati.L'impostazione di questi argomenti implica la modifica delle impostazioni nella finestra di dialogo Trova. La modifica delle impostazioni in questa finestra implica la modifica dei valori salvati che vengono utilizzati se questi argomenti vengono omessi.Per evitare problemi, impostare questi argomenti in modo esplicito ogni volta che si utilizza questo metodo.

È possibile utilizzare i metodi FindNext e FindPrevious per ripetere la ricerca.

Esempi

Nell'esempio di codice riportato di seguito il valore di un controllo XmlMappedRange viene impostato su una stringa "Smith". Vengono quindi utilizzati i metodi Find, FindNext e FindPrevious per trovare la prima cella contenente la stringa "Smith".Poiché un controllo XmlMappedRange contiene sempre un'unica cella, la stessa cella viene trovata in ciascun caso.Nell'esempio si presuppone che il foglio di lavoro corrente contenga un controllo XmlMappedRange denominato CustomerLastNameCell.

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

XmlMappedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel