XmlMappedRange.Find Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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

Parametri

What: Object

Dati da cercare. Può essere una stringa o qualsiasi tipo di dati di Microsoft Office Excel.

After: Object

Cella dopo la quale si desidera iniziare la ricerca. Corrisponde alla posizione della cella attiva quando una ricerca viene eseguita dall'interfaccia utente. Si noti che 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.

LookIn: Object

Tipo di informazioni.

LookAt: Object

Può essere uno dei seguenti valori di XlLookAt: xlWhole o xlPart.

SearchOrder: Object

Può essere uno dei seguenti valori di XlSearchOrder: xlByRows o xlByColumns.

SearchDirection: XlSearchDirection

Direzione di ricerca. Può essere uno dei valori seguenti XlSearchDirection : xlNext o xlPrevious.

MatchCase: Object

true per rilevare la distinzione tra maiuscole e minuscole durante la ricerca. Il valore predefinito è false.

MatchByte: 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.

SearchFormat: Object

Formato della ricerca.

Restituisce

Range

Oggetto Range che rappresenta la prima cella in cui vengono trovate le informazioni specificate.

Esempio

Nell'esempio di codice seguente viene impostato il valore di un oggetto sulla XmlMappedRange stringa "Smith", quindi vengono utilizzati i Find FindNext metodi, e FindPrevious per trovare la prima cella con la stringa "Smith". Poiché un oggetto XmlMappedRange contiene sempre esattamente una cella, viene rilevata la stessa cella in ogni caso. In questo esempio di codice si presuppone che il foglio di codice corrente contenga un oggetto XmlMappedRange denominato 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

Commenti

Questo metodo restituisce null se non viene trovata alcuna corrispondenza.

Questo metodo non influisce sulla selezione o sulla cella attiva.

Le impostazioni per LookIn , LookAt , SearchOrder e MatchByte vengono salvate ogni volta che si utilizza questo metodo. Se non si specificano valori per questi argomenti, alla successiva chiamata al metodo verranno utilizzati i valori salvati. L'impostazione di questi argomenti modifica le impostazioni nella finestra di dialogo Trova e modificando le impostazioni nella finestra di dialogo Trova vengono modificati i valori salvati utilizzati se si omettono gli argomenti. Per evitare problemi, impostare in modo esplicito questi argomenti ogni volta che si usa questo metodo.

È possibile utilizzare i Microsoft.Office.Interop.Excel.Range.FindNext*FindPrevious metodi e per ripetere la ricerca.

Si applica a

Condividi tramite