StringBuilder.Insert Methode

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee voegt u de tekenreeksweergave van een opgegeven object in dit exemplaar in op een opgegeven tekenpositie.

Overloads

Name	Description
Insert(Int32, String, Int32)	Hiermee voegt u een of meer kopieën van een opgegeven tekenreeks in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt64)	Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt32)	Hiermee voegt u de tekenreeksweergave van een 32-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, UInt16)	Hiermee voegt u de tekenreeksweergave van een 16-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Rune)
Insert(Int32, String)	Hiermee voegt u een tekenreeks in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Char[], Int32, Int32)	Hiermee wordt de tekenreeksweergave van een opgegeven submaarray van Unicode-tekens in dit exemplaar ingevoegd op de opgegeven tekenpositie.
Insert(Int32, Single)	Hiermee voegt u de tekenreeksweergave van een drijvende kommanummer met één precisie in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, SByte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, ReadOnlySpan<Char>)	Hiermee voegt u de reeks tekens in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Int16)	Hiermee wordt de tekenreeksweergave van een opgegeven 16-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.
Insert(Int32, Int64)	Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Int32)	Hiermee wordt de tekenreeksweergave van een opgegeven 32-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.
Insert(Int32, Double)	Hiermee voegt u de tekenreeksweergave van een drijvendekommagetal met dubbele precisie in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Decimal)	Hiermee voegt u de tekenreeksweergave van een decimaal getal in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Char[])	Hiermee voegt u de tekenreeksweergave van een opgegeven matrix met Unicode-tekens in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Char)	Hiermee voegt u de tekenreeksweergave van een opgegeven Unicode-teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Byte)	Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Boolean)	Hiermee voegt u de tekenreeksweergave van een Booleaanse waarde in dit exemplaar in op de opgegeven tekenpositie.
Insert(Int32, Object)	Hiermee voegt u de tekenreeksweergave van een object in dit exemplaar in op de opgegeven tekenpositie.

Voorbeelden

In het volgende voorbeeld ziet u de Insert methode.

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)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u een of meer kopieën van een opgegeven tekenreeks in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: String

De tekenreeks die moet worden ingevoegd.

count: Int32

Het aantal keren dat moet worden ingevoegd value.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoeging is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de huidige lengte van dit exemplaar.

– of –

count is kleiner dan nul.

OutOfMemoryException

De huidige lengte van dit StringBuilder object plus de tijdsduur valuecount overschrijdt MaxCapacity.

Opmerkingen

Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Dit StringBuilder object wordt niet gewijzigd als value dat het object is null, value niet null maar de lengte nul is of count nul is.

Zie ook

String

Van toepassing op

Insert(Int32, UInt64)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Belangrijk

Deze API is niet CLS-conform.

Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: UInt64

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Kenmerken: CLSCompliantAttribute

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

UInt64.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

In de .NET Framework 3.5 Service Pack 1 en eerdere versies heeft aanroepen naar deze methode een ArgumentOutOfRangeException als het invoegen van value ertoe zou leiden dat de totale lengte van het object groter is dan MaxCapacity. Vanaf het .NET Framework 4 genereert de methode een OutOfMemoryException.

Zie ook

UInt64

Van toepassing op

Insert(Int32, UInt32)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Belangrijk

Deze API is niet CLS-conform.

Hiermee voegt u de tekenreeksweergave van een 32-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: UInt32

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Kenmerken: CLSCompliantAttribute

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

UInt32.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

UInt32

Van toepassing op

Insert(Int32, UInt16)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Belangrijk

Deze API is niet CLS-conform.

Hiermee voegt u de tekenreeksweergave van een 16-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: UInt16

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Kenmerken: CLSCompliantAttribute

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

UInt16.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

UInt16

Van toepassing op

Insert(Int32, Rune)

Bron:: 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

Parameters

index: Int32

value: Rune

Retouren

StringBuilder

Van toepassing op

Insert(Int32, String)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u een tekenreeks in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: String

De tekenreeks die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de huidige lengte van dit exemplaar.

– of –

De huidige lengte van dit StringBuilder object plus de lengte van value het object overschrijdt MaxCapacity.

Opmerkingen

Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit wordt naar behoefte aangepast.

Dit exemplaar van StringBuilder wordt niet gewijzigd als value dat het geval is nullof value niet null , maar de lengte ervan nul is.

Zie ook

String

Van toepassing op

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

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee wordt de tekenreeksweergave van een opgegeven submaarray van Unicode-tekens in dit exemplaar ingevoegd op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Char[]

Een tekenmatrix.

startIndex: Int32

De beginindex binnen value.

charCount: Int32

Het aantal tekens dat moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentNullException

value is null, en startIndex niet charCount nul.

ArgumentOutOfRangeException

index, startIndexof charCount kleiner is dan nul.

– of –

index is groter dan de lengte van dit exemplaar.

– of –

startIndex plus charCount is geen positie binnen value.

– of –

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Van toepassing op

Insert(Int32, Single)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een drijvende kommanummer met één precisie in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Single

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Single.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Single

Van toepassing op

Insert(Int32, SByte)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Belangrijk

Deze API is niet CLS-conform.

Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: SByte

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Kenmerken: CLSCompliantAttribute

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

SByte.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

SByte

Van toepassing op

Insert(Int32, ReadOnlySpan<Char>)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de reeks tekens in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: ReadOnlySpan<Char>

Het tekenbereik dat moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Opmerkingen

De bestaande tekens worden verschoven om ruimte te maken voor de tekenreeks om deze value in te voegen. De capaciteit wordt naar behoefte aangepast.

Van toepassing op

Insert(Int32, Int16)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee wordt de tekenreeksweergave van een opgegeven 16-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Int16

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Int16.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Int16

Van toepassing op

Insert(Int32, Int64)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een 64-bits geheel getal in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Int64

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Int64.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Int64

Van toepassing op

Insert(Int32, Int32)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee wordt de tekenreeksweergave van een opgegeven 32-bits geheel getal ingevoegd in dit exemplaar op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Int32

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Int32.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Int32

Van toepassing op

Insert(Int32, Double)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een drijvendekommagetal met dubbele precisie in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Double

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Double.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Double

Van toepassing op

Insert(Int32, Decimal)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een decimaal getal in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Decimal

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Decimal.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Decimal

Van toepassing op

Insert(Int32, Char[])

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een opgegeven matrix met Unicode-tekens in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Char[]

De tekenmatrix die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

– of –

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Als value dat het is null, wordt het StringBuilder niet gewijzigd.

Van toepassing op

Insert(Int32, Char)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een opgegeven Unicode-teken in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Char

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

– of –

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Char.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Zie ook

Char

Van toepassing op

Insert(Int32, Byte)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een opgegeven 8-bits geheel getal zonder teken in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Byte

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Byte.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Byte

Van toepassing op

Insert(Int32, Boolean)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een Booleaanse waarde in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Boolean

De waarde die moet worden ingevoegd.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Boolean.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit wordt naar behoefte aangepast.

Notities voor bellers

Zie ook

Boolean

Van toepassing op

Insert(Int32, Object)

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Bron:: StringBuilder.cs

Hiermee voegt u de tekenreeksweergave van een object in dit exemplaar in op de opgegeven tekenpositie.

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

Parameters

index: Int32

De positie in dit exemplaar waar de invoeging begint.

value: Object

Het object dat moet worden ingevoegd, of null.

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de invoegbewerking is voltooid.

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul of groter dan de lengte van dit exemplaar.

OutOfMemoryException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Opmerkingen

Object.ToString wordt gebruikt om een tekenreeksweergave van value. Bestaande tekens worden verschoven om ruimte te maken voor de nieuwe tekst. De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Als value dat het geval is null, is de waarde van dit exemplaar ongewijzigd.

Notities voor bellers

Zie ook

Object

Van toepassing op

Feedback

Is deze pagina nuttig?