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>) |
Добавляет строковое представление указанной области памяти символов только для чтения к данному экземпляру. |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
Добавляет строковое представление указанного построителя строки к данному экземпляру.
public:
System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
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
Построитель строки для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Standard | 2.1 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Параметры
Интерполированная строка для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | 6, 7, 8, 9 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
- Атрибуты
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
- Атрибуты
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) метод для 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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Значение параметра 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*****
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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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);
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
Количество добавляемых знаков.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
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.
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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Интерполированная строка для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | 6, 7, 8, 9 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
Добавляет копию указанной строки к данному экземпляру.
public:
System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (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
Добавляемая строка.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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);
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
для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
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
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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- 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);
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
для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Standard | 2.1 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
Важно!
Этот API несовместим с CLS.
- Альтернативный вариант, совместимый с CLS
- System.Text.StringBuilder.Append(Char[], Int32, Int32)
Добавляет к данному экземпляру массив символов Юникода начиная с указанного адреса.
public:
System::Text::StringBuilder ^ Append(char* value, int valueCount);
[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);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
[<System.CLSCompliant(false)>]
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
Параметры
- 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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
- Атрибуты
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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>
Добавляемый диапазон символов только для чтения.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Standard | 2.1 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
- Атрибуты
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое логическое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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 для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
Добавляет строковое представление символа Юникода в указанном массиве к данному экземпляру.
public:
System::Text::StringBuilder ^ Append(cli::array <char> ^ value);
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[]
Массив символов для добавления.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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
Добавляемое значение.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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) для добавления небольших строк.
См. также раздел
Применяется к
.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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
Добавляет строковое представление указанного объекта к данному экземпляру.
public:
System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (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
Добавляемый объект.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Исключения
Увеличение значения этого экземпляра может привести к превышению 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
. Если 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 |
- Исходный код:
- StringBuilder.cs
- Исходный код:
- StringBuilder.cs
- Исходный код:
- 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>
Добавляемая область памяти символов только для чтения.
Возвращаемое значение
Ссылка на этот экземпляр после завершения операции добавления.
Применяется к
.NET 9 және басқа нұсқалар
Өнім | Нұсқалар |
---|---|
.NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: