StringBuilder.Insert Metod

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Infogar strängrepresentationen av ett angivet objekt i den här instansen vid en angiven teckenposition.

Överlagringar

Name	Description
Insert(Int32, String, Int32)	Infogar en eller flera kopior av en angiven sträng i den här instansen vid den angivna teckenpositionen.
Insert(Int32, UInt64)	Infogar strängrepresentationen av ett 64-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, UInt32)	Infogar strängrepresentationen av ett 32-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, UInt16)	Infogar strängrepresentationen av ett 16-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Rune)
Insert(Int32, String)	Infogar en sträng i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Char[], Int32, Int32)	Infogar strängrepresentationen av en angiven underordning med Unicode-tecken i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Single)	Infogar strängrepresentationen av ett flyttal med enkel precision i den här instansen vid den angivna teckenpositionen.
Insert(Int32, SByte)	Infogar strängrepresentationen av ett angivet 8-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, ReadOnlySpan<Char>)	Infogar teckensekvensen i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Int16)	Infogar strängrepresentationen av ett angivet 16-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Int64)	Infogar strängrepresentationen av ett 64-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Int32)	Infogar strängrepresentationen av ett angivet 32-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Double)	Infogar strängrepresentationen av ett flyttal med dubbel precision i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Decimal)	Infogar strängrepresentationen av ett decimaltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Char[])	Infogar strängrepresentationen av en angiven matris med Unicode-tecken i den här instansen på den angivna teckenpositionen.
Insert(Int32, Char)	Infogar strängrepresentationen av ett angivet Unicode-tecken i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Byte)	Infogar strängrepresentationen av ett angivet 8-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Boolean)	Infogar strängrepresentationen av ett booleskt värde i den här instansen vid den angivna teckenpositionen.
Insert(Int32, Object)	Infogar strängrepresentationen av ett objekt i den här instansen vid den angivna teckenpositionen.

Exempel

I följande exempel visas Insert metoden.

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)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar en eller flera kopior av en angiven sträng i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: String

Strängen som ska infogas.

count: Int32

Antalet gånger som ska infogas value.

Returer

StringBuilder

En referens till den här instansen när infogning har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än den aktuella längden på den här instansen.

-eller-

count är mindre än noll.

OutOfMemoryException

Den aktuella längden på det här StringBuilder objektet plus längden på value gångerna count överskrider MaxCapacity.

Kommentarer

Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Det här StringBuilder objektet ändras inte om value är null, value är inte null men dess längd är noll eller count är noll.

Se även

String

Gäller för

Insert(Int32, UInt64)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Infogar strängrepresentationen av ett 64-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: UInt64

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Attribut: CLSCompliantAttribute

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

UInt64.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

I .NET Framework 3.5 Service Pack 1 och tidigare versioner kastade anrop till den här metoden en ArgumentOutOfRangeException om infogning av value skulle göra att objektets totala längd överskrider MaxCapacity. Från och med .NET Framework 4 genererar metoden en OutOfMemoryException.

Se även

UInt64

Gäller för

Insert(Int32, UInt32)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Infogar strängrepresentationen av ett 32-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: UInt32

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Attribut: CLSCompliantAttribute

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

UInt32.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

UInt32

Gäller för

Insert(Int32, UInt16)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Infogar strängrepresentationen av ett 16-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: UInt16

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Attribut: CLSCompliantAttribute

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

UInt16.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

UInt16

Gäller för

Insert(Int32, Rune)

Källa:: 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

Parametrar

index: Int32

value: Rune

Returer

StringBuilder

Gäller för

Insert(Int32, String)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar en sträng i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: String

Strängen som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än den aktuella längden på den här instansen.

-eller-

Objektets StringBuilder aktuella längd plus längden value på överskrider MaxCapacity.

Kommentarer

Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten justeras efter behov.

Den här instansen av StringBuilder ändras inte om value är null, eller value inte null , men dess längd är noll.

Se även

String

Gäller för

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

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av en angiven underordning med Unicode-tecken i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Char[]

En teckenmatris.

startIndex: Int32

Startindexet inom value.

charCount: Int32

Antalet tecken som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentNullException

value är null, och startIndex och charCount är inte noll.

ArgumentOutOfRangeException

index, startIndex, eller charCount är mindre än noll.

-eller-

index är större än längden på den här instansen.

-eller-

startIndex plus charCount är inte en position inom value.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Gäller för

Insert(Int32, Single)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett flyttal med enkel precision i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Single

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Single.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Single

Gäller för

Insert(Int32, SByte)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Infogar strängrepresentationen av ett angivet 8-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: SByte

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Attribut: CLSCompliantAttribute

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

SByte.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten justeras efter behov.

Anteckningar till anropare

Se även

SByte

Gäller för

Insert(Int32, ReadOnlySpan<Char>)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar teckensekvensen i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: ReadOnlySpan<Char>

Teckenintervallet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Kommentarer

De befintliga tecknen flyttas för att göra plats för teckensekvensen value i för att infoga den. Kapaciteten justeras efter behov.

Gäller för

Insert(Int32, Int16)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett angivet 16-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Int16

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Int16.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Int16

Gäller för

Insert(Int32, Int64)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett 64-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Int64

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Int64.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Int64

Gäller för

Insert(Int32, Int32)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett angivet 32-bitars signerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Int32

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Int32.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Int32

Gäller för

Insert(Int32, Double)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett flyttal med dubbel precision i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Double

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Double.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Double

Gäller för

Insert(Int32, Decimal)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett decimaltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Decimal

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Decimal.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Decimal

Gäller för

Insert(Int32, Char[])

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av en angiven matris med Unicode-tecken i den här instansen på den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Char[]

Teckenmatrisen som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Om value är nullStringBuilder ändras inte .

Gäller för

Insert(Int32, Char)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett angivet Unicode-tecken i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Char

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Char.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Se även

Char

Gäller för

Insert(Int32, Byte)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett angivet 8-bitars osignerat heltal i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Byte

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Byte.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

Se även

Byte

Gäller för

Insert(Int32, Boolean)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett booleskt värde i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Boolean

Värdet som ska infogas.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Boolean.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten justeras efter behov.

Anteckningar till anropare

Se även

Boolean

Gäller för

Insert(Int32, Object)

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Källa:: StringBuilder.cs

Infogar strängrepresentationen av ett objekt i den här instansen vid den angivna teckenpositionen.

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

Parametrar

index: Int32

Positionen i den här instansen där infogningen börjar.

value: Object

Objektet som ska infogas, eller null.

Returer

StringBuilder

En referens till den här instansen när infogningsåtgärden har slutförts.

Undantag

ArgumentOutOfRangeException

index är mindre än noll eller större än längden på den här instansen.

OutOfMemoryException

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Object.ToString används för att hämta en strängrepresentation av value. Befintliga tecken flyttas för att göra plats för den nya texten. Kapaciteten för den här instansen justeras efter behov.

Om value är nullär värdet för den här instansen oförändrat.

Anteckningar till anropare

Se även

Object

Gäller för

Feedback

Var den här sidan till hjälp?