Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

String.StartsWith méthode (String)

 

Date de publication : novembre 2016

Détermine si le début de cette instance de chaîne correspond à la chaîne spécifiée.

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

public bool StartsWith(
	string value
)

Paramètres

value
Type: System.String

Chaîne à comparer.

Valeur de retour

Type: System.Boolean

true si value correspond au début de cette instance ; sinon, false.

Exception Condition
ArgumentNullException

value a la valeur null.

Cette méthode compare value à la sous-chaîne au début de cette instance est la même longueur que valueet retourne une indication si elles sont égales. Pour être égale, value doit être une chaîne vide (String.Empty), doit être une référence à cette même instance ou correspondre au début de cette instance.

Cette méthode effectue une comparaison de mots (respectant la casse et dépendante de la culture) à l’aide de la culture actuelle.

Remarques à l’attention des appelants :

Comme expliqué dans Meilleures pratiques pour l'utilisation de chaînes dans le .NET Framework, nous vous recommandons d’éviter d’appeler des méthodes de comparaison de chaînes qui substituent des valeurs par défaut et à la place appellent des méthodes qui requièrent des paramètres spécifiés explicitement. Pour déterminer si une chaîne commence par une sous-chaîne particulière en utilisant les règles de comparaison de la culture actuelle, appelez la StartsWith(String, StringComparison) avec une valeur de la surcharge de méthode StringComparison.CurrentCulture pour son comparisonType paramètre.

L’exemple suivant définit un StripStartTags méthode qui utilise le StartsWith(String) balises de début de méthode pour supprimer le code HTML à partir du début d’une chaîne. Notez que le StripStartTags méthode est appelée pour vous assurer que plusieurs balises de début HTML au début de la ligne sont supprimés de manière récursive. L’exemple ne supprime pas les balises HTML incorporés dans une chaîne.

using System;

public class Example 
{
   public static void Main() {
      string [] strSource = { "<b>This is bold text</b>", "<H1>This is large Text</H1>",
                "<b><i><font color=green>This has multiple tags</font></i></b>",
                "<b>This has <i>embedded</i> tags.</b>",
                "<This line simply begins with a lesser than symbol, it should not be modified" };

      // Display the initial string array.
      Console.WriteLine("The original strings:");
      Console.WriteLine("---------------------");
      foreach (var s in strSource)
         Console.WriteLine(s);
      Console.WriteLine();

      Console.WriteLine("Strings after starting tags have been stripped:");
      Console.WriteLine("-----------------------------------------------");

      // Display the strings with starting tags removed.
     foreach (var s in strSource)
        Console.WriteLine(StripStartTags(s));
   }

   private static string StripStartTags(string item) 
   {
      // Determine whether a tag begins the string.
      if (item.Trim().StartsWith("<")) {
         // Find the closing tag.
         int lastLocation = item.IndexOf( ">" );
         // Remove the tag.
         if (lastLocation >= 0) {
            item =  item.Substring( lastLocation + 1 );

            // Remove any additional starting tags.
            item = StripStartTags(item);
         }   
      }

      return item;
   }
}
// The example displays the following output:
//    The original strings:
//    ---------------------
//    <b>This is bold text</b>
//    <H1>This is large Text</H1>
//    <b><i><font color = green>This has multiple tags</font></i></b>
//    <b>This has <i>embedded</i> tags.</b>
//    <This line simply begins with a lesser than symbol, it should not be modified
//    
//    Strings after starting tags have been stripped:
//    -----------------------------------------------
//    This is bold text</b>
//    This is large Text</H1>
//    This has multiple tags</font></i></b>
//    This has <i>embedded</i> tags.</b>
//    <This line simply begins with a lesser than symbol, it should not be modified

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: