NamedRange.Find Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Recherche des informations spécifiques dans le contrôle NamedRange, puis retourne un objet Range qui représente la première cellule contenant ces informations.

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

Paramètres

What: Object

Données à rechercher. Il peut s'agir d'une chaîne ou de tout type de données Microsoft Office Excel.

After: Object

Cellule dans laquelle vous voulez commencer la recherche. Cela correspond à la position de la cellule active lorsqu'une recherche est effectuée à partir de l'interface utilisateur. Notez qu’il After doit s’agir d’une seule cellule dans la plage. Souvenez-vous que la recherche commence après cette cellule ; la cellule spécifiée ne fait pas l'objet d'une recherche tant que la méthode n'est pas revenue à cette cellule. Si vous ne spécifiez pas d'argument, la recherche commence après la cellule située dans l'angle supérieur gauche de la plage.

LookIn: Object

Type d'informations.

LookAt: Object

Il peut s'agir de l'une des valeurs XlLookAt suivantes : xlWhole ou xlPart.

SearchOrder: Object

Il peut s'agir de l'une des valeurs XlSearchOrder suivantes : xlByRows ou xlByColumns.

SearchDirection: XlSearchDirection

Sens de la recherche. Il peut s’agir de l’une des valeurs suivantes XlSearchDirection : xlNext ou xlPrevious.

MatchCase: Object

true si la recherche doit respecter la casse. La valeur par défaut est false.

MatchByte: Object

Utilisé uniquement si vous avez sélectionné ou installé la prise en charge linguistique de jeux de caractères codés sur deux octets. true pour que les caractères codés sur deux octets correspondent uniquement à des caractères codés sur deux octets ; false pour que les caractères codés sur deux octets correspondent aux caractères codés sur un octet équivalents.

SearchFormat: Object

Format de recherche.

Retours

Range

Objet Range qui représente la première cellule contenant les informations.

Exemples

L’exemple de code suivant utilise la Find méthode pour rechercher la première cellule avec la valeur Seashell dans un NamedRange contrôle. L’exemple utilise ensuite les FindNext méthodes et FindPrevious pour rechercher la cellule suivante avec la valeur Seashell , puis revenir à la cellule d’origine. Enfin, l’exemple utilise la Cut méthode pour couper le contenu de la première cellule avec la valeur Seashell et le coller dans la cellule B1.

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

Cette méthode retourne null si aucune correspondance n’est trouvée.

Cette méthode n’affecte pas la sélection ou la cellule active.

Les paramètres de LookIn, LookAt, SearchOrderet MatchByte sont enregistrés chaque fois que vous utilisez cette méthode. Si vous ne spécifiez pas de valeurs pour ces arguments la prochaine fois que vous appelez la méthode, les valeurs enregistrées sont utilisées. La définition de ces arguments modifie les paramètres de la boîte de dialogue Rechercher, et la modification des paramètres de la boîte de dialogue Rechercher modifie les valeurs enregistrées utilisées si vous omettez les arguments. Pour éviter les problèmes, définissez ces arguments explicitement chaque fois que vous utilisez cette méthode.

Vous pouvez utiliser les FindNext méthodes et FindPrevious pour répéter la recherche.

Lorsque la recherche atteint la fin de la plage de recherche spécifiée, elle est encapsulée au début de la plage. Pour arrêter une recherche lorsque ce wraparound se produit, enregistrez l’adresse de la première cellule trouvée, puis testez chaque adresse de cellule trouvée successive par rapport à cette adresse enregistrée.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à