String.Insert(Int32, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma nova cadeia na qual uma cadeia especificada é inserida numa posição de índice especificada neste caso.
public:
System::String ^ Insert(int startIndex, System::String ^ value);public string Insert(int startIndex, string value);member this.Insert : int * string -> stringPublic Function Insert (startIndex As Integer, value As String) As StringParâmetros
- startIndex
- Int32
A posição do índice baseado em zero da inserção.
- value
- String
O fio para inserir.
Devoluções
Uma nova cadeia que é equivalente a esta instância, mas com value inserida na posição startIndex.
Exceções
value é null.
startIndex é negativo ou superior ao comprimento desta instância.
Exemplos
O exemplo seguinte insere um carácter de espaço na posição do quarto carácter (o carácter no índice 3) de uma cadeia.
using System;
public class Example
{
public static void Main()
{
String original = "aaabbb";
Console.WriteLine("The original string: '{0}'", original);
String modified = original.Insert(3, " ");
Console.WriteLine("The modified string: '{0}'", modified);
}
}
// The example displays the following output:
// The original string: 'aaabbb'
// The modified string: 'aaa bbb'
let original = "aaabbb"
printfn $"The original string: '{original}'"
let modified = original.Insert(3, " ")
printfn $"The modified string: '{modified}'"
// The example displays the following output:
// The original string: 'aaabbb'
// The modified string: 'aaa bbb'
Public Module Example
Public Sub Main()
Dim original As String = "aaabbb"
Console.WriteLine("The original string: '{0}'", original)
Dim modified As String = original.Insert(3, " ")
Console.WriteLine("The modified string: '{0}'", modified)
End Sub
End Module
' The example displays the following output:
' The original string: 'aaabbb'
' The modified string: 'aaa bbb'
A aplicação de consola seguinte pede aos utilizadores que introduzam um ou mais adjetivos para descrever dois animais. Depois, chama o Insert método para inserir o texto introduzido pelo utilizador numa cadeia.
using System;
public class Example {
public static void Main()
{
string animal1 = "fox";
string animal2 = "dog";
string strTarget = String.Format("The {0} jumps over the {1}.",
animal1, animal2);
Console.WriteLine("The original string is:{0}{1}{0}",
Environment.NewLine, strTarget);
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal1);
string adj1 = Console.ReadLine();
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal2);
string adj2 = Console.ReadLine();
adj1 = adj1.Trim() + " ";
adj2 = adj2.Trim() + " ";
strTarget = strTarget.Insert(strTarget.IndexOf(animal1), adj1);
strTarget = strTarget.Insert(strTarget.IndexOf(animal2), adj2);
Console.WriteLine("{0}The final string is:{0}{1}",
Environment.NewLine, strTarget);
}
}
// Output from the example might appear as follows:
// The original string is:
// The fox jumps over the dog.
//
// Enter an adjective (or group of adjectives) to describe the fox: ==> bold
// Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
//
// The final string is:
// The bold fox jumps over the lazy dog.
open System
let animal1 = "fox"
let animal2 = "dog"
let strTarget = String.Format("The {0} jumps over the {1}.", animal1, animal2)
do
printfn $"The original string is:{Environment.NewLine}{strTarget}{Environment.NewLine}"
printf $"Enter an adjective (or group of adjectives) to describe the {animal1}: => "
let adj1 = stdin.ReadLine()
printf $"Enter an adjective (or group of adjectives) to describe the {animal2}: => "
let adj2 = stdin.ReadLine()
let adj1 = adj1.Trim() + " "
let adj2 = adj2.Trim() + " "
let strTarget = strTarget.Insert(strTarget.IndexOf animal1, adj1)
let strTarget = strTarget.Insert(strTarget.IndexOf animal2, adj2)
printfn $"{Environment.NewLine}The final string is:{strTarget}{Environment.NewLine}"
// Output from the example might appear as follows:
// The original string is:
// The fox jumps over the dog.
//
// Enter an adjective (or group of adjectives) to describe the fox: => bold
// Enter an adjective (or group of adjectives) to describe the dog: => lazy
//
// The final string is:
// The bold fox jumps over the lazy dog.
Public Class Example
Public Shared Sub Main()
Dim animal1 As String = "fox"
Dim animal2 As String = "dog"
Dim strTarget As String = String.Format("The {0} jumps over the {1}.",
animal1, animal2)
Console.WriteLine("The original string is: {0}{1}{0}",
Environment.NewLine, strTarget)
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal1)
Dim adj1 As String = Console.ReadLine()
Console.Write("Enter an adjective (or group of adjectives) " +
"to describe the {0}: ==> ", animal2)
Dim adj2 As String = Console.ReadLine()
adj1 = adj1.Trim() + " "
adj2 = adj2.Trim() + " "
strTarget = strTarget.Insert(strTarget.IndexOf(animal1), adj1)
strTarget = strTarget.Insert(strTarget.IndexOf(animal2), adj2)
Console.WriteLine("{0}The final string is:{0}{1}",
Environment.NewLine, strTarget)
End Sub
End Class
' Output from the example might appear as follows:
' The original string is:
' The fox jumps over the dog.
'
' Enter an adjective (or group of adjectives) to describe the fox: ==> bold
' Enter an adjective (or group of adjectives) to describe the dog: ==> lazy
'
' The final string is:
' The bold fox jumps over the lazy dog.
Observações
Se startIndex for igual ao comprimento desta instância, value é acrescentado ao final desta instância.
Note
Este método não modifica o valor da instância atual. Em vez disso, devolve uma nova cadeia que value é inserida na instância atual.
Por exemplo, o valor de retorno de "abc".Insert(2, "XYZ") é "abXYZc".
