String.TrimEnd 方法

定義

命名空間:

System

組件:

System.Runtime.dll

多載

TrimEnd()	從目前字串中移除所有尾端空格符。
TrimEnd(Char)	從目前字串中移除字元的所有尾端專案。
TrimEnd(Char[])	從目前字串中移除陣列中指定的一組字元的所有尾端專案。

TrimEnd()

來源:

String.Manipulation.cs

從目前字串中移除所有尾端空格符。

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

傳回

String

在目前字串結尾移除所有空格符之後所保留的字串。 如果無法從目前的實例修剪任何字元，此方法會傳回未變更的目前實例。

備註

TrimEnd 方法會從目前字串中移除所有尾端空格符。 修剪作業會在字串結尾遇到第一個非空格元時停止。 例如，如果目前的字串是 「abc xyz」，則 TrimEnd 方法會傳回 「abc xyz」。

注意

如果 TrimEnd 方法會從目前實例中移除任何字元，這個方法不會修改目前實例的值。 相反地，它會傳回新的字串，其中所有尾端空格符都會從目前的字串中移除。

TrimEnd(Char)

來源:

String.Manipulation.cs

從目前字串中移除字元的所有尾端專案。

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

public string TrimEnd (char trimChar);

member this.TrimEnd : char -> string

Public Function TrimEnd (trimChar As Char) As String

參數

trimChar

Char

要移除的 Unicode 字元。

傳回

String

在所有出現 trimChar 字元之後保留的字串會從目前字串的結尾移除。 如果無法從目前的實例修剪任何字元，此方法會傳回未變更的目前實例。

備註

TrimEnd(System.Char) 方法會從目前字串中移除所有尾端 trimChar 字元。 修剪作業會在字串結尾遇到未 trimChar 的第一個字元時停止。 例如，如果 trimChar 是 -，而目前的字串是 “---abc---xyz----”，TrimEnd(System.Char) 方法會傳回 “---abc---xyz”。

注意

如果 TrimEnd(System.Char) 方法會從目前實例中移除任何字元，這個方法不會修改目前實例的值。 相反地，它會傳回新的字串，其中所有尾端 trimChar 字元都會從目前的字串中移除。

TrimEnd(Char[])

來源:

String.Manipulation.cs

從目前字串中移除陣列中指定的一組字元的所有尾端專案。

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

參數

trimChars

Char[]

要移除的 Unicode 字元陣列，或 null。

傳回

String

在 trimChars 參數中所有出現的字元之後，會從目前字串的結尾移除保留的字串。 如果 trimChars 是 null 或空陣列，則會改為移除 Unicode 空格符。 如果無法從目前的實例修剪任何字元，此方法會傳回未變更的目前實例。

範例

下列範例示範如何使用 TrimEnd(System.Char[]) 方法來修剪字串結尾的空格符或標點符號。

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

備註

TrimEnd(System.Char[]) 方法會從目前字串中移除 trimChars 參數中的所有尾端字元。 修剪作業會在字串結尾遇到不在 trimChars 的第一個字元時停止。 例如，如果目前的字串是 「123abc456xyz789」，且 trimChars 包含 “1” 到 “9” 的數位，則 TrimEnd(System.Char[]) 方法會傳回 “123abc456xyz”。

注意

如果 TrimEnd(System.Char[]) 方法會從目前實例中移除任何字元，這個方法不會修改目前實例的值。 相反地，它會傳回新的字串，其中 trimChars 中找到的所有尾端字元都會從目前的字串中移除。

給呼叫者的注意事項

.NET Framework 3.5 SP1 和舊版會維護一份內部空格符清單，如果 trimChars 是 null 或空陣列，此方法會修剪這個清單。 從 .NET Framework 4 開始，如果 trimChars 是 null 或空陣列，此方法會修剪所有 Unicode 空格符（也就是當字元傳遞至 IsWhiteSpace(Char) 方法時產生 true 傳回值的字元）。 由於這項變更，.NET Framework 3.5 SP1 和舊版中的 Trim() 方法會移除兩個字元：零寬度空間 （U+200B） 和零寬度 NO-BREAK SPACE （U+FEFF），.NET Framework 4 和更新版本中的 Trim() 方法不會移除。 此外，.NET Framework 3.5 SP1 和舊版中的 Trim() 方法不會修剪三個 Unicode 空格符：蒙古文 VOWEL 分隔符（U+180E）、NARROW NO-BREAK SPACE （U+202F）和中數學空間 （U+205F）。

另請參閱

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