String.TrimEnd Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Przeciążenia

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ślonego 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ąć żadnych 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 inny niż biały. Jeśli na przykład bieżący ciąg to " abc xyz ", TrimEnd metoda zwraca wartość " abc xyz".

Uwaga

TrimEnd Jeśli metoda usunie wszystkie znaki z bieżącego wystąpienia, ta metoda nie zmodyfikuje 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 wszystkich wystąpieniach trimChar znaku, zostanie usunięty z końca bieżącego ciągu. Jeśli nie można przyciąć żadnych 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 trimChar końcowe znaki. 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ść is i - bieżący ciąg to "---abc---xyz----", TrimEnd(System.Char) metoda zwraca wartość "---abc---xyz".

Uwaga

TrimEnd(System.Char) Jeśli metoda usunie wszystkie znaki z bieżącego wystąpienia, ta metoda nie zmodyfikuje 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ślonego 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 wartość jest null lub pusta tablica, zamiast tego zostaną usunięte znaki odstępu Unicode. Jeśli nie można przyciąć żadnych 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 na końcu 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 końcowe znaki, 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".

Uwaga

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

Uwagi dotyczące wywoływania

.NET Framework 3.5 SP1 i starsze wersje utrzymują 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 .NET Framework 4, jeśli trimChars jest null lub pusta tablica, metoda przycina wszystkie znaki Unicode odstępami (czyli znaki, które generują wartość zwracaną true po przekazaniu ich do IsWhiteSpace(Char) metody). Ze względu na tę zmianę Trim() metoda w .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 .NET Framework 4 i nowszych wersjach nie powoduje usunięcia. Ponadto Trim() metoda w .NET Framework 3.5 SP1 i wcześniejszych wersjach nie przycina trzech znaków spacji Unicode: SEPARATOR VOWEL MONGOLIAN (U+180E), WĄSKIE NIE PRZERWY SPACJI (U+202F) i ŚREDNI OBSZAR MATEMATYCZNY (U+205F).

Zobacz też

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