Auf Englisch lesen

Freigeben über


String.Insert(Int32, String) Methode

Definition

Gibt eine neue Zeichenfolge zurück, in der eine angegebene Zeichenfolge an einer angegebenen Indexposition in dieser Instanz eingefügt wird.

C#
public string Insert(int startIndex, string value);

Parameter

startIndex
Int32

Die nullbasierte Indexposition für das Einfügen.

value
String

Die einzufügende Zeichenfolge.

Gibt zurück

Eine neue Zeichenfolge, die dieser Instanz mit einem an der Position value eingefügten startIndex entspricht.

Ausnahmen

value ist null.

startIndex ist negativ oder größer als die Länge dieser Instanz.

Beispiele

Im folgenden Beispiel wird ein Leerzeichen an der vierten Zeichenposition (das Zeichen am Index 3) einer Zeichenfolge eingefügt.

C#
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'

Die folgende Konsolenanwendung fordert die Benutzer auf, ein oder mehrere Adjektive einzugeben, um zwei Tiere zu beschreiben. Anschließend wird die Insert -Methode aufgerufen, um den vom Benutzer eingegebenen Text in eine Zeichenfolge einzufügen.

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

Hinweise

Wenn startIndex gleich der Länge dieser Instanz ist, value wird an das Ende dieser Instanz angefügt.

Hinweis

Diese Methode ändert den Wert der aktuellen Instanz nicht. Stattdessen wird eine neue Zeichenfolge zurückgegeben, in der value in die aktuelle Instanz eingefügt wird.

Der Rückgabewert von "abc".Insert(2, "XYZ") ist beispielsweise "abXYZc".

Gilt für:

Weitere Informationen