String.Remove Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Gibt eine neue Zeichenfolge zurück, in der eine angegebene Anzahl von Zeichen aus der aktuellen Zeichenfolge gelöscht wird.

Überlädt

Name Beschreibung
Remove(Int32, Int32)

Gibt eine neue Zeichenfolge zurück, in der eine angegebene Anzahl von Zeichen in der aktuellen Instanz beginnend an einer angegebenen Position gelöscht wurde.
Remove(Int32)

Gibt eine neue Zeichenfolge zurück, in der alle Zeichen in der aktuellen Instanz, beginnend an einer angegebenen Position und fortsetzen durch die letzte Position, gelöscht wurden.

Remove(Int32, Int32)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, in der eine angegebene Anzahl von Zeichen in der aktuellen Instanz beginnend an einer angegebenen Position gelöscht wurde.

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

Parameter

startIndex
Int32

Die nullbasierte Position, um mit dem Löschen von Zeichen zu beginnen.

count
Int32

Die Anzahl der zu löschenden Zeichen.

Gibt zurück

String

Eine neue Zeichenfolge, die dieser Instanz entspricht, mit Ausnahme der entfernten Zeichen.

Ausnahmen

ArgumentOutOfRangeException

Entweder startIndex oder count ist kleiner als Null.

-oder-

startIndex und count geben Sie eine Position außerhalb dieser Instanz an.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie den zweiten Namen aus einem vollständigen Namen entfernen können.

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'

Hinweise

Im .NET Framework sind Zeichenfolgen nullbasiert. Der Wert des startIndex Parameters kann von Null bis 1 kleiner als die Länge der Zeichenfolgeninstanz liegen.

Note

Diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der die Anzahl der zeichen, die durch den count Parameter angegeben wurden, entfernt wurden. Die Zeichen werden an der durch startIndex.

Weitere Informationen

Gilt für:

Remove(Int32)

Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs
Quelle:
String.Manipulation.cs

Gibt eine neue Zeichenfolge zurück, in der alle Zeichen in der aktuellen Instanz, beginnend an einer angegebenen Position und fortsetzen durch die letzte Position, gelöscht wurden.

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

Parameter

startIndex
Int32

Die nullbasierte Position, um mit dem Löschen von Zeichen zu beginnen.

Gibt zurück

String

Eine neue Zeichenfolge, die dieser Zeichenfolge entspricht, mit Ausnahme der entfernten Zeichen.

Ausnahmen

ArgumentOutOfRangeException

startIndex ist kleiner als 0 (null).

-oder-

startIndex ist größer als die Länge dieser Instanz.

Beispiele

Im folgenden Beispiel wird die Remove Methode veranschaulicht. Im nächsten bis letzten Fall wird der gesamte Text vom angegebenen Index bis zum Ende der Zeichenfolge entfernt. Im letzten Fall werden drei Zeichen entfernt, die aus dem angegebenen Index beginnen.

// 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
'

Hinweise

Im .NET Framework sind Zeichenfolgen nullbasiert. Der Wert des startIndex Parameters kann zwischen Null und Länge der Zeichenfolgeninstanz liegen.

Note

Diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle Zeichen von der Position startIndex bis zum Ende der ursprünglichen Zeichenfolge entfernt wurden.

Weitere Informationen

Gilt für: