Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

String.StartsWith, méthode (String, StringComparison)

Détermine si le début de cette instance de chaîne correspond à la chaîne spécifiée lors d'une comparaison à l'aide de l'option spécifiée.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

[ComVisibleAttribute(false)]
public bool StartsWith(
	string value,
	StringComparison comparisonType
)

Paramètres

value
Type : System.String
Chaîne à comparer.
comparisonType
Type : System.StringComparison
Une des valeurs d'énumération qui détermine le mode de comparaison de cette chaîne et value.

Valeur de retour

Type : System.Boolean
true si cette instance commence par value ; sinon, false.

ExceptionCondition
ArgumentNullException

value a la valeur null.

ArgumentException

comparisonType n'est pas une valeur StringComparison.

La méthode StartsWith compare le paramètre value à la sous-chaîne en début de cette chaîne et retourne une valeur indiquant leur égalité éventuelle. Pour être égale, value doit être une référence à cette même chaîne, être la chaîne vide ("") ou correspondre au début de cette chaîne. Le type de comparaison exécuté par la méthode StartsWith dépend de la valeur du paramètre comparisonType. La comparaison peut utiliser les conventions de la culture actuelle (StringComparison.CurrentCulture et StringComparison.CurrentCultureIgnoreCase) ou la culture indifférente (StringComparison.InvariantCulture et StringComparison.InvariantCultureIgnoreCase), ou il peut se composer d'une comparaison caractère-par-caractère de points de code (StringComparison.Ordinal ou StringComparison.OrdinalIgnoreCase). La comparaison peut également respecter la casse, (StringComparison.CurrentCulture, StringComparison.InvariantCultureou StringComparison.Ordinal) ou il peut ignorer la casse (StringComparison.CurrentCultureIgnoreCase, StringComparison.InvariantCultureIgnoreCase, StringComparison.OrdinalIgnoreCase).

L'exemple suivant détermine si une chaîne commence par une sous-chaîne particulière. Elle initialise un tableau de chaînes à deux dimensions. Le premier élément dans la deuxième dimension contient une chaîne, et le deuxième élément contient la chaîne à rechercher au démarrage de la première chaîne. Les résultats sont affectés par le choix de la culture, le respect ou non de la casse et l'exécution éventuelle d'une comparaison ordinale. Notez que lorsque l'instance de chaîne contient une ligature, les comparaisons dépendantes de la culture avec ses caractères consécutifs correspondent parfaitement.


using System;

public class Example
{
   public static void Main()
   {
      string[,] strings = { {"ABCdef", "abc" },                    
                            {"ABCdef", "abc" },  
                            {"œil","oe" },
                            { "læring}", "lae" } };
      for (int ctr1 = strings.GetLowerBound(0); ctr1 <= strings.GetUpperBound(0); ctr1++)
      {
            foreach (string cmpName in Enum.GetNames(typeof(StringComparison)))
            { 
               StringComparison strCmp = (StringComparison) Enum.Parse(typeof(StringComparison), 
                                                      cmpName);
               string instance = strings[ctr1, 0];
               string value = strings[ctr1, 1];
               Console.WriteLine("{0} starts with {1}: {2} ({3} comparison)", 
                                 instance, value, 
                                 instance.StartsWith(value, strCmp), 
                                 strCmp); 
            }
            Console.WriteLine();   
      }   
   }
}
// The example displays the following output:
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       œil starts with oe: True (CurrentCulture comparison)
//       œil starts with oe: True (CurrentCultureIgnoreCase comparison)
//       œil starts with oe: True (InvariantCulture comparison)
//       œil starts with oe: True (InvariantCultureIgnoreCase comparison)
//       œil starts with oe: False (Ordinal comparison)
//       œil starts with oe: False (OrdinalIgnoreCase comparison)
//       
//       læring} starts with lae: True (CurrentCulture comparison)
//       læring} starts with lae: True (CurrentCultureIgnoreCase comparison)
//       læring} starts with lae: True (InvariantCulture comparison)
//       læring} starts with lae: True (InvariantCultureIgnoreCase comparison)
//       læring} starts with lae: False (Ordinal comparison)
//       læring} starts with lae: False (OrdinalIgnoreCase comparison)


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

Afficher:
© 2014 Microsoft