Ағылшын тілінде оқу

Бөлісу құралы:


StringBuilder.Append Метод

Определение

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

Перегрузки

Append(StringBuilder)

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

Append(StringBuilder+AppendInterpolatedStringHandler)

Добавляет указанную интерполированную строку к этому экземпляру.

Append(UInt16)

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

Append(UInt32)

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

Append(Char, Int32)

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

Append(Char[], Int32, Int32)

Добавляет строковое представление указанного дочернего массива символов Юникода к данному экземпляру.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Добавляет указанную интерполированную строку к этому экземпляру с использованием указанного формата.

Append(String)

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

Append(String, Int32, Int32)

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

Append(StringBuilder, Int32, Int32)

Добавляет копию подстроки в пределах указанного построителя строки к данному экземпляру.

Append(Char*, Int32)

Добавляет к данному экземпляру массив символов Юникода начиная с указанного адреса.

Append(Single)

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

Append(UInt64)

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

Append(ReadOnlySpan<Char>)

Добавляет строковое представление указанного диапазона символов только для чтения к данному экземпляру.

Append(SByte)

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

Append(Boolean)

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

Append(Byte)

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

Append(Char)

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

Append(Decimal)

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

Append(Double)

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

Append(Char[])

Добавляет строковое представление символа Юникода в указанном массиве к данному экземпляру.

Append(Int16)

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

Append(Int32)

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

Append(Int64)

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

Append(Object)

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

Append(ReadOnlyMemory<Char>)

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

Append(StringBuilder)

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

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

public System.Text.StringBuilder Append (System.Text.StringBuilder? value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);

Параметры

value
StringBuilder

Построитель строки для добавления.

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

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Append(StringBuilder+AppendInterpolatedStringHandler)

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

Добавляет указанную интерполированную строку к этому экземпляру.

public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

Параметры

handler
StringBuilder.AppendInterpolatedStringHandler

Интерполированная строка для добавления.

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

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET 6, 7, 8, 9

Append(UInt16)

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

Важно!

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

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

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);

Параметры

value
UInt16

Добавляемое значение.

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

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

Атрибуты

Исключения

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

Комментарии

Метод Append(UInt16) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535

Метод Append(UInt16) вызывает метод , UInt16.ToString(IFormatProvider) чтобы получить строковое представление value. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(UInt32)

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

Важно!

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

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

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);

Параметры

value
UInt32

Добавляемое значение.

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

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

Атрибуты

Исключения

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

Комментарии

Метод Append(UInt32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295

Вызывает Append(UInt32) метод для UInt32.ToString получения строкового представления для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Char, Int32)

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

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

public System.Text.StringBuilder Append (char value, int repeatCount);

Параметры

value
Char

Добавляемый символ.

repeatCount
Int32

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

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

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

Исключения

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

-или-

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

Недостаточно памяти.

Комментарии

Метод Append(Char, Int32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****$1,346.19*****

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Char[], Int32, Int32)

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

Добавляет строковое представление указанного дочернего массива символов Юникода к данному экземпляру.

public System.Text.StringBuilder Append (char[] value, int startIndex, int charCount);
public System.Text.StringBuilder Append (char[]? value, int startIndex, int charCount);

Параметры

value
Char[]

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

startIndex
Int32

Начальная позиция в массиве value.

charCount
Int32

Количество добавляемых знаков.

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

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

Исключения

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

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

-или-

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

-или-

Значение startIndex + charCount превышает длину value.

-или-

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

Комментарии

Этот метод добавляет указанный диапазон символов в к value текущему экземпляру . Если value значение равно null и startIndex и count равно нулю, изменения не вносятся.

Метод Append(Char[], Int32, Int32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

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

Добавляет указанную интерполированную строку к этому экземпляру с использованием указанного формата.

public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

Параметры

provider
IFormatProvider

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

handler
StringBuilder.AppendInterpolatedStringHandler

Интерполированная строка для добавления.

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

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET 6, 7, 8, 9

Append(String)

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

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

public System.Text.StringBuilder Append (string value);
public System.Text.StringBuilder Append (string? value);

Параметры

value
String

Добавляемая строка.

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

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

Исключения

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

Комментарии

Метод Append(String) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.

Если value имеет значение null, изменения не вносятся.

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(String, Int32, Int32)

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

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

public System.Text.StringBuilder Append (string value, int startIndex, int count);
public System.Text.StringBuilder Append (string? value, int startIndex, int count);

Параметры

value
String

Строка, содержащая добавляемую подстроку.

startIndex
Int32

Начальная позиция подстроки в пределах value.

count
Int32

Число знаков в подстроке value для добавления.

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

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

Исключения

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

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

-или-

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

-или-

Значение startIndex + count превышает длину value.

-или-

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

Комментарии

Этот метод добавляет указанный диапазон символов в к value текущему экземпляру . Если value значение равно null и startIndex и count равно нулю, изменения не вносятся.

Метод Append(String, Int32, Int32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
Console.WriteLine(sb);
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(StringBuilder, Int32, Int32)

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

Добавляет копию подстроки в пределах указанного построителя строки к данному экземпляру.

public System.Text.StringBuilder Append (System.Text.StringBuilder? value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);

Параметры

value
StringBuilder

Построитель строки, содержащий добавляемую подстроку.

startIndex
Int32

Начальная позиция подстроки в пределах value.

count
Int32

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

Append(Char*, Int32)

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

Важно!

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

Альтернативный вариант, совместимый с CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Добавляет к данному экземпляру массив символов Юникода начиная с указанного адреса.

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Text.StringBuilder Append (char* value, int valueCount);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (char* value, int valueCount);

Параметры

value
Char*

Указатель на массив символов.

valueCount
Int32

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

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

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

Атрибуты

Исключения

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

-или-

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

value является пустым указателем

Комментарии

Этот метод добавляет символы valueCount , начиная с адреса value , к текущему экземпляру.

Метод Append(Char*, Int32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство для существующей ссылки, и вам не нужно присваивать возвращаемое значение объекту StringBuilder .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

.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 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Append(Single)

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

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

public System.Text.StringBuilder Append (float value);

Параметры

value
Single

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Single) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****

Метод Append(Single) вызывает метод , Single.ToString чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(UInt64)

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

Важно!

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

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

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);

Параметры

value
UInt64

Добавляемое значение.

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

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

Атрибуты

Исключения

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

Комментарии

Метод Append(UInt64) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

Метод Append(UInt64) вызывает метод , UInt64.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(ReadOnlySpan<Char>)

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

Добавляет строковое представление указанного диапазона символов только для чтения к данному экземпляру.

public System.Text.StringBuilder Append (ReadOnlySpan<char> value);

Параметры

value
ReadOnlySpan<Char>

Добавляемый диапазон символов только для чтения.

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

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Append(SByte)

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

Важно!

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

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

[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);

Параметры

value
SByte

Добавляемое значение.

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

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

Атрибуты

Исключения

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

Комментарии

Метод Append(SByte) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127

Метод Append(SByte) вызывает метод , SByte.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Boolean)

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

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

public System.Text.StringBuilder Append (bool value);

Параметры

value
Boolean

Добавляемое логическое значение.

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

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

Исключения

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

Комментарии

Метод Append(Boolean) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.

Метод Append(Boolean) вызывает метод , Boolean.ToString() чтобы получить строковое представление value. Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Byte)

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

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

public System.Text.StringBuilder Append (byte value);

Параметры

value
Byte

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Byte) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

Byte[] bytes = { 16, 132, 27, 253 };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var value in bytes)
   sb.Append(value).Append(" ");         

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253

Метод Append(Byte) вызывает метод , ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Char)

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

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

public System.Text.StringBuilder Append (char value);

Параметры

value
Char

Единица кода в кодировке UTF-16 для добавления.

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

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

Исключения

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

Комментарии

Метод Append(Char) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

string str = "Characters in a string.";
System.Text.StringBuilder sb = new System.Text.StringBuilder();
foreach (var ch in str)
   sb.Append(" '").Append(ch).Append("' ");

Console.WriteLine("Characters in the string:");
Console.WriteLine("  {0}", sb);
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Decimal)

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

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

public System.Text.StringBuilder Append (decimal value);

Параметры

value
Decimal

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Decimal) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****

Метод Append(Decimal) вызывает метод , Decimal.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Double)

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

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

public System.Text.StringBuilder Append (double value);

Параметры

value
Double

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Double) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****

Метод Append(Double) вызывает метод , Double.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Char[])

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

Добавляет строковое представление символа Юникода в указанном массиве к данному экземпляру.

public System.Text.StringBuilder Append (char[] value);
public System.Text.StringBuilder Append (char[]? value);

Параметры

value
Char[]

Массив символов для добавления.

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

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

Исключения

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

Комментарии

Этот метод добавляет все символы в указанном массиве к текущему экземпляру в том же порядке, что и в value. Если value имеет значение null, изменения не вносятся.

Метод Append(Char[]) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

char[] chars = { 'a', 'e', 'i', 'o', 'u' };
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The characters in the array: ").Append(chars);
Console.WriteLine(sb);
// The example displays the following output:
//      The characters in the array: aeiou

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

.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

Append(Int16)

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

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

public System.Text.StringBuilder Append (short value);

Параметры

value
Int16

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Int16) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767

Метод Append(Int16) вызывает метод , Int16.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Int32)

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

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

public System.Text.StringBuilder Append (int value);

Параметры

value
Int32

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Int32) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647

Метод Append(Int32) вызывает метод , Int32.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Int64)

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

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

public System.Text.StringBuilder Append (long value);

Параметры

value
Int64

Добавляемое значение.

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

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

Исключения

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

Комментарии

Метод Append(Int64) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере.

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

Метод Append(Int64) вызывает , Int64.ToString(IFormatProvider) чтобы получить строковое представление для текущего value языка и региональных параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод .

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(Object)

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

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

public System.Text.StringBuilder Append (object value);
public System.Text.StringBuilder Append (object? value);

Параметры

value
Object

Добавляемый объект.

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

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

Исключения

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

Комментарии

Метод Append(Object) изменяет существующий экземпляр этого класса; он не возвращает новый экземпляр класса. По этой причине можно вызвать метод или свойство по существующей ссылке, и вам не нужно присваивать возвращаемое значение объекту StringBuilder , как показано в следующем примере. Он определяет Dog класс, создает Dog объект и выполняет три вызова Append метода для создания строки, содержащей имя и породу собаки.

using System;

public class Dog
{
   private string dogBreed;
   private string dogName;
   
   public Dog(string name, string breed)
   {
      this.dogName = name;
      this.dogBreed = breed;
   }
   
   public string Breed {
      get { return this.dogBreed; }
   }
   
   public string Name {
      get { return this.dogName; }
   }
   
   public override string ToString()
   {
      return this.dogName;
   }
}

public class Example
{
   public static void Main()
   {
      Dog dog1 = new Dog("Yiska", "Alaskan Malamute");
      System.Text.StringBuilder sb = new System.Text.StringBuilder();     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed);  
      Console.WriteLine(sb);
   }
}
// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute

Метод Append(Object) вызывает метод , Object.ToString чтобы получить строковое представление value. Если value имеет значение null, в объект не вносятся никакие StringBuilder изменения.

Емкость этого экземпляра корректируется по мере необходимости.

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

В .NET Core и в платформа .NET Framework 4.0 и более поздних версий при создании экземпляра StringBuilder объекта путем вызова StringBuilder(Int32, Int32) конструктора длина и емкость экземпляра StringBuilder могут превышать значение его MaxCapacity свойства. Это может произойти, в частности, при вызове Append(String) методов и AppendFormat(String, Object) для добавления небольших строк.

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

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

.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

Append(ReadOnlyMemory<Char>)

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

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

public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);

Параметры

value
ReadOnlyMemory<Char>

Добавляемая область памяти символов только для чтения.

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

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

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

.NET 9 және басқа нұсқалар
Өнім Нұсқалар
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9