String.TrimEnd Método

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

public:
 System::String ^ TrimEnd();

public string TrimEnd ();

member this.TrimEnd : unit -> string

Public Function TrimEnd () As String

Retornos

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

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

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

Parâmetros

Retornos

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

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

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

Parâmetros

Retornos

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

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)

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

Parâmetros

Retornos

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