StringBuilder.Insert Метод

Ссылка

Определение

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

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

Примеры

В следующем примере демонстрируется 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]--

*/

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

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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 (SP1) и более ранних версиях вызовы этого метода вызывали исключение ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта . Начиная с платформа .NET Framework 4 метод вызывает исключение OutOfMemoryException.

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

SByte

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

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

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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);

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, а startIndex и charCount не равны нулю.

ArgumentOutOfRangeException

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

-или-

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

-или-

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

-или-

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

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

Insert(Int32, String, Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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);

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 плюс длина valuecount раз превышает MaxCapacity.

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

String

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

Insert(Int32, UInt64)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

UInt64

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

Insert(Int32, UInt32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

UInt32

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

Insert(Int32, UInt16)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

UInt16

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

Insert(Int32, String)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

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

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

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

Исключения

ArgumentOutOfRangeException

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

-или-

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

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

String

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

Insert(Int32, Single)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

Single

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

Insert(Int32, ReadOnlySpan<Char>)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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

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

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

Insert(Int32, Int16)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

Int16

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

Insert(Int32, Int64)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

Int64

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

Insert(Int32, Int32)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

Int32

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

Insert(Int32, Object)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

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

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

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

Исключения

ArgumentOutOfRangeException

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

OutOfMemoryException

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

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

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

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

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

Object

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

Insert(Int32, Double)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость этого экземпляра корректируется по мере необходимости.

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

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

Double

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

Insert(Int32, Decimal)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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 (SP1) и более ранних версиях вызовы этого метода вызывали исключение ArgumentOutOfRangeException , если вставка value приведет к превышению MaxCapacityобщей длины объекта . Начиная с платформа .NET Framework 4 метод создает исключение OutOfMemoryException.

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

Decimal

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

Insert(Int32, Char[])

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

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

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

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

Исключения

ArgumentOutOfRangeException

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

-или-

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

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

Insert(Int32, Char)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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

Исходный код:: StringBuilder.cs

Исходный код:: 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 (SP1) и более ранних версиях вызовы этого метода вызывали ArgumentOutOfRangeException исключение , если вставка value приведет к превышению MaxCapacityобщей длины объекта . Начиная с платформа .NET Framework 4 метод создает исключение OutOfMemoryException.

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

Byte

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

Insert(Int32, Boolean)

Исходный код:: StringBuilder.cs

Исходный код:: StringBuilder.cs

Исходный код:: 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представления . Существующие символы смещаются, чтобы освободить место для нового текста. Емкость корректируется по мере необходимости.

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

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

Boolean

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

Поделиться через

StringBuilder.Insert Метод

Определение

Перегрузки

Примеры

Insert(Int32, SByte)

Параметры

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

Исключения

Комментарии

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

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

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

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

Параметры

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

Исключения

Комментарии

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

Insert(Int32, String, Int32)

Параметры

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

Исключения

Комментарии

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

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

Insert(Int32, UInt64)

Параметры

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

Исключения

Комментарии

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

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

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

Insert(Int32, UInt32)

Параметры

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

Исключения

Комментарии

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

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

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

Insert(Int32, UInt16)

Параметры

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

Исключения

Комментарии

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

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

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

Insert(Int32, String)

Параметры

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

Исключения

Комментарии

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

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

Insert(Int32, Single)

Параметры

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

Исключения

Комментарии

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

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

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

Insert(Int32, ReadOnlySpan<Char>)

Параметры

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

Комментарии

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

Insert(Int32, Int16)

Параметры

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

Исключения

Комментарии

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

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

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

Insert(Int32, Int64)

Параметры