String.TrimEnd Metoda

Definicja

Namespace:

System

Zestawów:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
TrimEnd()	Usuwa wszystkie końcowe znaki odstępu z bieżącego ciągu.
TrimEnd(Char)	Usuwa wszystkie końcowe wystąpienia znaku z bieżącego ciągu.
TrimEnd(Char[])	Usuwa wszystkie końcowe wystąpienia zestawu znaków określonych w tablicy z bieżącego ciągu.

TrimEnd()

Źródło:

String.Manipulation.cs

Usuwa wszystkie końcowe znaki odstępu z bieżącego ciągu.

public:
 System::String ^ TrimEnd();

public string TrimEnd();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich znaków odstępu na końcu bieżącego ciągu. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Uwagi

Metoda TrimEnd usuwa z bieżącego ciągu wszystkie końcowe znaki odstępu. Operacja przycinania zatrzymuje się, gdy na końcu ciągu napotkany jest pierwszy znak bez odstępu. Jeśli na przykład bieżący ciąg to " abc xyz ", TrimEnd metoda zwraca wartość " abc xyz".

Nuta

TrimEnd Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie końcowe znaki odstępu są usuwane z bieżącego ciągu.

TrimEnd(Char)

Źródło:

String.Manipulation.cs

Usuwa wszystkie końcowe wystąpienia znaku z bieżącego ciągu.

public:
 System::String ^ TrimEnd(char trimChar);

public string TrimEnd(char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (trimChar As Char) As String

Parametry

trimChar

Char

Znak Unicode do usunięcia.

Zwraca

String

Ciąg, który pozostaje po usunięciu wszystkich wystąpień trimChar znaku z końca bieżącego ciągu. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Uwagi

Metoda TrimEnd(System.Char) usuwa z bieżącego ciągu wszystkie znaki końcowe trimChar . Operacja przycinania zatrzymuje się, gdy pierwszy znak, który nie trimChar jest napotkany na końcu ciągu. Jeśli na przykład trimChar wartość to i - bieżący ciąg to "---abc---xyz----", TrimEnd(System.Char) metoda zwraca wartość "---abc---xyz".

Nuta

TrimEnd(System.Char) Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie trimChar końcowe znaki są usuwane z bieżącego ciągu.

TrimEnd(Char[])

Źródło:

String.Manipulation.cs

Usuwa wszystkie końcowe wystąpienia zestawu znaków określonych w tablicy z bieżącego ciągu.

public:
 System::String ^ TrimEnd(... cli::array <char> ^ trimChars);

public string TrimEnd(params char[]? trimChars);

member this.TrimEnd : char[] -> string

Public Function TrimEnd (ParamArray trimChars As Char()) As String

Parametry

trimChars

Char[]

Tablica znaków Unicode do usunięcia lub null.

Zwraca

String

Ciąg, który pozostaje po wszystkich wystąpieniach znaków w parametrze trimChars , zostanie usunięty z końca bieżącego ciągu. Jeśli trimChars jest null lub pusta tablica, zamiast tego zostaną usunięte znaki odstępu Unicode. Jeśli nie można przyciąć znaków z bieżącego wystąpienia, metoda zwraca bieżące wystąpienie bez zmian.

Przykłady

W poniższym przykładzie pokazano, jak można użyć TrimEnd(System.Char[]) metody do przycinania białych znaków lub znaków interpunkcyjnych z końca ciągu.

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

Uwagi

Metoda TrimEnd(System.Char[]) usuwa z bieżącego ciągu wszystkie znaki końcowe, które znajdują się w parametrze trimChars . Operacja przycinania zatrzymuje się, gdy pierwszy znak, który nie znajduje się na trimChars końcu ciągu. Jeśli na przykład bieżący ciąg to "123abc456xyz789" i trimChars zawiera cyfry z "1" do "9", TrimEnd(System.Char[]) metoda zwraca wartość "123abc456xyz".

Nuta

TrimEnd(System.Char[]) Jeśli metoda usunie wszelkie znaki z bieżącego wystąpienia, ta metoda nie modyfikuje wartości bieżącego wystąpienia. Zamiast tego zwraca nowy ciąg, w którym wszystkie końcowe znaki znalezione w trimChars pliku są usuwane z bieżącego ciągu.

Notatki dla dzwoniących

Program .NET Framework 3.5 z dodatkiem SP1 i starsze wersje obsługuje wewnętrzną listę znaków odstępów, które ta metoda przycina, jeśli trimChars jest null lub jest pusta tablica. Począwszy od programu .NET Framework 4, jeśli trimChars jest to null lub pusta tablica, metoda przycina wszystkie znaki odstępu Unicode (czyli znaki, które generują wartość zwracaną true po przekazaniu IsWhiteSpace(Char) ich do metody). Ze względu na Trim() tę zmianę metoda w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach usuwa dwa znaki, zero WIDTH SPACE (U+200B) i ZERO WIDTH NO-BREAK SPACE (U+FEFF), że Trim() metoda w programie .NET Framework 4 i nowszych wersjach nie zostanie usunięta. Ponadto Trim() metoda w programie .NET Framework 3.5 SP1 i wcześniejszych wersjach nie przycina trzech znaków odstępów Unicode: SEPARATOR VOWEL MONGOLIAN (U+180E), NARROW NO-BREAK SPACE (U+202F) i ŚREDNIEJ PRZESTRZENI MATEMATYCZNEJ (U+205F).

Zobacz także

• Char
• Trim(Char[])
• TrimStart(Char[])
• IsWhiteSpace(Char)