Прочитать на английском

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


StringBuilder.Insert Метод

Определение

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

Перегрузки

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 метод.

C#
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]--

*/

Insert(Int32, SByte)

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

Важно!

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

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

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, sbyte value);

Параметры

index
Int32

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

value
SByte

Значение, которое следует вставить.

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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

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

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

C#
public System.Text.StringBuilder Insert (int index, char[] value, int startIndex, int charCount);
C#
public System.Text.StringBuilder Insert (int index, char[]? value, int startIndex, int charCount);

Параметры

index
Int32

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

value
Char[]

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

startIndex
Int32

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

charCount
Int32

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

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

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

Исключения

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

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, String, Int32)

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

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

C#
public System.Text.StringBuilder Insert (int index, string value, int count);
C#
public System.Text.StringBuilder Insert (int index, string? value, int count);

Параметры

index
Int32

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

value
String

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

count
Int32

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

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

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

Исключения

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

-или-

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

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

Комментарии

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, UInt64)

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

Важно!

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

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

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, ulong value);

Параметры

index
Int32

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

value
UInt64

Значение, которое следует вставить.

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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, UInt32)

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

Важно!

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

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

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, uint value);

Параметры

index
Int32

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

value
UInt32

Значение, которое следует вставить.

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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, UInt16)

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

Важно!

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

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

C#
[System.CLSCompliant(false)]
public System.Text.StringBuilder Insert (int index, ushort value);

Параметры

index
Int32

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

value
UInt16

Значение, которое следует вставить.

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

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

Атрибуты

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, String)

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

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

C#
public System.Text.StringBuilder Insert (int index, string value);
C#
public System.Text.StringBuilder Insert (int index, string? value);

Параметры

index
Int32

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

value
String

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

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

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

Исключения

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

-или-

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

Комментарии

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Single)

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

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

C#
public System.Text.StringBuilder Insert (int index, float value);

Параметры

index
Int32

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

value
Single

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, ReadOnlySpan<Char>)

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

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

C#
public System.Text.StringBuilder Insert (int index, ReadOnlySpan<char> value);

Параметры

index
Int32

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

value
ReadOnlySpan<Char>

Вставляемый диапазон символов.

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

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

Комментарии

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Insert(Int32, Int16)

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

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

C#
public System.Text.StringBuilder Insert (int index, short value);

Параметры

index
Int32

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

value
Int16

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Int64)

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

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

C#
public System.Text.StringBuilder Insert (int index, long value);

Параметры

index
Int32

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

value
Int64

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Int32)

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

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

C#
public System.Text.StringBuilder Insert (int index, int value);

Параметры

index
Int32

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

value
Int32

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Object)

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

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

C#
public System.Text.StringBuilder Insert (int index, object value);
C#
public System.Text.StringBuilder Insert (int index, object? value);

Параметры

index
Int32

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

value
Object

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

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Double)

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

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

C#
public System.Text.StringBuilder Insert (int index, double value);

Параметры

index
Int32

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

value
Double

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Decimal)

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

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

C#
public System.Text.StringBuilder Insert (int index, decimal value);

Параметры

index
Int32

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

value
Decimal

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Char[])

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

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

C#
public System.Text.StringBuilder Insert (int index, char[] value);
C#
public System.Text.StringBuilder Insert (int index, char[]? value);

Параметры

index
Int32

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

value
Char[]

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

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

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

Исключения

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

-или-

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

Комментарии

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

Если value имеет значение null, StringBuilder объект не изменяется.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Char)

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

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

C#
public System.Text.StringBuilder Insert (int index, char value);

Параметры

index
Int32

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

value
Char

Значение, которое следует вставить.

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

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

Исключения

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

-или-

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

Комментарии

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Byte)

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

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

C#
public System.Text.StringBuilder Insert (int index, byte value);

Параметры

index
Int32

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

value
Byte

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Insert(Int32, Boolean)

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

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

C#
public System.Text.StringBuilder Insert (int index, bool value);

Параметры

index
Int32

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

value
Boolean

Значение, которое следует вставить.

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0