StringBuilder.Insert Метод

Определение

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

Перегрузки

Insert(Int32, SByte)

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

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, ReadOnlySpan<Char>)

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

Insert(Int32, Double)

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

Insert(Int32, Int64)

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

Insert(Int32, Int32)

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

Insert(Int32, Int16)

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

Insert(Int32, Decimal)

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

Insert(Int32, Char[])

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

Insert(Int32, Char)

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

Insert(Int32, Byte)

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

Insert(Int32, Boolean)

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

Insert(Int32, Object)

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

Примеры

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

using namespace System;
using namespace System::Text;
ref class Sample
{
private:

   //                           index: 012345
   static String^ initialValue = "--[]--";
   static StringBuilder^ sb;

public:
   static void Main()
   {
      String^ xyz = "xyz";
      array<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.
      UInt16 xUInt16 = 8;
      UInt32 xUInt32 = 9;
      UInt64 xUInt64 = 10;
      SByte xSByte = -11;
      
      //
      Console::WriteLine( "StringBuilder.Insert method" );
      sb = gcnew 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 );
      
      //
   }

   static void Show( int overloadNumber, StringBuilder^ sbs )
   {
      Console::WriteLine( "{0,2:G} = {1}", overloadNumber, sbs );
      sb = gcnew StringBuilder( initialValue );
   }

};

int main()
{
   Sample::Main();
}

/*
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]--

*/
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]--

*/
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, SByte)

Важно!

Этот 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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, String, Int32)

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

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

Параметры

index
Int32

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

value
String

Строка, которую требуется вставить.

count
Int32

Сколько раз следует вставить value.

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

StringBuilder

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

Исключения

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

-или-

Значение параметра count меньше нуля.

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

Комментарии

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

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

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

Применяется к

Insert(Int32, UInt64)

Важно!

Этот 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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, UInt32)

Важно!

Этот 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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, UInt16)

Важно!

Этот 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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, String)

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

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

Параметры

index
Int32

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

value
String

Строка, которую требуется вставить.

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

StringBuilder

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

Исключения

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

-или-

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

Комментарии

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

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

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

Применяется к

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

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

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

Параметры

index
Int32

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

value
Char[]

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

startIndex
Int32

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

charCount
Int32

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

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

StringBuilder

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

Исключения

value имеет значение null, а startIndex и charCount не равны нулю.

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

-или-

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

-или-

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

-или-

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

Комментарии

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

Применяется к

Insert(Int32, Single)

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, ReadOnlySpan<Char>)

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

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, Double)

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Int64)

Вставляет строковое представление 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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Int32)

Вставляет строковое представление указанного 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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Int16)

Вставляет строковое представление указанного 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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Decimal)

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Char[])

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

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

Параметры

index
Int32

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

value
Char[]

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

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

StringBuilder

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

Исключения

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

-или-

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

Комментарии

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

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

Применяется к

Insert(Int32, Char)

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

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

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

Исключения

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

-или-

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

Комментарии

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

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

Применяется к

Insert(Int32, Byte)

Вставляет строковое представление указанного 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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Boolean)

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

Применяется к

Insert(Int32, Object)

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

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

Параметры

index
Int32

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

value
Object

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

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

StringBuilder

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

Исключения

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

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

Комментарии

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

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

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

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

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

Применяется к