Freigeben über


String.TrimEnd Methode

Definition

Überlädt

TrimEnd()

Entfernt alle nachfolgenden Leerzeichen aus der aktuellen Zeichenfolge.

TrimEnd(Char)

Entfernt alle nachfolgenden Vorkommen eines Zeichens aus der aktuellen Zeichenfolge.

TrimEnd(Char[])

Entfernt alle nachfolgenden Vorkommen einer Reihe von Zeichen, die in einem Array angegeben sind, aus der aktuellen Zeichenfolge.

TrimEnd(ReadOnlySpan<Char>)

Entfernt alle nachfolgenden Vorkommen einer Reihe von Zeichen, die in einer Spanne von der aktuellen Zeichenfolge angegeben sind.

TrimEnd()

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

Entfernt alle nachfolgenden Leerzeichen aus der aktuellen Zeichenfolge.

public:
 System::String ^ TrimEnd();
public string TrimEnd ();
member this.TrimEnd : unit -> string
Public Function TrimEnd () As String

Gibt zurück

Die Zeichenfolge, die verbleibt, nachdem alle Leerzeichen am Ende der aktuellen Zeichenfolge entfernt wurden. Wenn keine Zeichen von der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Hinweise

Die TrimEnd -Methode entfernt aus der aktuellen Zeichenfolge alle nachfolgenden Leerzeichen. Der Kürzungsvorgang wird beendet, wenn das erste Nicht-Leerzeichen am Ende der Zeichenfolge gefunden wird. Wenn die aktuelle Zeichenfolge beispielsweise "abc xyz" lautet, gibt die TrimEnd-Methode "abc xyz" zurück.

Anmerkung

Wenn die TrimEnd-Methode Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle nachfolgenden Leerzeichen aus der aktuellen Zeichenfolge entfernt werden.

Gilt für:

TrimEnd(Char)

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

Entfernt alle nachfolgenden Vorkommen eines Zeichens aus der aktuellen Zeichenfolge.

public:
 System::String ^ TrimEnd(char trimChar);
public string TrimEnd (char trimChar);
member this.TrimEnd : char -> string
Public Function TrimEnd (trimChar As Char) As String

Parameter

trimChar
Char

Ein zu entfernenes Unicode-Zeichen.

Gibt zurück

Die Zeichenfolge, die nach allen Vorkommen des trimChar Zeichens verbleibt, wird vom Ende der aktuellen Zeichenfolge entfernt. Wenn keine Zeichen von der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Hinweise

Die TrimEnd(System.Char)-Methode entfernt alle nachfolgenden trimChar Zeichen aus der aktuellen Zeichenfolge. Der Kürzungsvorgang wird beendet, wenn das erste Zeichen, das nicht trimChar ist, am Ende der Zeichenfolge gefunden wird. Wenn trimChar beispielsweise - ist und die aktuelle Zeichenfolge "---abc---xyz----" lautet, gibt die TrimEnd(System.Char)-Methode "---abc---xyz" zurück.

Anmerkung

Wenn die TrimEnd(System.Char)-Methode Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle nachfolgenden trimChar Zeichen aus der aktuellen Zeichenfolge entfernt werden.

Gilt für:

TrimEnd(Char[])

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

Entfernt alle nachfolgenden Vorkommen einer Reihe von Zeichen, die in einem Array angegeben sind, aus der aktuellen Zeichenfolge.

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);
public string TrimEnd (params char[] trimChars);
public string TrimEnd (params char[]? trimChars);
member this.TrimEnd : char[] -> string
Public Function TrimEnd (ParamArray trimChars As Char()) As String

Parameter

trimChars
Char[]

Ein Array von Unicode-Zeichen, die entfernt werden sollen, oder null.

Gibt zurück

Die Zeichenfolge, die nach allen Vorkommen der Zeichen im parameter trimChars verbleibt, wird vom Ende der aktuellen Zeichenfolge entfernt. Wenn trimCharsnull oder ein leeres Array ist, werden stattdessen Unicode-Leerzeichen entfernt. Wenn keine Zeichen von der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die TrimEnd(System.Char[])-Methode verwenden können, um Leerzeichen oder Satzzeichen am Ende einer Zeichenfolge zu kürzen.

string sentence = "The dog had a bone, a ball, and other toys.";
char[] charsToTrim = {',', '.', ' '};
string[] words = sentence.Split();
foreach (string word in words)
   Console.WriteLine(word.TrimEnd(charsToTrim));

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys
let sentence = "The dog had a bone, a ball, and other toys."
let charsToTrim = [| ','; '.'; ' ' |]
let words = sentence.Split()
for word in words do
    printfn $"{word.TrimEnd charsToTrim}"

// The example displays the following output:
//       The
//       dog
//       had
//       a
//       bone
//       a
//       ball
//       and
//       other
//       toys
Module TrimEnd
   Public Sub Main()
      Dim sentence As String = "The dog had a bone, a ball, and other toys."
      Dim charsToTrim() As Char = {","c, "."c, " "c}
      Dim words() As String = sentence.Split()
      For Each word As String In words
         Console.WriteLine(word.TrimEnd(charsToTrim))
      Next
   End Sub
End Module
' The example displays the following output:
'       The
'       dog
'       had
'       a
'       bone
'       a
'       ball
'       and
'       other
'       toys

Hinweise

Die TrimEnd(System.Char[])-Methode entfernt aus der aktuellen Zeichenfolge alle nachfolgenden Zeichen, die sich im trimChars-Parameter befinden. Der Kürzungsvorgang wird beendet, wenn das erste Zeichen, das sich nicht in trimChars befindet, am Ende der Zeichenfolge gefunden wird. Wenn die aktuelle Zeichenfolge beispielsweise "123abc456xyz789" lautet und trimChars die Ziffern von "1" bis "9" enthält, gibt die TrimEnd(System.Char[])-Methode "123abc456xyz" zurück.

Anmerkung

Wenn die TrimEnd(System.Char[])-Methode Zeichen aus der aktuellen Instanz entfernt, ändert diese Methode nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der alle nachfolgenden Zeichen in trimChars aus der aktuellen Zeichenfolge entfernt werden.

Hinweise für Aufrufer

In .NET Framework 3.5 SP1 und früheren Versionen wird eine interne Liste von Leerzeichen verwaltet, die von dieser Methode gekürzt werden, wenn trimCharsnull oder ein leeres Array ist. Ab .NET Framework 4 werden bei trimCharsnull oder einem leeren Array alle Unicode-Leerzeichen gekürzt (d. h. Zeichen, die einen true Rückgabewert erzeugen, wenn sie an die IsWhiteSpace(Char) Methode übergeben werden). Aufgrund dieser Änderung entfernt die Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen zwei Zeichen, NULL WIDTH SPACE (U+200B) und NULL WIDTH NO-BREAK SPACE (U+FEFF), die die Trim()-Methode in .NET Framework 4 und höheren Versionen nicht entfernt. Darüber hinaus werden mit der Trim()-Methode in .NET Framework 3.5 SP1 und früheren Versionen drei Unicode-Leerzeichen nicht gekürzt: MONGOLN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F) und MITTLERE MATHEMATISCHE LEERZEICHEN (U+205F).

Weitere Informationen

Gilt für:

TrimEnd(ReadOnlySpan<Char>)

Entfernt alle nachfolgenden Vorkommen einer Reihe von Zeichen, die in einer Spanne von der aktuellen Zeichenfolge angegeben sind.

public:
 System::String ^ TrimEnd(ReadOnlySpan<char> trimChars);
public string TrimEnd (scoped ReadOnlySpan<char> trimChars);
member this.TrimEnd : ReadOnlySpan<char> -> string
Public Function TrimEnd (trimChars As ReadOnlySpan(Of Char)) As String

Parameter

trimChars
ReadOnlySpan<Char>

Eine Spanne von Unicode-Zeichen, die entfernt werden sollen.

Gibt zurück

Die Zeichenfolge, die nach allen Vorkommen von Zeichen im trimChars-Parameter verbleibt, wird vom Ende der aktuellen Zeichenfolge entfernt. Wenn trimChars leer ist, werden stattdessen Leerzeichen entfernt. Wenn keine Zeichen von der aktuellen Instanz gekürzt werden können, gibt die Methode die aktuelle Instanz unverändert zurück.

Gilt für: