String.Trim Método

Origem:

String.Manipulation.cs

public:
 System::String ^ Trim(System::Text::Rune trimRune);

public string Trim(System.Text.Rune trimRune);

member this.Trim : System.Text.Rune -> string

Public Function Trim (trimRune As Rune) As String

Parâmetros

Devoluções

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

public:
 System::String ^ Trim(... cli::array <char> ^ trimChars);

public string Trim(params char[] trimChars);

public string Trim(params char[]? trimChars);

member this.Trim : char[] -> string

Public Function Trim (ParamArray trimChars As Char()) As String

Parâmetros

Devoluções

A cadeia que permanece após todas as ocorrências dos caracteres no trimChars parâmetro serem removidas do início e do fim da cadeia atual. Se trimChars for null ou um array vazio, os caracteres de espaço em branco são removidos em vez disso. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.

Exemplos

O exemplo seguinte utiliza o Trim(System.Char[]) método para remover espaço, asterisco (*) e apóstrofo (') de uma cadeia.

char[] charsToTrim = { '*', ' ', '\''};
string banner = "*** Much Ado About Nothing ***";
string result = banner.Trim(charsToTrim);
Console.WriteLine("Trimmed\n   {0}\nto\n   '{1}'", banner, result);

// The example displays the following output:
//       Trimmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

let charsToTrim = [| '*'; ' '; '\'' |]
let banner = "*** Much Ado About Nothing ***"
let result = banner.Trim charsToTrim
printfn $"Trimmmed\n   {banner}\nto\n   '{result}'"

// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

Module Example
   Public Sub Main()
      Dim charsToTrim() As Char = { "*"c, " "c, "'"c}
      Dim banner As String = "*** Much Ado About Nothing ***"
      Dim result As String = banner.Trim(charsToTrim)
      Console.WriteLine("Trimmmed{0}   {1}{0}to{0}   '{2}'", _
                        vbCrLf, banner, result)
   End Sub
End Module
' The example displays the following output:
'       Trimmmed
'          *** Much Ado About Nothing ***
'       to
'          'Much Ado About Nothing'

Observações

O Trim(System.Char[]) método remove da cadeia corrente todos os caracteres iniciais e finais que estão no trimChars parâmetro. Cada operação de corte à frente e à saída termina quando se encontra um carácter que não está em casa trimChars . Por exemplo, se a cadeia atual for "123abc456xyz789" e trimChars contiver os dígitos de "1" a "9", o Trim(System.Char[]) método devolve "abc456xyz".

Se a cadeia atual for Empty igual ou todos os caracteres da instância atual forem caracteres do trimChars array, o método retorna Empty.

Se trimChars for null ou um array vazio, este método remove quaisquer caracteres iniciais ou finais que resultem no regresso true do método quando são passados para o Char.IsWhiteSpace método.

Notas para Chamadores

O .NET Framework 3.5 SP1 e versões anteriores mantém uma lista interna de caracteres em branco que este método elimina se trimChars for null ou um array vazio. A partir do .NET Framework 4, se trimChars for null ou um array vazio, o método corta todos os caracteres 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 esta 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 elimina três caracteres de espaço em branco Unicode: SEPARADOR VOCÁLICO MONGOL (U+180E), ESPAÇO NO-BREAK ESTREITO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Ver também

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

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

public:
 System::String ^ Trim(char trimChar);

public string Trim(char trimChar);

member this.Trim : char -> string

Public Function Trim (trimChar As Char) As String

Parâmetros

Devoluções

A cadeia que permanece após todas as instâncias do trimChar carácter serem removidas do início e do fim da cadeia atual. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.

Observações

O Trim(System.Char) método remove da cadeia corrente todas as instâncias iniciais e finais do trimChar carácter. Cada operação de corte dianteiro e final termina quando se encontra um carácter diferente de trimChar . Por exemplo, se trimChar is - e a cadeia atual for "---abc---xyz----", o Trim(System.Char) método devolve "abc---xyz". Para remover caracteres entre palavras numa cadeia, use .NET Expressões Regulares.

Se a cadeia atual for Empty igual ou todos os caracteres na instância atual forem compostos por trimChar caracteres, o método devolve Empty.

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

Origem:

String.Manipulation.cs

public:
 System::String ^ Trim();

public string Trim();

member this.Trim : unit -> string

Public Function Trim () As String

Devoluções

A cadeia que permanece depois de todos os caracteres em branco serem removidos do início e do fim da cadeia atual. Se nenhum carácter puder ser cortado da instância atual, o método devolve a instância atual inalterada.

Exemplos

O exemplo seguinte utiliza o String.Trim() método para remover qualquer espaço em branco extra das strings inseridas pelo utilizador antes de as concatenar.

using System;

public class Example
{
    public static void Main()
    {
        Console.Write("Enter your first name: ");
        string firstName = Console.ReadLine();
      
        Console.Write("Enter your middle name or initial: ");
        string middleName = Console.ReadLine();
      
        Console.Write("Enter your last name: ");
        string lastName = Console.ReadLine();
      
        Console.WriteLine();
        Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", 
                        firstName, middleName, lastName);
      
        string name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + 
                    lastName.Trim()).Trim();
        Console.WriteLine("The result is " + name + ".");

        // The following is a possible output from this example:
        //       Enter your first name:    John
        //       Enter your middle name or initial:
        //       Enter your last name:    Doe
        //       
        //       You entered '   John  ', '', and '   Doe'.
        //       The result is John Doe.
    }
}

printf "Enter your first name: "
let firstName = stdin.ReadLine()

printf "Enter your middle name or initial: "
let middleName = stdin.ReadLine()

printf "Enter your last name: "
let lastName = stdin.ReadLine()

printfn $"\nYou entered '{firstName}', '{middleName}', and '{lastName}'." 

let name = ((firstName.Trim() + " " + middleName.Trim()).Trim() + " " + lastName.Trim()).Trim()
printfn $"The result is {name}."

// The following is a possible output from this example:
//       Enter your first name:    John
//       Enter your middle name or initial:
//       Enter your last name:    Doe
//       
//       You entered '   John  ', '', and '   Doe'.
//       The result is John Doe.

Module Example
   Public Sub Main()
      Console.Write("Enter your first name: ")
      Dim firstName As String = Console.ReadLine()
      
      Console.Write("Enter your middle name or initial: ")
      Dim middleName As String = Console.ReadLine()
      
      Console.Write("Enter your last name: ")
      Dim lastName As String = Console.ReadLine
      
      Console.WriteLine()
      Console.WriteLine("You entered '{0}', '{1}', and '{2}'.", _
                        firstName, middleName, lastName)
                        
      Dim name As String = ((firstName.Trim() + " " + middleName.Trim()).Trim() _
                           + " " + lastName.Trim()).Trim()                        
      Console.WriteLine("The result is " + name + ".")
   End Sub
End Module
' The following is possible output from this example:
'       Enter your first name:    John
'       Enter your middle name or initial:
'       Enter your last name:    Doe
'       
'       You entered '   John  ', '', and '   Doe'.
'       The result is John Doe.

Observações

O Trim método remove da cadeia atual todos os caracteres de espaço em branco iniciais e posteriores. Cada operação de corte inicial e final termina quando se encontra um carácter que não é de espaço em branco. Por exemplo, se a cadeia atual for "abc xyz", o Trim método devolve "abc xyz". Para remover caracteres de espaço em branco entre palavras numa cadeia, use .NET Expressões Regulares.

Se a cadeia atual for Empty igual ou todos os caracteres na instância atual forem caracteres de espaço em branco, o método devolve Empty.

Os caracteres de espaço em branco são definidos pelo padrão Unicode. O Trim método remove quaisquer caracteres iniciais e finais que produzam um valor de retorno de true quando são passados para o Char.IsWhiteSpace método.

Notas para Chamadores

O .NET Framework 3.5 SP1 e versões anteriores mantêm uma lista interna de caracteres em branco que este método elimina. A partir do .NET Framework 4, o método corta 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 esta 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 elimina três caracteres de espaço em branco Unicode: SEPARADOR VOCÁLICO MONGOL (U+180E), ESPAÇO NO-BREAK ESTREITO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Ver também

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