String.Remove Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Retourne une nouvelle chaîne dans laquelle un nombre spécifié de caractères de la chaîne actuelle est supprimé.

Surcharges

Nom Description
Remove(Int32, Int32)

Retourne une nouvelle chaîne dans laquelle un nombre spécifié de caractères dans l’instance actuelle commençant à une position spécifiée a été supprimé.
Remove(Int32)

Retourne une nouvelle chaîne dans laquelle tous les caractères de l’instance actuelle, commençant à une position spécifiée et continuant jusqu’à la dernière position, ont été supprimés.

Remove(Int32, Int32)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Retourne une nouvelle chaîne dans laquelle un nombre spécifié de caractères dans l’instance actuelle commençant à une position spécifiée a été supprimé.

public:
 System::String ^ Remove(int startIndex, int count);
public string Remove(int startIndex, int count);
member this.Remove : int * int -> string
Public Function Remove (startIndex As Integer, count As Integer) As String

Paramètres

startIndex
Int32

Position de base zéro pour commencer à supprimer des caractères.

count
Int32

Nombre de caractères à supprimer.

Retours

String

Nouvelle chaîne équivalente à cette instance, à l’exception des caractères supprimés.

Exceptions

ArgumentOutOfRangeException

Soit startIndex est inférieur à count zéro.

- ou -

startIndex plus count spécifiez une position en dehors de cette instance.

Exemples

L’exemple suivant montre comment supprimer le prénom d’un nom complet.

using System;

public class RemoveTest
{
    public static void Main()
    {

        string name = "Michelle Violet Banks";

        Console.WriteLine("The entire name is '{0}'", name);

        // Remove the middle name, identified by finding the spaces in the name.
        int foundS1 = name.IndexOf(" ");
        int foundS2 = name.IndexOf(" ", foundS1 + 1);

        if (foundS1 != foundS2 && foundS1 >= 0)
        {
            name = name.Remove(foundS1 + 1, foundS2 - foundS1);

            Console.WriteLine("After removing the middle name, we are left with '{0}'", name);
        }
    }
}
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'

let name = "Michelle Violet Banks"

printfn $"The entire name is '{name}'"

// Remove the middle name, identified by finding the spaces in the name.
let foundS1 = name.IndexOf " "
let foundS2 = name.IndexOf(" ", foundS1 + 1)

if foundS1 <> foundS2 && foundS1 >= 0 then
    let name = name.Remove(foundS1 + 1, foundS2 - foundS1)

    printfn $"After removing the middle name, we are left with '{name}'"
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'

Public Class RemoveTest
    
    Public Shared Sub Main()
        Dim name As String = "Michelle Violet Banks"
                
        Console.WriteLine("The entire name is '{0}'", name)
        Dim foundS1 As Integer = name.IndexOf(" ")
        Dim foundS2 As Integer = name.IndexOf(" ", foundS1 + 1)
        If foundS1 <> foundS2 And foundS1 >= 0 Then
            
            ' remove the middle name, identified by finding the spaces in the middle of the name...    
            name = name.Remove(foundS1 + 1, foundS2 - foundS1)
            
            Console.WriteLine("After removing the middle name, we are left with '{0}'", name)
        End If
    End Sub
End Class 
' The example displays the following output:
'       The entire name is 'Michelle Violet Banks'
'       After removing the middle name, we are left with 'Michelle Banks'

Remarques

Dans l’infrastructure .NET, les chaînes sont basées sur zéro. La valeur du startIndex paramètre peut aller de zéro à une valeur inférieure à la longueur de l’instance de chaîne.

Note

Cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle le nombre de caractères spécifié par le count paramètre a été supprimé. Les caractères sont supprimés à la position spécifiée par startIndex.

Voir aussi

S’applique à

Remove(Int32)

Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs
Source:
String.Manipulation.cs

Retourne une nouvelle chaîne dans laquelle tous les caractères de l’instance actuelle, commençant à une position spécifiée et continuant jusqu’à la dernière position, ont été supprimés.

public:
 System::String ^ Remove(int startIndex);
public string Remove(int startIndex);
member this.Remove : int -> string
Public Function Remove (startIndex As Integer) As String

Paramètres

startIndex
Int32

Position de base zéro pour commencer à supprimer des caractères.

Retours

String

Nouvelle chaîne équivalente à cette chaîne, à l’exception des caractères supprimés.

Exceptions

ArgumentOutOfRangeException

startIndex est inférieur à zéro.

- ou -

startIndex est supérieur à la longueur de cette instance.

Exemples

L’exemple suivant illustre la Remove méthode. Le cas suivant supprime tout le texte à partir de l’index spécifié jusqu’à la fin de la chaîne. Le dernier cas supprime trois caractères à partir de l’index spécifié.

// This example demonstrates the String.Remove() method.
using System;

class Sample
{
    public static void Main()
    {
        string s = "abc---def";

        Console.WriteLine("Index: 012345678");
        Console.WriteLine("1)     {0}", s);
        Console.WriteLine("2)     {0}", s.Remove(3));
        Console.WriteLine("3)     {0}", s.Remove(3, 3));
    }
}
/*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*/

// This example demonstrates the String.Remove() method.
let s = "abc---def"

printfn "Index: 012345678"
printfn $"1)     {s}"
printfn $"2)     {s.Remove 3}"
printfn $"3)     {s.Remove(3, 3)}"
(*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*)

' This example demonstrates the String.Remove() method.
Class Sample
   Public Shared Sub Main()
      Dim s As String = "abc---def"
      '
      Console.WriteLine("Index: 012345678")
      Console.WriteLine("1)     {0}", s)
      Console.WriteLine("2)     {0}", s.Remove(3))
      Console.WriteLine("3)     {0}", s.Remove(3, 3))
   End Sub
End Class
'
'This example produces the following results:
'
'Index: 012345678
'1)     abc---def
'2)     abc
'3)     abcdef
'

Remarques

Dans l’infrastructure .NET, les chaînes sont basées sur zéro. La valeur du startIndex paramètre peut être comprise entre zéro et la longueur de l’instance de chaîne.

Note

Cette méthode ne modifie pas la valeur de l’instance actuelle. Au lieu de cela, elle retourne une nouvelle chaîne dans laquelle tous les caractères de position startIndex à la fin de la chaîne d’origine ont été supprimés.

Voir aussi

S’applique à