XmlMappedRange.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 un contrôle XmlMappedRange et retourne un Range qui représente la première cellule qui comprend 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

Range qui représente la première cellule contenant les informations spécifiées.

Exemples

L’exemple de code suivant définit la valeur d’un XmlMappedRange sur la chaîne « Smith », puis utilise les Findméthodes , FindNextet FindPrevious pour rechercher la première cellule avec la chaîne « Smith ». Étant donné qu’un XmlMappedRange contient toujours exactement une cellule, la même cellule est trouvée dans chaque cas. Cet exemple de code part du principe que la feuille de calcul actuelle contient un XmlMappedRange nommé 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

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 Microsoft.Office.Interop.Excel.Range.FindNext* méthodes et FindPrevious pour répéter la recherche.

S’applique à

Partager via