String.Trim Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma nova cadeia de caracteres na qual todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificados da cadeia de caracteres atual são removidas.

Sobrecargas

Trim()	Remove todos os caracteres de espaço em branco à esquerda e à direita da cadeia de caracteres atual.
Trim(Char[])	Remove todas as ocorrências à esquerda e à direita de um conjunto de caracteres especificados em uma matriz da cadeia de caracteres atual.
Trim(Char)	Remove todas as instâncias à esquerda e à direita da cadeia de caracteres atual.

Trim()

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

public:
 System::String ^ Trim();

public string Trim ();

member this.Trim : unit -> string

Public Function Trim () As String

Retornos

String

A cadeia de caracteres que permanece depois que todos os caracteres de espaço em branco forem removidos do início e do final da cadeia de caracteres atual. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Exemplos

O exemplo a seguir usa o String.Trim() método para remover qualquer espaço em branco extra das cadeias de caracteres inseridas pelo usuário antes de concatená-las.

using namespace System;

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

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.

Comentários

O Trim método remove da cadeia de caracteres atual todos os caracteres de espaço em branco à esquerda e à direita. Cada operação de corte à esquerda e à direita é interrompida quando um caractere de espaço não branco é encontrado. Por exemplo, se a cadeia de caracteres atual for " abc xyz ", o Trim método retornará "abc xyz". Para remover caracteres de espaço em branco entre palavras em uma cadeia de caracteres, use Expressões Regulares do .NET.

Observação

Se o Trim método remover qualquer caractere 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 à esquerda e à direita encontrados na instância atual são removidos.

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

Os caracteres de espaço em branco são definidos pelo padrão Unicode. O Trim método remove todos os caracteres à esquerda e à direita que produzem um valor retornado de true quando são passados para o Char.IsWhiteSpace método .

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. 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 true valor retornado quando são passados para o IsWhiteSpace(Char) método). Devido a essa alteração, o Trim() método 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 Trim() método no .NET Framework 4 e versões posteriores não remove. Além disso, o Trim() método no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: SEPARADOR VOWEL MONGOL (U+180E), ESPAÇO ESTREITO SEM INTERRUPÇÃO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

Aplica-se a

Trim(Char[])

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

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

trimChars: Char[]

Uma matriz de caracteres Unicode a ser removida, ou null.

Retornos

String

A cadeia de caracteres que permanece depois que todas as ocorrências dos caracteres no parâmetro trimChars forem removidas do início e do final da cadeia de caracteres atual. Se trimChars for null ou uma matriz vazia, os caracteres de espaço em branco serão removidos. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Exemplos

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

using namespace System;

void main()
{
   array<Char>^ charsToTrim = { L'*', L' ', L'\\' };
   String^ banner = "*** Much Ado About Nothing ***";
   String^ result = banner->Trim(charsToTrim);
   Console::WriteLine("Trimmmed\n   {0}\nto\n   '{1}'", banner, result);
}
// The example displays the following output:
//       Trimmmed
//          *** Much Ado About Nothing ***
//       to
//          'Much Ado About Nothing'

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'

Comentários

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

Observação

Se o Trim(System.Char[]) método remover qualquer caractere 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 à esquerda e à direita trimChars encontrados na instância atual são removidos.

Se a cadeia de caracteres atual for igual ou todos os caracteres Empty na instância atual consistirem em caracteres na trimChars matriz, o método retornará Empty.

Se trimChars for null ou uma matriz vazia, esse método removerá todos os caracteres à esquerda ou à direita que resultem no retorno true do método quando eles são passados para o Char.IsWhiteSpace método .

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 for null ou uma matriz vazia. Começando com o .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 true valor retornado quando são passados para o IsWhiteSpace(Char) método). Devido a essa alteração, o Trim() método 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 Trim() método no .NET Framework 4 e versões posteriores não remove. Além disso, o Trim() método no .NET Framework 3.5 SP1 e versões anteriores não corta três caracteres de espaço em branco Unicode: SEPARADOR VOWEL MONGOL (U+180E), ESPAÇO ESTREITO SEM INTERRUPÇÃO (U+202F) e ESPAÇO MATEMÁTICO MÉDIO (U+205F).

Confira também

Aplica-se a

Trim(Char)

Remove todas as instâncias à esquerda e à direita da cadeia de caracteres atual.

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

trimChar: Char

Um caractere Unicode a ser removido.

Retornos

String

A cadeia de caracteres que permanece depois que todas as instâncias do caractere trimChar forem removidos do início e do final da cadeia de caracteres atual. Se não for possível cortar caracteres da instância atual, o método retornará a instância atual inalterada.

Comentários

O Trim(System.Char) método remove da cadeia de caracteres atual todas as instâncias à esquerda e à direita do trimChar caractere. Cada operação de corte à esquerda e à direita é interrompida quando um caractere diferente de trimChar é encontrado. Por exemplo, se trimChar for - e a cadeia de caracteres atual for "---abc---xyz----", o Trim(System.Char) método retornará "abc---xyz". Para remover caracteres entre palavras em uma cadeia de caracteres, use expressões regulares do .NET.

Observação

Se o Trim(System.Char) método remover qualquer caractere 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 à esquerda e à direita trimChar encontrados na instância atual são removidos.

Se a cadeia de caracteres atual for igual ou todos os caracteres Empty na instância atual consistirem trimChar em caracteres, o método retornará Empty.

Aplica-se a

String.Trim Método

Definição

Sobrecargas

Trim()

Retornos

Exemplos

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Trim(Char[])

Parâmetros

Retornos

Exemplos

Comentários

Notas aos Chamadores

Confira também

Aplica-se a

Trim(Char)

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais