String.Contains Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

Contains(String, StringComparison)	Retourne une valeur qui indique si la chaîne spécifiée se trouve dans cette chaîne, en utilisant les règles de comparaison spécifiées.
Contains(Char, StringComparison)	Retourne une valeur qui indique si le caractère spécifié se trouve dans cette chaîne, en utilisant les règles de comparaison spécifiées.
Contains(String)	Retourne une valeur qui indique si la sous-chaîne spécifiée apparaît dans cette chaîne.
Contains(Char)	Retourne une valeur qui indique si le caractère spécifié se trouve dans cette chaîne.

Contains(String, StringComparison)

Source:

String.Searching.cs

Retourne une valeur qui indique si la chaîne spécifiée se trouve dans cette chaîne, en utilisant les règles de comparaison spécifiées.

C#

public bool Contains (string value, StringComparison comparisonType);

Paramètres

value

String

Chaîne à rechercher.

comparisonType

StringComparison

Une des valeurs d'énumération qui spécifie les règles à utiliser dans la comparaison.

Retours

Boolean

true si le paramètre value apparaît dans cette chaîne, ou si value est la chaîne vide ("") ; sinon, false.

Contains(Char, StringComparison)

Source:

String.Searching.cs

Retourne une valeur qui indique si le caractère spécifié se trouve dans cette chaîne, en utilisant les règles de comparaison spécifiées.

C#

public bool Contains (char value, StringComparison comparisonType);

Paramètres

value

Char

Caractère à rechercher.

comparisonType

StringComparison

Une des valeurs d'énumération qui spécifie les règles à utiliser dans la comparaison.

Retours

Boolean

true si le paramètre value se trouve dans cette chaîne ; sinon, false.

Contains(String)

Source:

String.Searching.cs

Retourne une valeur qui indique si la sous-chaîne spécifiée apparaît dans cette chaîne.

C#

public bool Contains (string value);

Paramètres

value

String

Chaîne à rechercher.

Retours

Boolean

true si le paramètre value apparaît dans cette chaîne, ou si value est la chaîne vide ("") ; sinon, false.

Exceptions

ArgumentNullException

value a la valeur null.

Exemples

L’exemple suivant détermine si la chaîne « fox » est une sous-chaîne d’une citation familière. Si « fox » se trouve dans la chaîne, elle affiche également sa position de départ.

C#

string s1 = "The quick brown fox jumps over the lazy dog";
string s2 = "fox";
bool b = s1.Contains(s2);
Console.WriteLine("'{0}' is in the string '{1}': {2}",
                s2, s1, b);
if (b) {
    int index = s1.IndexOf(s2);
    if (index >= 0)
        Console.WriteLine("'{0} begins at character position {1}",
                      s2, index + 1);
}
// This example displays the following output:
//    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
//    'fox begins at character position 17

Remarques

Cette méthode effectue une comparaison ordinale (respectant la casse et ne respectant pas la culture). La recherche commence à la première position de caractère de cette chaîne et se poursuit jusqu’à la dernière position de caractère.

Pour effectuer une comparaison respectant la culture ou la casse ordinale :

• Sur .NET Core 2.1 et versions ultérieures : appelez plutôt la Contains(String, StringComparison) surcharge.

• Sur .NET Framework : Create une méthode personnalisée. L’exemple suivant illustre une telle approche. Il définit une méthode d’extension String qui inclut un StringComparison paramètre et indique si une chaîne contient une sous-chaîne lors de l’utilisation de la forme spécifiée de comparaison de chaînes.

C#

using System;

public static class StringExtensions
{
   public static bool Contains(this String str, String substring, 
                               StringComparison comp)
   {                            
        if (substring == null)
            throw new ArgumentNullException("substring", 
                                         "substring cannot be null.");
        else if (! Enum.IsDefined(typeof(StringComparison), comp))
            throw new ArgumentException("comp is not a member of StringComparison",
                                     "comp");

        return str.IndexOf(substring, comp) >= 0;                      
   }
}

C#

String s = "This is a string.";
String sub1 = "this";
Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1);
StringComparison comp = StringComparison.Ordinal;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

comp = StringComparison.OrdinalIgnoreCase;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

// The example displays the following output:
//       Does 'This is a string.' contain 'this'?
//          Ordinal: False
//          OrdinalIgnoreCase: True

Si vous êtes intéressé par la position de la sous-chaîne value dans le instance actuel, vous pouvez appeler la IndexOf méthode pour obtenir la position de départ de sa première occurrence, ou vous pouvez appeler la LastIndexOf méthode pour obtenir la position de départ de sa dernière occurrence. L’exemple inclut un appel à la IndexOf(String) méthode si une sous-chaîne se trouve dans une chaîne instance.

Voir aussi

• IndexOf(Char)
• LastIndexOf(String)

Contains(Char)

Source:

String.Searching.cs

Retourne une valeur qui indique si le caractère spécifié se trouve dans cette chaîne.

C#

public bool Contains (char value);

Paramètres

value

Char

Caractère à rechercher.

Retours

Boolean

true si le paramètre value se trouve dans cette chaîne ; sinon, false.

Remarques

Cette méthode effectue une comparaison ordinale (respectant la casse et ne respectant pas la culture).