String.TrimEnd Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

TrimEnd()	Remove todos os caracteres de espaço em branco à direita da cadeia de caracteres atual.
TrimEnd(Char)	Remove todas as ocorrências à direita de um caractere da cadeia de caracteres atual.
TrimEnd(Char[])	Remove todas as ocorrências à direita de um conjunto de caracteres especificado em uma matriz da cadeia de caracteres atual.

TrimEnd()

Origem:

String.Manipulation.cs

Remove todos os caracteres de espaço em branco à direita da cadeia de caracteres atual.

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Retornos

String

A cadeia de caracteres que permanece após todos os caracteres de espaço em branco serem removidos do final da cadeia de caracteres atual. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Comentários

O método TrimEnd remove da cadeia de caracteres atual todos os caracteres de espaço em branco à direita. A operação de corte é interrompida quando o primeiro caractere que não é de espaço em branco é encontrado no final da cadeia de caracteres. Por exemplo, se a cadeia de caracteres atual for " abc xyz ", o método TrimEnd retornará " abc xyz".

Nota

Se o método TrimEnd remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. 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.

TrimEnd(Char)

Origem:

String.Manipulation.cs

Remove todas as ocorrências à direita de um caractere da cadeia de caracteres atual.

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.

Retornos

String

A cadeia de caracteres que permanece depois que todas as ocorrências do caractere trimChar são removidas do final da cadeia de caracteres atual. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Comentários

O método TrimEnd(System.Char) remove da cadeia de caracteres atual todos os caracteres trimChar à direita. A operação de corte é interrompida quando o primeiro caractere que não está trimChar é encontrado no final da cadeia de caracteres. Por exemplo, se trimChar for - e a cadeia de caracteres atual for "---abc---xyz----", o método TrimEnd(System.Char) retornará "---abc---xyz".

Nota

Se o método TrimEnd(System.Char) remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres trimChar à direita são removidos da cadeia de caracteres atual.

TrimEnd(Char[])

Origem:

String.Manipulation.cs

Remove todas as ocorrências à direita de um conjunto de caracteres especificado em uma matriz da cadeia de caracteres atual.

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 serem removidos ou null.

Retornos

String

A cadeia de caracteres que permanece após todas as ocorrências dos caracteres no parâmetro trimChars é removida do final da cadeia de caracteres atual. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco Unicode serão removidos. Se nenhum caractere puder ser cortado da instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir demonstra como você pode usar o método TrimEnd(System.Char[]) para cortar marcas de espaço em branco ou pontuação do final de uma cadeia de caracteres.

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

Comentários

O método TrimEnd(System.Char[]) remove da cadeia de caracteres atual todos os caracteres à direita que estão no parâmetro trimChars. A operação de corte é interrompida quando o primeiro caractere que não está no trimChars é encontrado no final da cadeia de caracteres. Por exemplo, se a cadeia de caracteres atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" a "9", o método TrimEnd(System.Char[]) retornará "123abc456xyz".

Nota

Se o método TrimEnd(System.Char[]) remover quaisquer caracteres da instância atual, esse método não modificará o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres à direita encontrados em trimChars são removidos da cadeia de caracteres atual.

Notas aos Chamadores

O .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 corta se trimChars é null ou uma matriz vazia. A partir do .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 true quando são passados para o método IsWhiteSpace(Char)). Devido a essa alteração, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores remove dois caracteres, ZERO WIDTH SPACE (U+200B) e ZERO WIDTH NO-BREAK SPACE (U+FEFF), que o método Trim() no .NET Framework 4 e versões posteriores não remove. Além disso, o método Trim() no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: SEPARADOR VOGAL MONGOL (U+180E), ESPAÇO ESTREITO NO-BREAK (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

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