Partager via

XmlMappedRange.Find, méthode

  • Article

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.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
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
)

Paramètres

  • What
    Type : System.Object
    Données à rechercher.Il peut s'agir d'une chaîne ou de tout type de données Microsoft Office Excel.
  • After
    Type : System.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 que After doit être une cellule unique de 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.
  • MatchCase
    Type : System.Object
    true si la recherche doit respecter la casse.La valeur par défaut est false.
  • MatchByte
    Type : System.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.

Valeur de retour

Type : Microsoft.Office.Interop.Excel.Range
Range qui représente la première cellule contenant les informations spécifiées.

Notes

Cette méthode retourne nullune référence null (Nothing en Visual Basic) 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, SearchOrder et MatchByte sont enregistrés chaque fois que vous utilisez cette méthode.Si vous ne spécifiez pas de valeurs pour ces arguments, les valeurs enregistrées sont utilisées lors du prochain appel à la méthode.La définition de ces arguments modifie les paramètres de la boîte de dialogue Recherche, et la modification des paramètres dans la boîte de dialogue Recherche modifie les valeurs enregistrées qui sont utilisées si vous omettez les arguments.Pour éviter tout problème, définissez explicitement ces arguments chaque fois que vous utilisez cette méthode.

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

Exemples

L'exemple de code suivant affecte la valeur de chaîne " Smith " à XmlMappedRange, puis utilise les méthodes Find, FindNext et FindPrevious pour rechercher la première cellule contenant la chaîne " Smith ".Dans la mesure où XmlMappedRange contient exactement une cellule, la même cellule est trouvée dans chaque cas.Cet exemple de code suppose que la feuille de calcul active contient un contrôle XmlMappedRange nommé 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);
}

Sécurité .NET Framework

Voir aussi

Référence

XmlMappedRange Interface

Microsoft.Office.Tools.Excel, espace de noms