NamedRange.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 nel controllo NamedRange 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 utilizzato il Find metodo per trovare la prima cella con il valore Seashell in un NamedRange controllo . Nell'esempio vengono quindi utilizzati i FindNext metodi e FindPrevious per trovare la cella successiva con il valore Seashell e quindi tornare alla cella originale. Infine, l'esempio usa il Cut metodo per tagliare il contenuto della prima cella con il valore Seashell e incollarlo nella cella B1.

Questo esempio è relativo a una personalizzazione a livello di documento.

private void FindValue()
{
    this.Range["A1"].Value2 = "Barnacle";
    this.Range["A2"].Value2 = "Seashell";
    this.Range["A3"].Value2 = "Star Fish";
    this.Range["A4"].Value2 = "Seashell";
    this.Range["A5"].Value2 = "Clam Shell";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Find the first occurrence of "Seashell".
    Excel.Range Range1 = namedRange1.Find("Seashell",
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns,
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext,
        false);

    // Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1);

    // Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1);

    // Cut the range with the first "Seashell" and copy it to cell B1.
    Microsoft.Office.Tools.Excel.NamedRange namedRange2 =
        this.Controls.AddNamedRange(Range1, "namedRange2");
    namedRange2.Cut(this.Range["B1"]);
}

Private Sub FindValue()
    Me.Range("A1").Value2 = "Barnacle"
    Me.Range("A2").Value2 = "Seashell"
    Me.Range("A3").Value2 = "Star Fish"
    Me.Range("A4").Value2 = "Seashell"
    Me.Range("A5").Value2 = "Clam Shell"

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Find the first occurrence of "Seashell".
    Dim Range1 As Excel.Range = namedRange1.Find("Seashell", , , _
        Excel.XlLookAt.xlWhole, Excel.XlSearchOrder.xlByColumns, _
        Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, _
        False, False, )

    ' Find the next occurrence of "Seashell".
    Range1 = namedRange1.FindNext(Range1)

    ' Return to the first occurrence of "Seashell".
    Range1 = namedRange1.FindPrevious(Range1)

    ' Cut the range with the first "Seashell" and copy it to cell B1.
    Dim namedRange2 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Range1, "namedRange2")
    namedRange2.Cut(Me.Range("B1"))
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 i valori per questi argomenti la volta successiva che si chiama il metodo, vengono usati 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 FindNext FindPrevious metodi e per ripetere la ricerca.

Quando la ricerca raggiunge la fine dell'intervallo di ricerca specificato, viene eseguito il wrapping fino all'inizio dell'intervallo. Per arrestare una ricerca quando si verifica questo problema, salvare l'indirizzo della prima cella trovata, quindi testare ogni indirizzo di cella trovato successivo rispetto a questo indirizzo salvato.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a

Condividi tramite