String.TrimEnd 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: netstandard.dll

程序集:: mscorlib.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

TrimEnd()	从当前字符串中删除所有尾随空格字符。
TrimEnd(Char)	从当前字符串中删除字符的所有尾随匹配项。
TrimEnd(Char[])	从当前字符串中删除数组中指定的一组字符的所有尾随匹配项。
TrimEnd(ReadOnlySpan<Char>)	从当前字符串中删除在范围中指定的一组字符的所有尾随匹配项。

TrimEnd()

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: 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 方法从当前实例中删除任何字符，此方法不会修改当前实例的值。而是返回从当前字符串中删除所有尾随空格字符的新字符串。

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

TrimEnd(Char)

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: 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 字符都将从当前字符串中删除。

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

TrimEnd(Char[])

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

Source:: String.Manipulation.cs

从当前字符串中删除数组中指定的一组字符的所有尾随匹配项。

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

参数

trimChars: Char[]

要删除或 null的 Unicode 字符数组。

String

在 trimChars 参数中出现的所有字符之后保留的字符串将从当前字符串的末尾删除。如果 trimCharsnull 或空数组，则会删除 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 中找到的所有尾随字符。

调用方说明

如果 trimCharsnull 或空数组，.NET Framework 3.5 SP1 和早期版本会维护此方法剪裁的空白字符的内部列表。从 .NET Framework 4 开始，如果 trimCharsnull 或空数组，该方法将剪裁所有 Unicode 空格字符（也就是说，当字符传递到 IsWhiteSpace(Char) 方法时生成 true 返回值的字符）。由于此更改，.NET Framework 3.5 SP1 及更低版本中的 Trim() 方法删除了两个字符：零宽度空间（U+200B）和零宽度 NO-BREAK 空格（U+FEFF），即 .NET Framework 4 及更高版本中的 Trim() 方法不会删除。此外，.NET Framework 3.5 SP1 和早期版本中的 Trim() 方法不会剪裁三个 Unicode 空格字符：MONGOLIAN VOWEL 分隔符（U+180E）、NARROW NO-BREAK SPACE（U+202F）和中等数学空间（U+205F）。

另请参阅

适用于

.NET 9 和其他版本

产品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

TrimEnd(ReadOnlySpan<Char>)

从当前字符串中删除在范围中指定的一组字符的所有尾随匹配项。

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

参数

trimChars: ReadOnlySpan<Char>

要删除的 Unicode 字符的范围。

String

在 trimChars 参数中出现的所有字符之后保留的字符串将从当前字符串的末尾删除。如果 trimChars 为空，则会删除空格字符。如果当前实例中无法剪裁任何字符，该方法将返回当前实例不变。

适用于

.NET 9

产品	版本
.NET	9

通过

String.TrimEnd 方法

定义

重载

TrimEnd()

返回

注解

适用于

TrimEnd(Char)

参数

返回

注解

适用于

TrimEnd(Char[])

参数

返回

示例

注解

调用方说明

另请参阅

适用于

TrimEnd(ReadOnlySpan<Char>)

参数

返回

适用于

其他资源