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.Substring méthode (Int32)

 

Récupère une sous-chaîne de cette instance. La sous-chaîne commence à une position de caractère spécifiée et continue jusqu'à la fin de la chaîne.

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

public string Substring(
	int startIndex
)

Paramètres

startIndex
Type: System.Int32

Position de caractère de départ de base zéro d'une sous-chaîne dans cette instance.

Valeur de retour

Type: System.String

Chaîne équivalente à la sous-chaîne qui commence à startIndex dans cette instance ou Empty si startIndex est égal à la longueur de cette instance.

Exception Condition
ArgumentOutOfRangeException

startIndex est inférieur à zéro ou supérieur à la longueur de cette instance.

Vous appelez le Substring méthode pour extraire une sous-chaîne d’une chaîne qui commence à une position de caractère spécifiée et se termine à la fin de la chaîne. La position de caractère de début est de base zéro ; en d’autres termes, le premier caractère dans la chaîne est à l’index 0, pas l’index 1. Pour extraire une sous-chaîne qui commence à une position de caractère spécifiée et se termine avant à la fin de la chaîne, appelez le Substring (méthode).

System_CAPS_noteRemarque

Cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, il retourne une nouvelle chaîne qui commence à la startIndex position dans la chaîne actuelle.

Pour extraire une sous-chaîne qui commence par un caractère particulier ou d’une séquence de caractères, appeler une méthode telle que IndexOf ou IndexOf pour obtenir la valeur de startIndex. Le deuxième exemple illustre cela ; Il extrait une valeur de clé qui commence à une position de caractère après le caractère « = ».

Si startIndex est égal à zéro, la méthode retourne la chaîne d’origine est inchangée.

L’exemple suivant montre comment obtenir une sous-chaîne à partir d’une chaîne.

using System;

public class SubStringTest {
    public static void Main() {
        string [] info = { "Name: Felica Walker", "Title: Mz.", 
                           "Age: 47", "Location: Paris", "Gender: F"};
        int found = 0;

        Console.WriteLine("The initial values in the array are:");
        foreach (string s in info)
            Console.WriteLine(s);

        Console.WriteLine("\nWe want to retrieve only the key information. That is:");        
        foreach (string s in info) {
            found = s.IndexOf(": ");
            Console.WriteLine("   {0}", s.Substring(found + 2));
        }
    }
}
// The example displays the following output:
//       The initial values in the array are:
//       Name: Felica Walker
//       Title: Mz.
//       Age: 47
//       Location: Paris
//       Gender: F
//       
//       We want to retrieve only the key information. That is:
//          Felica Walker
//          Mz.
//          47
//          Paris
//          F

L’exemple suivant utilise le Substring (méthode) pour séparer les paires clé/valeur qui sont délimitées par une est égal à (« = ») de caractères.

using System;

public class Example
{
   public static void Main()
   {
      String[] pairs = { "Color1=red", "Color2=green", "Color3=blue",
                         "Title=Code Repository" };
      foreach (var pair in pairs) {
         int position = pair.IndexOf("=");
         if (position < 0)
            continue;
         Console.WriteLine("Key: {0}, Value: '{1}'", 
                           pair.Substring(0, position),
                           pair.Substring(position + 1));
      }                          
   }
}
// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

The M:System.String.IndexOf(System.String) method is used to get the position of the equals character in the string.. The call to the M:System.String.Substring(System.Int32,System.Int32) method extracts the key name., which starts from the first character in the string and extends for the number of characters returned by the call to the M:System.String.IndexOf(System.String) method. The call to the M:System.String.Substring(System.Int32) method then extracts the value assigned to the key. It starts at one character position beyond the equals character and extends to the end of the string.

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: