String.Remove 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 um número especificado de caracteres da cadeia de caracteres atual é excluído.

Sobrecargas

Remove(Int32)	Retorna uma nova cadeia de caracteres na qual todos os caracteres na instância atual, começando na posição especificada e continuando até a última posição, foram excluídos.
Remove(Int32, Int32)	Retorna uma nova cadeia de caracteres em que um número especificado de caracteres na instância atual que começa na posição especificada foi excluído.

Remove(Int32)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Retorna uma nova cadeia de caracteres na qual todos os caracteres na instância atual, começando na posição especificada e continuando até a última posição, foram excluídos.

public:
 System::String ^ Remove(int startIndex);

public string Remove (int startIndex);

member this.Remove : int -> string

Public Function Remove (startIndex As Integer) As String

Parâmetros

startIndex: Int32

A posição baseada em zero para iniciar a exclusão de caracteres.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa cadeia de caracteres, exceto os caracteres removidos.

Exceções

ArgumentOutOfRangeException

startIndex é menor que zero.

- ou -

startIndex especifica uma posição que não está nessa cadeia de caracteres.

Exemplos

O exemplo a seguir demonstra o Remove método. O caso próximo ao último remove todo o texto que começa do índice especificado até o final da cadeia de caracteres. O último caso remove três caracteres começando do índice especificado.

// This example demonstrates the String.Remove() method.
using namespace System;
int main()
{
   String^ s = "abc---def";
   
   //
   Console::WriteLine( "Index: 012345678" );
   Console::WriteLine( "1)     {0}", s );
   Console::WriteLine( "2)     {0}", s->Remove( 3 ) );
   Console::WriteLine( "3)     {0}", s->Remove( 3, 3 ) );
}

/*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*/

// This example demonstrates the String.Remove() method.
using System;

class Sample
{
    public static void Main()
    {
        string s = "abc---def";

        Console.WriteLine("Index: 012345678");
        Console.WriteLine("1)     {0}", s);
        Console.WriteLine("2)     {0}", s.Remove(3));
        Console.WriteLine("3)     {0}", s.Remove(3, 3));
    }
}
/*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*/

// This example demonstrates the String.Remove() method.
let s = "abc---def"

printfn "Index: 012345678"
printfn $"1)     {s}"
printfn $"2)     {s.Remove 3}"
printfn $"3)     {s.Remove(3, 3)}"
(*
This example produces the following results:

Index: 012345678
1)     abc---def
2)     abc
3)     abcdef

*)

' This example demonstrates the String.Remove() method.
Class Sample
   Public Shared Sub Main()
      Dim s As String = "abc---def"
      '
      Console.WriteLine("Index: 012345678")
      Console.WriteLine("1)     {0}", s)
      Console.WriteLine("2)     {0}", s.Remove(3))
      Console.WriteLine("3)     {0}", s.Remove(3, 3))
   End Sub
End Class
'
'This example produces the following results:
'
'Index: 012345678
'1)     abc---def
'2)     abc
'3)     abcdef
'

Comentários

No .NET Framework, as cadeias de caracteres são baseadas em zero. O valor do startIndex parâmetro pode variar de zero a um menor que o comprimento da instância de cadeia de caracteres.

Observação

Este método não altera o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual todos os caracteres da posição startIndex até o final da cadeia de caracteres original foram removidos.

Confira também

Aplica-se a

Remove(Int32, Int32)

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Origem:: String.Manipulation.cs

Retorna uma nova cadeia de caracteres em que um número especificado de caracteres na instância atual que começa na posição especificada foi excluído.

public:
 System::String ^ Remove(int startIndex, int count);

public string Remove (int startIndex, int count);

member this.Remove : int * int -> string

Public Function Remove (startIndex As Integer, count As Integer) As String

Parâmetros

startIndex: Int32

A posição baseada em zero para iniciar a exclusão de caracteres.

count: Int32

O número de caracteres a ser excluído.

Retornos

String

Uma nova cadeia de caracteres equivalente a essa instância, exceto os caracteres removidos.

Exceções

ArgumentOutOfRangeException

startIndex ou count é menor que zero.

- ou -

startIndex e count especificam uma posição fora dessa instância.

Exemplos

O exemplo a seguir demonstra como você pode remover o nome do meio de um nome completo.

using namespace System;
int main()
{
   String^ name = "Michelle Violet Banks";
   Console::WriteLine( "The entire name is '{0}'", name );
   
   // remove the middle name, identified by finding the spaces in the middle of the name->->.
   int foundS1 = name->IndexOf( " " );
   int foundS2 = name->IndexOf( " ", foundS1 + 1 );
   if ( foundS1 != foundS2 && foundS1 >= 0 )
   {
      name = name->Remove( foundS1 + 1, foundS2 - foundS1 );
      Console::WriteLine( "After removing the middle name, we are left with '{0}'", name );
   }
}
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'

using System;

public class RemoveTest
{
    public static void Main()
    {

        string name = "Michelle Violet Banks";

        Console.WriteLine("The entire name is '{0}'", name);

        // Remove the middle name, identified by finding the spaces in the name.
        int foundS1 = name.IndexOf(" ");
        int foundS2 = name.IndexOf(" ", foundS1 + 1);

        if (foundS1 != foundS2 && foundS1 >= 0)
        {
            name = name.Remove(foundS1 + 1, foundS2 - foundS1);

            Console.WriteLine("After removing the middle name, we are left with '{0}'", name);
        }
    }
}
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'

let name = "Michelle Violet Banks"

printfn $"The entire name is '{name}'"

// Remove the middle name, identified by finding the spaces in the name.
let foundS1 = name.IndexOf " "
let foundS2 = name.IndexOf(" ", foundS1 + 1)

if foundS1 <> foundS2 && foundS1 >= 0 then
    let name = name.Remove(foundS1 + 1, foundS2 - foundS1)

    printfn $"After removing the middle name, we are left with '{name}'"
// The example displays the following output:
//       The entire name is 'Michelle Violet Banks'
//       After removing the middle name, we are left with 'Michelle Banks'

Public Class RemoveTest
    
    Public Shared Sub Main()
        Dim name As String = "Michelle Violet Banks"
                
        Console.WriteLine("The entire name is '{0}'", name)
        Dim foundS1 As Integer = name.IndexOf(" ")
        Dim foundS2 As Integer = name.IndexOf(" ", foundS1 + 1)
        If foundS1 <> foundS2 And foundS1 >= 0 Then
            
            ' remove the middle name, identified by finding the spaces in the middle of the name...    
            name = name.Remove(foundS1 + 1, foundS2 - foundS1)
            
            Console.WriteLine("After removing the middle name, we are left with '{0}'", name)
        End If
    End Sub
End Class 
' The example displays the following output:
'       The entire name is 'Michelle Violet Banks'
'       After removing the middle name, we are left with 'Michelle Banks'

Comentários

No .NET Framework, as cadeias de caracteres são baseadas em zero. O valor do startIndex parâmetro pode variar de zero a um menor que o comprimento da instância de cadeia de caracteres.

Observação

Este método não altera o valor da instância atual. Em vez disso, retorna uma nova cadeia de caracteres na qual o número de caracteres especificados count pelo parâmetro foi removido. Os caracteres são removidos na posição especificada por startIndex.

Confira também

Aplica-se a

String.Remove Método

Definição

Sobrecargas

Remove(Int32)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Remove(Int32, Int32)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Comentários

Recursos adicionais