String.TrimEnd Método

Definição

Sobrecargas

TrimEnd(Char[])

Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz da cadeia de caracteres atual.Removes all the trailing occurrences of a set of characters specified in an array from the current string.

TrimEnd(Char)

Remove todas as ocorrências à direita da cadeia de caracteres atual.Removes all the trailing occurrences of a character from the current string.

TrimEnd()

Remove todos os caracteres de espaço em branco da cadeia de caracteres atual.Removes all the trailing white-space characters from the current string.

TrimEnd(Char[])

Remove todas as ocorrências à direita de um conjunto de caracteres especificados em uma matriz da cadeia de caracteres atual.Removes all the trailing occurrences of a set of characters specified in an array from the current string.

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

Parâmetros

trimChars
Char[]

Uma matriz de caracteres Unicode a ser removida, ou null.An array of Unicode characters to remove, or null.

Retornos

A cadeia de caracteres que permanece depois que todas as ocorrências dos caracteres no parâmetro trimChars forem removidas do final da cadeia de caracteres atual.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the end of the current string. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco Unicode serão removidos.If trimChars is null or an empty array, Unicode white-space characters are removed instead. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Exemplos

O exemplo a seguir demonstra como você pode usar o método TrimEnd(System.Char[]) para aparar o espaço em branco ou marcas de Pontuação do final de uma cadeia de caracteres.The following example demonstrates how you can use the TrimEnd(System.Char[]) method to trim white space or punctuation marks from the end of a string.

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
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

Comentários

O método TrimEnd(System.Char[]) remove da cadeia atual todos os caracteres à direita que estão no parâmetro trimChars.The TrimEnd(System.Char[]) method removes from the current string all trailing characters that are in the trimChars parameter. A operação de corte é interrompida quando o primeiro caractere que não está em trimChars é encontrado no final da cadeia de caracteres.The trim operation stops when the first character that is not in trimChars is encountered at the end of the string. Por exemplo, se a cadeia de caracteres atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" por meio de "9", o método TrimEnd(System.Char[]) retornará "123abc456xyz".For example, if the current string is "123abc456xyz789" and trimChars contains the digits from "1" through "9", the TrimEnd(System.Char[]) method returns "123abc456xyz".

Observação

Se o método TrimEnd(System.Char[]) remover todos os caracteres da instância atual, esse método não modificará o valor da instância atual.If the TrimEnd(System.Char[]) method removes any characters from the current instance, this method does not modify the value of the current instance. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todos os caracteres à direita encontrados no trimChars são removidos da cadeia de caracteres atual.Instead, it returns a new string in which all trailing characters found in trimChars are removed from the current string.

Notas aos Chamadores

O .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores mantêm uma lista interna de caracteres de espaço em branco que esse método apara se trimChars for null ou uma matriz vazia.The .NET Framework 3,5 SP1.NET Framework 3.5 SP1 and earlier versions maintains an internal list of white-space characters that this method trims if trimChars is null or an empty array. Começando com o .NET Framework 4.NET Framework 4, se trimChars for null ou uma matriz vazia, o método cortará todos os caracteres de espaço em branco Unicode (ou seja, caracteres que produzem um valor de retorno de true quando forem passados para o método IsWhiteSpace(Char)).Starting with the .NET Framework 4.NET Framework 4, if trimChars is null or an empty array, the method trims all Unicode white-space characters (that is, characters that produce a true return value when they are passed to the IsWhiteSpace(Char) method). Devido a essa alteração, o método Trim() no .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, espaço de largura ZERO (U + 200B) e espaço sem quebra de largura ZERO (U + FEFF), que o método Trim() no .NET Framework 4.NET Framework 4 e versões posteriores não são removidos.Because of this change, the Trim() method in the .NET Framework 3,5 SP1.NET Framework 3.5 SP1 and earlier versions removes two characters, ZERO WIDTH SPACE (U+200B) and ZERO WIDTH NO-BREAK SPACE (U+FEFF), that the Trim() method in the .NET Framework 4.NET Framework 4 and later versions does not remove. Além disso, o método Trim() no .NET Framework 3,5 SP1.NET Framework 3.5 SP1 e versões anteriores não corta três caracteres Unicode de espaço em branco: Separador de VOGAl mongol (U + 180E), espaço sem quebra estreito (U + 202F) e espaço matemático médio (U + 205F).In addition, the Trim() method in the .NET Framework 3,5 SP1.NET Framework 3.5 SP1 and earlier versions does not trim three Unicode white-space characters: MONGOLIAN VOWEL SEPARATOR (U+180E), NARROW NO-BREAK SPACE (U+202F), and MEDIUM MATHEMATICAL SPACE (U+205F).

Veja também

TrimEnd(Char)

Remove todas as ocorrências à direita da cadeia de caracteres atual.Removes all the trailing occurrences of a character from the current string.

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

Parâmetros

trimChar
Char

Um caractere Unicode a ser removido.A Unicode character to remove.

Retornos

A cadeia de caracteres que permanece depois que todas as ocorrências do caractere trimChar forem removidas do final da cadeia de caracteres atual.The string that remains after all occurrences of the trimChar character are removed from the end of the current string. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Comentários

O método TrimEnd(System.Char) remove da cadeia de caracteres atual todos os caracteres trimChar à direita.The TrimEnd(System.Char) method removes from the current string all trailing trimChar characters. A operação de corte é interrompida quando o primeiro caractere que não é trimChar é encontrado no final da cadeia de caracteres.The trim operation stops when the first character that is not trimChar is encountered at the end of the string. Por exemplo, se trimChar for - e a cadeia de caracteres atual for "---ABC---XYZ----", o método TrimEnd(System.Char) retornará "---ABC---XYZ".For example, if trimChar is - and the current string is "---abc---xyz----", the TrimEnd(System.Char) method returns "---abc---xyz".

Observação

Se o método TrimEnd(System.Char) remover todos os caracteres da instância atual, esse método não modificará o valor da instância atual.If the TrimEnd(System.Char) method removes any characters from the current instance, this method does not modify the value of the current instance. Em vez disso, ele retorna uma nova cadeia de caracteres na qual todos os caracteres trimChar à direita são removidos da cadeia de caracteres atual.Instead, it returns a new string in which all trailing trimChar characters are removed from the current string.

TrimEnd()

Remove todos os caracteres de espaço em branco da cadeia de caracteres atual.Removes all the trailing white-space characters from the current string.

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

Retornos

A cadeia de caracteres que permanece depois que todos os caracteres de espaço em branco forem removidos do final da cadeia de caracteres atual.The string that remains after all white-space characters are removed from the end of the current string. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Comentários

O método TrimEnd remove da cadeia atual todos os caracteres de espaço em branco à direita.The TrimEnd method removes from the current string all trailing white-space characters. A operação de corte é interrompida quando o primeiro caractere de espaço não branco é encontrado no final da cadeia de caracteres.The trim operation stops when the first non white-space character is encountered at the end of the string. Por exemplo, se a cadeia de caracteres atual for "ABC XYZ", o método TrimEnd retornará "ABC XYZ".For example, if the current string is " abc xyz ", the TrimEnd method returns " abc xyz".

Observação

Se o método TrimEnd remover todos os caracteres da instância atual, esse método não modificará o valor da instância atual.If the TrimEnd method removes any characters from the current instance, this method does not modify the value of the current instance. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres de espaço em branco à direita são removidos da cadeia de caracteres atual.Instead, it returns a new string in which all trailing white-space characters are removed from the current string.

Aplica-se a