String.TrimEnd Método

Definición

Sobrecargas

TrimEnd(Char[])

Quita todas las repeticiones del final de un conjunto de caracteres especificados en una matriz de la cadena actual.Removes all the trailing occurrences of a set of characters specified in an array from the current string.

TrimEnd(Char)

Quita todas las repeticiones finales de un carácter de la cadena actual.Removes all the trailing occurrences of a character from the current string.

TrimEnd()

Quita todos los caracteres de espacio en blanco del final de la cadena actual.Removes all the trailing white-space characters from the current string.

TrimEnd(Char[])

Quita todas las repeticiones del final de un conjunto de caracteres especificados en una matriz de la cadena actual.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[]

Matriz de caracteres Unicode que se van a quitar, o null.An array of Unicode characters to remove, or null.

Devoluciones

Cadena que queda una vez quitadas todas las apariciones de los caracteres especificados por el parámetro trimChars del final de la cadena actual.The string that remains after all occurrences of the characters in the trimChars parameter are removed from the end of the current string. Si trimChars es null o una matriz vacía, se quitarán los caracteres de espacio en blanco de Unicode.If trimChars is null or an empty array, Unicode white-space characters are removed instead. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Ejemplos

En el ejemplo siguiente se muestra cómo puede utilizar el método TrimEnd(System.Char[]) para recortar los espacios en blanco o los signos de puntuación del final de una cadena.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

Comentarios

El método TrimEnd(System.Char[]) quita de la cadena actual todos los caracteres finales que se encuentran en el parámetro trimChars.The TrimEnd(System.Char[]) method removes from the current string all trailing characters that are in the trimChars parameter. La operación de recorte se detiene cuando el primer carácter que no está en trimChars se encuentra al final de la cadena.The trim operation stops when the first character that is not in trimChars is encountered at the end of the string. Por ejemplo, si la cadena actual es "123abc456xyz789" y trimChars contiene los dígitos de "1" a "9", el método TrimEnd(System.Char[]) devuelve "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".

Nota

Si el método TrimEnd(System.Char[]) quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual.If the TrimEnd(System.Char[]) method removes any characters from the current instance, this method does not modify the value of the current instance. En su lugar, devuelve una nueva cadena en la que todos los caracteres finales que se encuentran en trimChars se quitan de la cadena actual.Instead, it returns a new string in which all trailing characters found in trimChars are removed from the current string.

Notas a los autores de las llamadas

El .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores mantiene una lista interna de caracteres de espacio en blanco que este método recorta si trimChars es null o una matriz vacía.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. A partir de la .NET Framework 4.NET Framework 4, si trimChars es null o una matriz vacía, el método recorta todos los caracteres de espacio en blanco Unicode (es decir, los caracteres que generan un valor devuelto de true cuando se pasan al 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). Debido a este cambio, el método Trim() en el .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores quita dos caracteres, el espacio de ancho cero (U + 200B) y el espacio sin interrupción de ancho cero (U + FEFF), que el método Trim() de la .NET Framework 4.NET Framework 4 y las versiones posteriores no quita.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. Además, el método Trim() en el .NET Framework 3.5 SP1.NET Framework 3.5 SP1 y versiones anteriores no recorta tres caracteres de espacio en blanco Unicode: separador de vocal mongol (U + 180E), espacio sin interrupción limitado (U + 202F) y espacio matemático medio (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).

Consulte también:

TrimEnd(Char)

Quita todas las repeticiones finales de un carácter de la cadena actual.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

Un carácter Unicode que se va a quitar.A Unicode character to remove.

Devoluciones

La cadena que queda después de quitar todas las repeticiones del carácter trimChar del final de la cadena actual.The string that remains after all occurrences of the trimChar character are removed from the end of the current string. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Comentarios

El método TrimEnd(System.Char) quita de la cadena actual todos los caracteres trimChar finales.The TrimEnd(System.Char) method removes from the current string all trailing trimChar characters. La operación de recorte se detiene cuando el primer carácter que no está trimChar se encuentra al final de la cadena.The trim operation stops when the first character that is not trimChar is encountered at the end of the string. Por ejemplo, si trimChar es - y la cadena actual es "---ABC---XYZ----", el método TrimEnd(System.Char) devuelve "---ABC---XYZ".For example, if trimChar is - and the current string is "---abc---xyz----", the TrimEnd(System.Char) method returns "---abc---xyz".

Nota

Si el método TrimEnd(System.Char) quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual.If the TrimEnd(System.Char) method removes any characters from the current instance, this method does not modify the value of the current instance. En su lugar, devuelve una nueva cadena en la que todos los caracteres trimChar finales se quitan de la cadena actual.Instead, it returns a new string in which all trailing trimChar characters are removed from the current string.

TrimEnd()

Quita todos los caracteres de espacio en blanco del final de la cadena actual.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

Devoluciones

La cadena que queda después de quitar todos los caracteres de espacio en blanco del final de la cadena actual.The string that remains after all white-space characters are removed from the end of the current string. Si no se puede quitar ningún carácter de la instancia actual, el método devuelve la instancia actual sin cambios.If no characters can be trimmed from the current instance, the method returns the current instance unchanged.

Comentarios

El método TrimEnd quita de la cadena actual todos los caracteres de espacio en blanco finales.The TrimEnd method removes from the current string all trailing white-space characters. La operación de recorte se detiene cuando se encuentra el primer carácter que no es un espacio en blanco al final de la cadena.The trim operation stops when the first non white-space character is encountered at the end of the string. Por ejemplo, si la cadena actual es "ABC XYZ", el método TrimEnd devuelve "ABC XYZ".For example, if the current string is " abc xyz ", the TrimEnd method returns " abc xyz".

Nota

Si el método TrimEnd quita los caracteres de la instancia actual, este método no modifica el valor de la instancia actual.If the TrimEnd method removes any characters from the current instance, this method does not modify the value of the current instance. En su lugar, devuelve una nueva cadena en la que todos los caracteres de espacio en blanco finales se quitan de la cadena actual.Instead, it returns a new string in which all trailing white-space characters are removed from the current string.

Se aplica a