StringBuilder.Insert Метод

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Runtime.dll

Вставляет строковое представление указанного объекта в этот экземпляр по заданной позиции символа.

Перегрузки

Имя	Описание
Insert(Int32, String, Int32)	Вставляет одну или несколько копий указанной строки в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt64)	Вставляет строковое представление 64-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt32)	Вставляет строковое представление 32-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, UInt16)	Вставляет строковое представление 16-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, String)	Вставляет строку в этот экземпляр в указанное положение символов.
Insert(Int32, Char[], Int32, Int32)	Вставляет строковое представление указанных вложенных символов Юникода в этот экземпляр по указанной позиции символов.
Insert(Int32, Single)	Вставляет строковое представление числа с плавающей запятой с одной точностью в этот экземпляр в указанной позиции символа.
Insert(Int32, SByte)	Вставляет строковое представление указанного 8-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, ReadOnlySpan<Char>)	Вставляет последовательность символов в этот экземпляр по указанному расположению символов.
Insert(Int32, Int16)	Вставляет строковое представление указанного 16-разрядного целого числа со знаком в этот экземпляр по указанной позиции символа.
Insert(Int32, Int64)	Вставляет строковое представление 64-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, Int32)	Вставляет строковое представление указанного 32-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.
Insert(Int32, Double)	Вставляет строковое представление числа с плавающей запятой двойной точности в этот экземпляр в указанной позиции символа.
Insert(Int32, Decimal)	Вставляет строковое представление десятичного числа в этот экземпляр в указанной позиции символа.
Insert(Int32, Char[])	Вставляет строковое представление указанного массива символов Юникода в этот экземпляр по указанной позиции символов.
Insert(Int32, Char)	Вставляет строковое представление указанного символа Юникода в этот экземпляр в указанной позиции символа.
Insert(Int32, Byte)	Вставляет строковое представление указанного 8-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.
Insert(Int32, Boolean)	Вставляет строковое представление логического значения в этот экземпляр по указанной позиции символа.
Insert(Int32, Object)	Вставляет строковое представление объекта в этот экземпляр по указанной позиции символа.

Примеры

В следующем примере демонстрируется Insert метод.

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)

Исходный код:

StringBuilder.cs

Вставляет одну или несколько копий указанной строки в этот экземпляр в указанной позиции символа.

public:
 System::Text::StringBuilder ^ Insert(int index, System::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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

String

Строка для вставки.

count

Int32

Количество операций вставки value.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше текущей длины этого экземпляра.

–или–

count меньше нуля.

OutOfMemoryException

Текущая длина этого StringBuilder объекта плюс длина value времени count превышает MaxCapacity.

Комментарии

Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Этот StringBuilder объект не изменяется, если value имеет nullзначение , value не null является, но его длина равна нулю или count равна нулю.

См. также раздел

• String

Insert(Int32, UInt64)

Исходный код:

StringBuilder.cs

Внимание

Этот API несовместим с CLS.

Вставляет строковое представление 64-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

UInt64

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

UInt64.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• UInt64

Insert(Int32, UInt32)

Исходный код:

StringBuilder.cs

Внимание

Этот API несовместим с CLS.

Вставляет строковое представление 32-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

UInt32

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

UInt32.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• UInt32

Insert(Int32, UInt16)

Исходный код:

StringBuilder.cs

Внимание

Этот API несовместим с CLS.

Вставляет строковое представление 16-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

UInt16

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

UInt16.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• UInt16

Insert(Int32, String)

Исходный код:

StringBuilder.cs

Вставляет строку в этот экземпляр в указанное положение символов.

public:
 System::Text::StringBuilder ^ Insert(int index, System::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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

String

Строка для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше текущей длины этого экземпляра.

–или–

Текущая длина этого StringBuilder объекта плюс длина превышена valueMaxCapacity.

Комментарии

Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость корректируется по мере необходимости.

Этот экземпляр StringBuilder не изменяется, если value имеет nullзначение или value не null имеет, но его длина равна нулю.

См. также раздел

• String

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

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанных вложенных символов Юникода в этот экземпляр по указанной позиции символов.

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);

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Char[]

Массив символов.

startIndex

Int32

Начальный индекс внутри value.

charCount

Int32

Количество вставок символов.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentNullException

value имеет значение nullи startIndexcharCount не равно нулю.

ArgumentOutOfRangeException

index, startIndexили charCount меньше нуля.

–или–

index больше длины этого экземпляра.

–или–

startIndex плюс charCount не является позицией внутри value.

–или–

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Insert(Int32, Single)

Исходный код:

StringBuilder.cs

Вставляет строковое представление числа с плавающей запятой с одной точностью в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Single

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Single.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Single

Insert(Int32, SByte)

Исходный код:

StringBuilder.cs

Внимание

Этот API несовместим с CLS.

Вставляет строковое представление указанного 8-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

SByte

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

SByte.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• SByte

Insert(Int32, ReadOnlySpan<Char>)

Исходный код:

StringBuilder.cs

Вставляет последовательность символов в этот экземпляр по указанному расположению символов.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

ReadOnlySpan<Char>

Диапазон символов для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Комментарии

Существующие символы сдвигаются, чтобы освободить место для последовательности символов в value вставке. Емкость корректируется по мере необходимости.

Insert(Int32, Int16)

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанного 16-разрядного целого числа со знаком в этот экземпляр по указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Int16

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Int16.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Int16

Insert(Int32, Int64)

Исходный код:

StringBuilder.cs

Вставляет строковое представление 64-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Int64

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Int64.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Int64

Insert(Int32, Int32)

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанного 32-разрядного целого числа со знаком в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Int32

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Int32.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Int32

Insert(Int32, Double)

Исходный код:

StringBuilder.cs

Вставляет строковое представление числа с плавающей запятой двойной точности в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Double

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Double.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Double

Insert(Int32, Decimal)

Исходный код:

StringBuilder.cs

Вставляет строковое представление десятичного числа в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Decimal

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Decimal.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Decimal

Insert(Int32, Char[])

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанного массива символов Юникода в этот экземпляр по указанной позиции символов.

public:
 System::Text::StringBuilder ^ Insert(int index, cli::array <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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Char[]

Массив символов для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

–или–

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

В противном случае valuenullStringBuilder значение не изменяется.

Insert(Int32, Char)

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанного символа Юникода в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Char

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

–или–

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Char.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

См. также раздел

• Char

Insert(Int32, Byte)

Исходный код:

StringBuilder.cs

Вставляет строковое представление указанного 8-разрядного целого числа без знака в этот экземпляр в указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Byte

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Byte.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Byte

Insert(Int32, Boolean)

Исходный код:

StringBuilder.cs

Вставляет строковое представление логического значения в этот экземпляр по указанной позиции символа.

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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Boolean

Значение для вставки.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Boolean.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость корректируется по мере необходимости.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Boolean

Insert(Int32, Object)

Исходный код:

StringBuilder.cs

Вставляет строковое представление объекта в этот экземпляр по указанной позиции символа.

public:
 System::Text::StringBuilder ^ Insert(int index, System::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

Параметры

index

Int32

Позиция в этом экземпляре, в которой начинается вставка.

value

Object

Объект для вставки или null.

Возвращаемое значение

StringBuilder

Ссылка на этот экземпляр после завершения операции вставки.

Исключения

ArgumentOutOfRangeException

index меньше нуля или больше длины этого экземпляра.

OutOfMemoryException

Увеличение значения этого экземпляра превысит MaxCapacityзначение.

Комментарии

Object.ToString используется для получения строкового valueпредставления . Существующие символы сдвигаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

Если value имеет значение null, значение этого экземпляра не изменяется.

Примечания для тех, кто вызывает этот метод

В .NET Framework 3.5 с пакетом обновления 1 и более ранних версиях вызовы этого метода вызвали ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта. Начиная с .NET Framework 4, метод создает исключение OutOfMemoryException.

См. также раздел

• Object