StringBuilder.Insert Metódus

Definíció

Névtér:: System.Text

Szerelvények:: mscorlib.dll, System.Runtime.dll

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: mscorlib.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Beszúrja egy adott objektum sztringképét ebbe a példányba egy megadott karakterhelyzetben.

Túlterhelések

Name	Description
Insert(Int32, String, Int32)	Egy adott sztring egy vagy több példányát szúrja be ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt64)	Egy 64 bites aláíratlan egész szám sztringképét szúrja be ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt32)	Beszúrja egy 32 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, UInt16)	Beszúrja egy 16 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Rune)
Insert(Int32, String)	Sztring beszúrása ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Single)	Beszúrja egy egy pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Char[], Int32, Int32)	Beszúrja a Unicode-karakterek megadott alarráinak sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, SByte)	Beszúrja a megadott 8 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, ReadOnlySpan<Char>)	Beszúrja a karaktersorozatot ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int32)	Beszúrja a megadott 32 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int64)	Beszúrja egy 64 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Int16)	Beszúrja egy megadott 16 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Double)	Beszúrja a kettős pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Decimal)	Beszúrja a decimális szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Char[])	Beszúrja egy megadott Unicode-karaktertömb sztringképét ebbe a példányba a megadott karakterpozícióban.
Insert(Int32, Char)	Beszúrja egy megadott Unicode-karakter sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Byte)	Beszúrja a megadott 8 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Boolean)	Beszúrja a logikai érték sztringképét ebbe a példányba a megadott karakterhelyzetben.
Insert(Int32, Object)	Beszúrja egy objektum sztringképét ebbe a példányba a megadott karakterhelyzetben.

Példák

Az alábbi példa a metódust Insert mutatja be.

using System;
using System.Text;

class Sample
{
//                         index: 012345
    static string initialValue = "--[]--";
    static StringBuilder sb;

    public static void Main()
    {
    string      xyz       = "xyz";
    char[]      abc       = {'a', 'b', 'c'};
    char        star      = '*';
    Object 	obj       = 0;

    bool        xBool     = true;
    byte        xByte     = 1;
    short       xInt16    = 2;
    int         xInt32    = 3;
    long        xInt64    = 4;
    Decimal     xDecimal  = 5;
    float       xSingle   = 6.6F;
    double      xDouble   = 7.7;

// The following types are not CLS-compliant.
    ushort      xUInt16   = 8;
    uint        xUInt32   = 9;
    ulong       xUInt64   = 10;
    sbyte       xSByte    = -11;
//
    Console.WriteLine("StringBuilder.Insert method");
    sb = new StringBuilder(initialValue);

    sb.Insert(3, xyz, 2);
    Show(1, sb);

    sb.Insert(3, xyz);
    Show(2, sb);

    sb.Insert(3, star);
    Show(3, sb);

    sb.Insert(3, abc);
    Show(4, sb);

    sb.Insert(3, abc, 1, 2);
    Show(5, sb);

    sb.Insert(3, xBool);     // True
    Show(6, sb);

    sb.Insert(3, obj);       // 0
    Show(7, sb);

    sb.Insert(3, xByte);     // 1
    Show(8, sb);

    sb.Insert(3, xInt16);    // 2
    Show(9, sb);

    sb.Insert(3, xInt32);    // 3
    Show(10, sb);

    sb.Insert(3, xInt64);    // 4
    Show(11, sb);

    sb.Insert(3, xDecimal);  // 5
    Show(12, sb);

    sb.Insert(3, xSingle);   // 6.6
    Show(13, sb);

    sb.Insert(3, xDouble);   // 7.7
    Show(14, sb);

// The following Insert methods are not CLS-compliant.
    sb.Insert(3, xUInt16);   // 8
    Show(15, sb);

    sb.Insert(3, xUInt32);   // 9
    Show(16, sb);

    sb.Insert(3, xUInt64);   // 10
    Show(17, sb);

    sb.Insert(3, xSByte);    // -11
    Show(18, sb);
//
    }

    public static void Show(int overloadNumber, StringBuilder sbs)
    {
    Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString());
    sb = new StringBuilder(initialValue);
    }
}
/*
This example produces the following results:

StringBuilder.Insert method
 1 = --[xyzxyz]--
 2 = --[xyz]--
 3 = --[*]--
 4 = --[abc]--
 5 = --[bc]--
 6 = --[True]--
 7 = --[0]--
 8 = --[1]--
 9 = --[2]--
10 = --[3]--
11 = --[4]--
12 = --[5]--
13 = --[6.6]--
14 = --[7.7]--
15 = --[8]--
16 = --[9]--
17 = --[10]--
18 = --[-11]--

*/

open System.Text

let initialValue = "--[]--"

let show overloadNumber (sbs: StringBuilder) =
    printfn $"{overloadNumber, 2:G} = {sbs}"
    sbs.Clear().Append initialValue |> ignore

let xyz = "xyz"
let abc = [| 'a'; 'b'; 'c' |]
let star = '*'
let obj: obj = 0

let xBool = true
let xByte = 1uy
let xInt16 = 2s
let xInt32 = 3
let xInt64 = 4L
let xDecimal = 5M
let xSingle = 6.6f
let xDouble = 7.7

// The following types are not CLS-compliant.
let xUInt16 = 8us
let xUInt32 = 9u
let xUInt64 = 10uL
let xSByte = -11y

printfn "StringBuilder.Insert method"
let sb = StringBuilder initialValue

sb.Insert(3, xyz, 2) |> ignore
show 1 sb

sb.Insert(3, xyz) |> ignore
show 2 sb

sb.Insert(3, star) |> ignore
show 3 sb

sb.Insert(3, abc) |> ignore
show 4 sb

sb.Insert(3, abc, 1, 2) |> ignore
show 5 sb

sb.Insert(3, xBool) |> ignore // True
show 6 sb

sb.Insert(3, obj) |> ignore // 0
show 7 sb

sb.Insert(3, xByte) |> ignore // 1
show 8 sb

sb.Insert(3, xInt16) |> ignore // 2
show 9 sb

sb.Insert(3, xInt32) |> ignore // 3
show 10 sb

sb.Insert(3, xInt64) |> ignore // 4
show 11 sb

sb.Insert(3, xDecimal) |> ignore // 5
show 12 sb

sb.Insert(3, xSingle) |> ignore // 6.6
show 13 sb

sb.Insert(3, xDouble) |> ignore // 7.7
show 14 sb

// The following Insert methods are not CLS-compliant.
sb.Insert(3, xUInt16) |> ignore // 8
show 15 sb

sb.Insert(3, xUInt32) |> ignore // 9
show 16 sb

sb.Insert(3, xUInt64) |> ignore // 10
show 17 sb

sb.Insert(3, xSByte) |> ignore // -11
show 18 sb

// This example produces the following results:
//       StringBuilder.Insert method
//        1 = --[xyzxyz]--
//        2 = --[xyz]--
//        3 = --[*]--
//        4 = --[abc]--
//        5 = --[bc]--
//        6 = --[True]--
//        7 = --[0]--
//        8 = --[1]--
//        9 = --[2]--
//       10 = --[3]--
//       11 = --[4]--
//       12 = --[5]--
//       13 = --[6.6]--
//       14 = --[7.7]--
//       15 = --[8]--
//       16 = --[9]--
//       17 = --[10]--
//       18 = --[-11]--

Imports System.Text

Class Sample
   '                                 index: 012345
   Private Shared initialValue As String = "--[]--"
   Private Shared sb As StringBuilder
   
   Public Shared Sub Main()
      Dim xyz As String = "xyz"
      Dim abc As Char() =  {"a"c, "b"c, "c"c}
      Dim star As Char = "*"c
      Dim obj As [Object] = 0
      
      Dim xBool As Boolean = True
      Dim xByte As Byte = 1
      Dim xInt16 As Short = 2
      Dim xInt32 As Integer = 3
      Dim xInt64 As Long = 4
      Dim xDecimal As [Decimal] = 5
      Dim xSingle As Single = 6.6F
      Dim xDouble As Double = 7.7
      
      ' The following types are not CLS-compliant.
      ' Dim xUInt16 As System.UInt16 = 8 
      ' Dim xUInt32 As System.UInt32 = 9
      ' Dim xUInt64 As System.UInt64 = 10 
      ' Dim xSByte As System.SByte = - 11
      '
      Console.WriteLine("StringBuilder.Insert method")
      sb = New StringBuilder(initialValue)
      
      sb.Insert(3, xyz, 2)
      Show(1, sb)
      
      sb.Insert(3, xyz)
      Show(2, sb)
      
      sb.Insert(3, star)
      Show(3, sb)
      
      sb.Insert(3, abc)
      Show(4, sb)
      
      sb.Insert(3, abc, 1, 2)
      Show(5, sb)
      
      sb.Insert(3, xBool)     ' True
      Show(6, sb)
      
      sb.Insert(3, obj)       ' 0
      Show(7, sb)
      
      sb.Insert(3, xByte)     ' 1
      Show(8, sb)
      
      sb.Insert(3, xInt16)    ' 2
      Show(9, sb)
      
      sb.Insert(3, xInt32)    ' 3
      Show(10, sb)
      
      sb.Insert(3, xInt64)    ' 4
      Show(11, sb)
      
      sb.Insert(3, xDecimal)  ' 5
      Show(12, sb)
      
      sb.Insert(3, xSingle)   ' 6.6
      Show(13, sb)
      
      sb.Insert(3, xDouble)   ' 7.7
      Show(14, sb)
      
      ' The following Insert methods are not CLS-compliant.
      ' sb.Insert(3, xUInt16) ' 8
      ' sb.Insert(3, xUInt32) ' 9
      ' sb.Insert(3, xUInt64) ' 10
      ' sb.Insert(3, xSByte)  ' -11

   End Sub
   
   Public Shared Sub Show(overloadNumber As Integer, sbs As StringBuilder)
      Console.WriteLine("{0,2:G} = {1}", overloadNumber, sbs.ToString())
      sb = New StringBuilder(initialValue)
   End Sub
End Class
'
'This example produces the following results:
'
'StringBuilder.Insert method
' 1 = --[xyzxyz]--
' 2 = --[xyz]--
' 3 = --[*]--
' 4 = --[abc]--
' 5 = --[bc]--
' 6 = --[True]--
' 7 = --[0]--
' 8 = --[1]--
' 9 = --[2]--
'10 = --[3]--
'11 = --[4]--
'12 = --[5]--
'13 = --[6.6]--
'14 = --[7.7]--
'

Insert(Int32, String, Int32)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Egy adott sztring egy vagy több példányát szúrja be ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::String ^ value, int count);

public System.Text.StringBuilder Insert(int index, string value, int count);

public System.Text.StringBuilder Insert(int index, string? value, int count);

member this.Insert : int * string * int -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As String, count As Integer) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: String

A beszúrni kívánt sztring.

count: Int32

A beszúrandó valueidőpontok száma.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrás befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány aktuális hossza.

-vagy-

count kisebb, mint nulla.

OutOfMemoryException

Az objektum jelenlegi hossza StringBuilder és az idő value hosszabbcount.MaxCapacity

Megjegyzések

A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Ez StringBuilder az objektum nem változik, ha value az null, value nem null , de a hossza nulla, vagy count nulla.

Lásd még

String

A következőre érvényes:

Insert(Int32, UInt64)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Fontos

Ez az API nem CLS-kompatibilis.

Egy 64 bites aláíratlan egész szám sztringképét szúrja be ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt64 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ulong value);

[<System.CLSCompliant(false)>]
member this.Insert : int * uint64 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As ULong) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: UInt64

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Attribútumok: CLSCompliantAttribute

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

UInt64.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

A .NET Framework 3.5 Service Pack 1 és korábbi verzióiban az erre a metódusra irányuló hívások ArgumentOutOfRangeException dobtak, ha value beszúrásával az objektum teljes hossza meghaladja MaxCapacity. A .NET Framework 4-től kezdve a metódus egy OutOfMemoryException dob.

Lásd még

UInt64

A következőre érvényes:

Insert(Int32, UInt32)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Fontos

Ez az API nem CLS-kompatibilis.

Beszúrja egy 32 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt32 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, uint value);

[<System.CLSCompliant(false)>]
member this.Insert : int * uint32 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As UInteger) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: UInt32

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Attribútumok: CLSCompliantAttribute

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

UInt32.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

UInt32

A következőre érvényes:

Insert(Int32, UInt16)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Fontos

Ez az API nem CLS-kompatibilis.

Beszúrja egy 16 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::UInt16 value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, ushort value);

[<System.CLSCompliant(false)>]
member this.Insert : int * uint16 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As UShort) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: UInt16

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Attribútumok: CLSCompliantAttribute

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

UInt16.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

UInt16

A következőre érvényes:

Insert(Int32, Rune)

Forrás:: StringBuilder.cs

public:
 System::Text::StringBuilder ^ Insert(int index, System::Text::Rune value);

public System.Text.StringBuilder Insert(int index, System.Text.Rune value);

member this.Insert : int * System.Text.Rune -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Rune) As StringBuilder

Paraméterek

index: Int32

value: Rune

Válaszok

StringBuilder

A következőre érvényes:

Insert(Int32, String)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Sztring beszúrása ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::String ^ value);

public System.Text.StringBuilder Insert(int index, string value);

public System.Text.StringBuilder Insert(int index, string? value);

member this.Insert : int * string -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As String) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: String

A beszúrni kívánt sztring.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány aktuális hossza.

-vagy-

Az objektum jelenlegi hossza StringBuilder és a hossz meghaladja a méretetvalueMaxCapacity.

Megjegyzések

A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A kapacitás szükség szerint módosul.

Ez a példány StringBuilder nem változik, ha value az null, vagy value nem null , de a hossza nulla.

Lásd még

String

A következőre érvényes:

Insert(Int32, Single)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy egy pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, float value);

public System.Text.StringBuilder Insert(int index, float value);

member this.Insert : int * single -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Single) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Single

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Single.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Single

A következőre érvényes:

Insert(Int32, Char[], Int32, Int32)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a Unicode-karakterek megadott alarráinak sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, cli::array <char> ^ value, int startIndex, int charCount);

public System.Text.StringBuilder Insert(int index, char[] value, int startIndex, int charCount);

public System.Text.StringBuilder Insert(int index, char[]? value, int startIndex, int charCount);

member this.Insert : int * char[] * int * int -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Char[]

Karaktertömb.

startIndex: Int32

A kezdő index a következőn belül value: .

charCount: Int32

A beszúrandó karakterek száma.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentNullException

value az null, és startIndexcharCount nem nulla.

ArgumentOutOfRangeException

index, startIndexvagy charCount kisebb, mint nulla.

-vagy-

index nagyobb, mint a példány hossza.

-vagy-

startIndex plusz charCount nem egy pozíció belül value.

-vagy-

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

A következőre érvényes:

Insert(Int32, SByte)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Fontos

Ez az API nem CLS-kompatibilis.

Beszúrja a megadott 8 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::SByte value);

[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert(int index, sbyte value);

[<System.CLSCompliant(false)>]
member this.Insert : int * sbyte -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As SByte) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: SByte

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Attribútumok: CLSCompliantAttribute

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

SByte.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A kapacitás szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

SByte

A következőre érvényes:

Insert(Int32, ReadOnlySpan<Char>)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a karaktersorozatot ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, ReadOnlySpan<char> value);

public System.Text.StringBuilder Insert(int index, ReadOnlySpan<char> value);

member this.Insert : int * ReadOnlySpan<char> -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As ReadOnlySpan(Of Char)) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: ReadOnlySpan<Char>

A beszúrni kívánt karaktertartomány.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Megjegyzések

A meglévő karakterek elmozdulnak, hogy helyet adjanak a beszúrandó karaktersorozatnak value . A kapacitás szükség szerint módosul.

A következőre érvényes:

Insert(Int32, Int32)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a megadott 32 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, int value);

public System.Text.StringBuilder Insert(int index, int value);

member this.Insert : int * int -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Integer) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Int32

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Int32.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Int32

A következőre érvényes:

Insert(Int32, Int64)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy 64 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, long value);

public System.Text.StringBuilder Insert(int index, long value);

member this.Insert : int * int64 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Long) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Int64

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Int64.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Int64

A következőre érvényes:

Insert(Int32, Int16)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy megadott 16 bites aláírt egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, short value);

public System.Text.StringBuilder Insert(int index, short value);

member this.Insert : int * int16 -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Short) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Int16

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Int16.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Int16

A következőre érvényes:

Insert(Int32, Double)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a kettős pontosságú lebegőpontos szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, double value);

public System.Text.StringBuilder Insert(int index, double value);

member this.Insert : int * double -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Double) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Double

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Double.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Double

A következőre érvényes:

Insert(Int32, Decimal)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a decimális szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Decimal value);

public System.Text.StringBuilder Insert(int index, decimal value);

member this.Insert : int * decimal -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Decimal) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Decimal

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Decimal.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Decimal

A következőre érvényes:

Insert(Int32, Char[])

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy megadott Unicode-karaktertömb sztringképét ebbe a példányba a megadott karakterpozícióban.

public:
 System::Text::StringBuilder ^ Insert(int index, cli::array <char> ^ value);

public System.Text.StringBuilder Insert(int index, char[] value);

public System.Text.StringBuilder Insert(int index, char[]? value);

member this.Insert : int * char[] -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Char()) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Char[]

A beszúrni kívánt karaktertömb.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

-vagy-

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Ha value igen null, akkor a StringBuilder rendszer nem módosítja.

A következőre érvényes:

Insert(Int32, Char)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy megadott Unicode-karakter sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, char value);

public System.Text.StringBuilder Insert(int index, char value);

member this.Insert : int * char -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Char) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Char

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

-vagy-

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Char.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Lásd még

Char

A következőre érvényes:

Insert(Int32, Byte)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a megadott 8 bites aláíratlan egész szám sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Byte value);

public System.Text.StringBuilder Insert(int index, byte value);

member this.Insert : int * byte -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Byte) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Byte

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Byte.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Byte

A következőre érvényes:

Insert(Int32, Boolean)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja a logikai érték sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, bool value);

public System.Text.StringBuilder Insert(int index, bool value);

member this.Insert : int * bool -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Boolean) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Boolean

A beszúrandó érték.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Boolean.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A kapacitás szükség szerint módosul.

Megjegyzések a hívókhoz

Lásd még

Boolean

A következőre érvényes:

Insert(Int32, Object)

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Forrás:: StringBuilder.cs

Beszúrja egy objektum sztringképét ebbe a példányba a megadott karakterhelyzetben.

public:
 System::Text::StringBuilder ^ Insert(int index, System::Object ^ value);

public System.Text.StringBuilder Insert(int index, object value);

public System.Text.StringBuilder Insert(int index, object? value);

member this.Insert : int * obj -> System.Text.StringBuilder

Public Function Insert (index As Integer, value As Object) As StringBuilder

Paraméterek

index: Int32

Az a pozíció ebben a példányban, ahol a beszúrás megkezdődik.

value: Object

A beszúrni kívánt objektum vagy null.

Válaszok

StringBuilder

Hivatkozás erre a példányra a beszúrási művelet befejezése után.

Kivételek

ArgumentOutOfRangeException

index kisebb, mint nulla vagy nagyobb, mint a példány hossza.

OutOfMemoryException

A példány értékének bővítése meghaladná a következőt MaxCapacity:

Megjegyzések

Object.ToString sztringábrázolás lekérésére valueszolgál. A meglévő karakterek elmozdulnak, hogy helyet adjanak az új szövegnek. A példány kapacitása szükség szerint módosul.

Ha value igen null, a példány értéke nem változik.

Megjegyzések a hívókhoz

Lásd még

Object

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?