StringBuilder.Append Метод

Определение

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

System.Text

Сборки:

netstandard.dll, System.Runtime.dll

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

Перегрузки

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

Append(StringBuilder)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);

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

member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder

Public Function Append (value As StringBuilder) As StringBuilder

Параметры

value

StringBuilder

Построитель строк, добавляемый.

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

StringBuilder

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

Append(StringBuilder+AppendInterpolatedStringHandler)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

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

member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Параметры

handler

StringBuilder.AppendInterpolatedStringHandler

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

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

StringBuilder

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

Append(UInt16)

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

StringBuilder.cs

Внимание

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

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

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);

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

[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder

Public Function Append (value As UShort) As StringBuilder

Параметры

value

UInt16

Значение для добавления.

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

StringBuilder

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535

Dim sb As 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) методах для добавления небольших строк.

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

• UInt16

Append(UInt64)

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

StringBuilder.cs

Внимание

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

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

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);

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

[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder

Public Function Append (value As ULong) As StringBuilder

Параметры

value

UInt64

Значение для добавления.

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

StringBuilder

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

Dim sb As 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) методах для добавления небольших строк.

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

• UInt64

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

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

member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Параметры

provider

IFormatProvider

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

handler

StringBuilder.AppendInterpolatedStringHandler

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

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

StringBuilder

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

Append(Char*, Int32)

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

StringBuilder.cs

Внимание

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

Альтернативный вариант, совместимый с CLS

System.Text.StringBuilder.Append(Char[], Int32, Int32)

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

public:
 System::Text::StringBuilder ^ Append(char* value, int valueCount);

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

[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder

Параметры

value

Char*

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

valueCount

Int32

Число символов в массиве.

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

StringBuilder

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

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

–или–

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

NullReferenceException

value — это указатель null.

Комментарии

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

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

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

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

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

Append(String)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);

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

member this.Append : string -> System.Text.StringBuilder

Public Function Append (value As String) As StringBuilder

Параметры

value

String

Строка для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.

Dim flag As Boolean = false
Dim sb As 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) методах для добавления небольших строк.

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

• String

Append(Char[], Int32, Int32)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);

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

member this.Append : char[] * int * int -> System.Text.StringBuilder

Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Параметры

value

Char[]

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

startIndex

Int32

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

charCount

Int32

Число добавляемых символов.

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

StringBuilder

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

–или–

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

–или–

startIndex + charCount больше длины value.

–или–

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

Комментарии

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

Метод изменяет существующий экземпляр этого класса. Он 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.

let chars = [| 'a'; 'b'; 'c'; 'd'; 'e' |]
let sb = StringBuilder()
let startPosition = Array.IndexOf(chars, 'a')
let endPosition = Array.IndexOf(chars, 'c')

if startPosition >= 0 && endPosition >= 0 then
    sb
        .Append("The array from positions ")
        .Append(startPosition)
        .Append(" to ")
        .Append(endPosition)
        .Append(" contains ")
        .Append(chars, startPosition, endPosition + 1)
        .Append "."
    |> ignore

    printfn $"{sb}"
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.

Dim chars() As Char = { "a"c, "b"c, "c"c, "d"c, "e"c}
Dim sb As New System.Text.StringBuilder()
Dim startPosition As Integer = Array.IndexOf(chars, "a"c)
Dim endPosition As Integer = Array.IndexOf(chars, "c"c)
If startPosition >= 0 AndAlso endPosition >= 0 Then
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".")
   Console.WriteLine(sb)
End If             
' 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) методах для добавления небольших строк.

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

• Char

Append(String, Int32, Int32)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);

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

member this.Append : string * int * int -> System.Text.StringBuilder

Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

Параметры

value

String

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

startIndex

Int32

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

count

Int32

Число символов, value добавляемых.

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

StringBuilder

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

–или–

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

–или–

startIndex + count больше длины value.

–или–

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

Комментарии

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

Метод изменяет существующий экземпляр этого класса. Он 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

let str = "First;George Washington;1789;1797"
let mutable index = 0
let sb = StringBuilder()
let length = str.IndexOf(';', index)

sb.Append(str, index, length).Append " President of the United States: "
|> ignore

index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append ", from " |> ignore
index <- index + length + 1
let length = str.IndexOf(';', index) - index
sb.Append(str, index, length).Append " to " |> ignore
index <- index + length + 1
sb.Append(str, index, str.Length - index) |> ignore
printfn $"{sb}"
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797

Dim str As String = "First;George Washington;1789;1797"
Dim index As Integer = 0
Dim sb As New System.Text.StringBuilder()
Dim length As Integer = str.IndexOf(";"c, index)      
sb.Append(str, index, length).Append(" President of the United States: ")
index += length + 1
length = str.IndexOf(";"c, index) - index
sb.Append(str, index, length).Append(", from ")
index += length + 1
length = str.IndexOf(";"c, 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) методах для добавления небольших строк.

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

• String

Append(StringBuilder, Int32, Int32)

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

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

member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder

Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

Параметры

value

StringBuilder

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

startIndex

Int32

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

count

Int32

Число символов, value добавляемых.

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

StringBuilder

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

Append(Char, Int32)

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

StringBuilder.cs

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

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

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

member this.Append : char * int -> System.Text.StringBuilder

Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Параметры

value

Char

Символ, добавляемый.

repeatCount

Int32

Количество добавок value.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

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

–или–

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

OutOfMemoryException

Вне памяти.

Комментарии

Метод изменяет существующий экземпляр этого класса. Он 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*****

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).AppendFormat("{0:C2}", value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****$1,346.19*****

Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).AppendFormat("{0:C2}", value).Append("*"c, 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) методах для добавления небольших строк.

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

• Char

Append(Single)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(float value);

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

member this.Append : single -> System.Text.StringBuilder

Public Function Append (value As Single) As StringBuilder

Параметры

value

Single

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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*****

let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****

Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 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) методах для добавления небольших строк.

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

• Single

Append(UInt32)

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

StringBuilder.cs

Внимание

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

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

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);

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

[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder

Public Function Append (value As UInteger) As StringBuilder

Параметры

value

UInt32

Значение для добавления.

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

StringBuilder

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295

Dim sb As 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) метод для получения строкового представления текущего value языка и региональных UInt32.ToString параметров. Чтобы управлять форматированием value, вызовите AppendFormat метод.

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

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

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

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

• UInt32

Append(ReadOnlySpan<Char>)

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

StringBuilder.cs

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

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

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

member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder

Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

Параметры

value

ReadOnlySpan<Char>

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

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

StringBuilder

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

Append(SByte)

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

StringBuilder.cs

Внимание

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

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

public:
 System::Text::StringBuilder ^ Append(System::SByte value);

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

[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder

Public Function Append (value As SByte) As StringBuilder

Параметры

value

SByte

Значение для добавления.

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

StringBuilder

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127

Dim sb As 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) методах для добавления небольших строк.

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

• SByte

Append(Boolean)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(bool value);

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

member this.Append : bool -> System.Text.StringBuilder

Public Function Append (value As Boolean) As StringBuilder

Параметры

value

Boolean

Логическое значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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.

let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.

Dim flag As Boolean = false
Dim sb As 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) методах для добавления небольших строк.

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

• Boolean

Append(Byte)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Byte value);

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

member this.Append : byte -> System.Text.StringBuilder

Public Function Append (value As Byte) As StringBuilder

Параметры

value

Byte

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

for value in bytes do
    sb.Append(value).Append " " |> ignore

printfn $"The byte array: {sb}"
// The example displays the following output:
//         The byte array: 16 132 27 253

Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
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) методах для добавления небольших строк.

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

• Byte

Append(Char)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(char value);

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

member this.Append : char -> System.Text.StringBuilder

Public Function Append (value As Char) As StringBuilder

Параметры

value

Char

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

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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'  '.'

let str = "Characters in a string."
let sb = StringBuilder()

for ch in str do
    sb.Append(" '").Append(ch).Append "' " |> ignore

printfn "Characters in the string:"
printfn $"  {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'  '.'

Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
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) методах для добавления небольших строк.

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

• Char

Append(Decimal)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);

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

member this.Append : decimal -> System.Text.StringBuilder

Public Function Append (value As Decimal) As StringBuilder

Параметры

value

Decimal

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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*****

let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1346.19*****

Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 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) методах для добавления небольших строк.

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

• Decimal

Append(Double)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(double value);

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

member this.Append : double -> System.Text.StringBuilder

Public Function Append (value As Double) As StringBuilder

Параметры

value

Double

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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*****

let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****

Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 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) методах для добавления небольших строк.

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

• Double

Append(Char[])

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);

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

member this.Append : char[] -> System.Text.StringBuilder

Public Function Append (value As Char()) As StringBuilder

Параметры

value

Char[]

Массив символов, добавляемых.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let chars = [| 'a'; 'e'; 'i'; 'o'; 'u' |]
let sb = StringBuilder()
sb.Append("The characters in the array: ").Append chars |> ignore
printfn $"{sb}"
// The example displays the following output:
//      The characters in the array: aeiou

Dim chars() As Char = { "a"c, "e"c, "i"c, "o"c, "u"c }
Dim sb As 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) методах для добавления небольших строк.

Append(Int32)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(int value);

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

member this.Append : int -> System.Text.StringBuilder

Public Function Append (value As Integer) As StringBuilder

Параметры

value

Int32

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647

Dim sb As 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) методах для добавления небольших строк.

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

• Int32

Append(Int64)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(long value);

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

member this.Append : int64 -> System.Text.StringBuilder

Public Function Append (value As Long) As StringBuilder

Параметры

value

Int64

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

Dim sb As 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) методах для добавления небольших строк.

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

• Int64

Append(Object)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);

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

member this.Append : obj -> System.Text.StringBuilder

Public Function Append (value As Object) As StringBuilder

Параметры

value

Object

Объект, добавляемый.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

open System.Text

type Dog(name: string, breed: string) =
    member _.Name = name
    member _.Breed = breed
    override _.ToString() = name

let dog1 = Dog("Yiska", "Alaskan Malamute")
let sb = StringBuilder()
sb.Append(dog1).Append(", Breed: ").Append dog1.Breed |> printfn "%O"

// The example displays the following output:
//        Yiska, Breed: Alaskan Malamute

Public Class Dog
   Private dogBreed As String
   Private dogName As String
   
   Public Sub New(name As String, breed As String)
      Me.dogName = name
      Me.dogBreed = breed
   End Sub
   
   Public ReadOnly Property Breed As String
      Get
         Return Me.dogBreed
      End Get
   End Property
   
   Public ReadOnly Property Name As String
      Get
         Return Me.dogName
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return Me.dogName
   End Function
End Class
   
Module Example
   Public Sub Main()
      Dim dog1 As New Dog("Yiska", "Alaskan Malamute")
      Dim sb As New System.Text.StringBuilder()     
      sb.Append(dog1).Append(", Breed: ").Append(dog1.Breed)  
      Console.WriteLine(sb)
   End Sub
End Module
' The example displays the following output:
'       Yiska, Breed: Alaskan Malamute

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

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

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

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

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

• Object

Append(ReadOnlyMemory<Char>)

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

StringBuilder.cs

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

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

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

member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder

Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

Параметры

value

ReadOnlyMemory<Char>

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

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

StringBuilder

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

Append(Int16)

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

StringBuilder.cs

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

public:
 System::Text::StringBuilder ^ Append(short value);

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

member this.Append : int16 -> System.Text.StringBuilder

Public Function Append (value As Short) As StringBuilder

Параметры

value

Int16

Значение для добавления.

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

StringBuilder

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

Исключения

ArgumentOutOfRangeException

Увеличение значения этого экземпляра превысит 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

let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767

Dim sb As 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) методах для добавления небольших строк.

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

• Int16