Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método String.Insert (Int32, String)

 

Publicado: octubre de 2016

Devuelve una nueva cadena en la que se inserta una cadena especificada en una posición de índice concreta en esta instancia.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public string Insert(
	int startIndex,
	string value
)

Parámetros

startIndex
Type: System.Int32

Índice de posición de base cero de la inserción.

value
Type: System.String

Cadena que se va a insertar.

Valor devuelto

Type: System.String

Nueva cadena que es equivalente a la instancia en cuestión, pero con value insertado en la posición startIndex.

Exception Condition
ArgumentNullException

El valor de value es null.

ArgumentOutOfRangeException

startIndex es negativo o mayor que la longitud de esta instancia.

Si startIndex es igual a la longitud de esta instancia, value se anexa al final de esta instancia.

System_CAPS_noteNota

Este método no modifica el valor de la instancia actual. En su lugar, devuelve una nueva cadena en la que value se inserta en la instancia actual.

Por ejemplo, el valor devuelto de "abc".Insert(2, "XYZ") es "abXYZc".

En el ejemplo siguiente se inserta un carácter de espacio en la cuarta posición de carácter (el carácter en el índice 3) de una cadena.

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'

La siguiente aplicación de consola pide a los usuarios escribir uno o más adjetivos para describir dos animales. A continuación, llama el Insert método para insertar el texto escrito por el usuario en una cadena.

using System;

public class Example {
    public static void Main() 
    {
        string animal1 = "fox";
        string animal2 = "dog";

        string strTarget = String.Format("The {0} jumped 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 jumped 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 jumped over the lazy dog.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: