StringBuilder.Append 方法
定义
向此实例追加指定对象的字符串表示形式。Appends the string representation of a specified object to this instance.
重载
| Append(StringBuilder) |
向此实例追加指定的字符串生成器的字符串表示形式。Appends the string representation of a specified string builder to this instance. |
| Append(UInt16) |
向此实例追加指定的 16 位无符号整数的字符串表示形式。Appends the string representation of a specified 16-bit unsigned integer to this instance. |
| Append(UInt32) |
向此实例追加指定的 32 位无符号整数的字符串表示形式。Appends the string representation of a specified 32-bit unsigned integer to this instance. |
| Append(UInt64) |
向此实例追加指定的 64 位无符号整数的字符串表示形式。Appends the string representation of a specified 64-bit unsigned integer to this instance. |
| Append(Char[], Int32, Int32) |
向此实例追加指定的 Unicode 字符子数组的字符串表示形式。Appends the string representation of a specified subarray of Unicode characters to this instance. |
| Append(Char*, Int32) |
将从指定地址开始的 Unicode 字符数组追加到此实例。Appends an array of Unicode characters starting at a specified address to this instance. |
| Append(String) |
向此实例追加指定字符串的副本。Appends a copy of the specified string to this instance. |
| Append(String, Int32, Int32) |
向此实例追加指定子字符串的副本。Appends a copy of a specified substring to this instance. |
| Append(StringBuilder, Int32, Int32) |
向此实例追加指定字符串生成器中的子字符串副本。Appends a copy of a substring within a specified string builder to this instance. |
| Append(Char, Int32) |
向此实例追加 Unicode 字符的字符串表示形式指定数目的副本。Appends a specified number of copies of the string representation of a Unicode character to this instance. |
| Append(SByte) |
向此实例追加指定的 8 位有符号整数的字符串表示形式。Appends the string representation of a specified 8-bit signed integer to this instance. |
| Append(Single) |
向此实例追加指定的单精度浮点数的字符串表示形式。Appends the string representation of a specified single-precision floating-point number to this instance. |
| Append(ReadOnlyMemory<Char>) |
向此实例追加指定的只读字符内存区域的字符串表示形式。Appends the string representation of a specified read-only character memory region to this instance. |
| Append(Boolean) |
向此实例追加指定的布尔值的字符串表示形式。Appends the string representation of a specified Boolean value to this instance. |
| Append(ReadOnlySpan<Char>) |
向此实例追加指定的只读字符范围的字符串表示形式。Appends the string representation of a specified read-only character span to this instance. |
| Append(Char) |
将指定的 Char 对象的字符串表示形式追加到此实例。Appends the string representation of a specified Char object to this instance. |
| Append(Char[]) |
向此实例追加指定数组中的 Unicode 字符的字符串表示形式。Appends the string representation of the Unicode characters in a specified array to this instance. |
| Append(Decimal) |
向此实例追加指定的十进制数的字符串表示形式。Appends the string representation of a specified decimal number to this instance. |
| Append(Byte) |
向此实例追加指定的 8 位无符号整数的字符串表示形式。Appends the string representation of a specified 8-bit unsigned integer to this instance. |
| Append(Int16) |
向此实例追加指定的 16 位有符号整数的字符串表示形式。Appends the string representation of a specified 16-bit signed integer to this instance. |
| Append(Int32) |
向此实例追加指定的 32 位有符号整数的字符串表示形式。Appends the string representation of a specified 32-bit signed integer to this instance. |
| Append(Int64) |
向此实例追加指定的 64 位有符号整数的字符串表示形式。Appends the string representation of a specified 64-bit signed integer to this instance. |
| Append(Object) |
向此实例追加指定对象的字符串表示形式。Appends the string representation of a specified object to this instance. |
| Append(Double) |
向此实例追加指定的双精度浮点数的字符串表示形式。Appends the string representation of a specified double-precision floating-point number to this instance. |
Append(StringBuilder)
向此实例追加指定的字符串生成器的字符串表示形式。Appends the string representation of a specified string builder to this instance.
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
要追加的字符串生成器。The string builder to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation is completed.
适用于
Append(UInt16)
重要
此 API 不符合 CLS。
向此实例追加指定的 16 位无符号整数的字符串表示形式。Appends the string representation of a specified 16-bit unsigned integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
- 属性
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(UInt16)方法修改此类的现有实例,而不返回新的类实例。The Append(UInt16) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(UInt16) method calls the UInt16.ToString(IFormatProvider) method to get the string representation of value. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(UInt32)
重要
此 API 不符合 CLS。
向此实例追加指定的 32 位无符号整数的字符串表示形式。Appends the string representation of a specified 32-bit unsigned integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
- 属性
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(UInt32)方法修改此类的现有实例,而不返回新的类实例。The Append(UInt32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(UInt32) calls the UInt32.ToString method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(UInt64)
重要
此 API 不符合 CLS。
向此实例追加指定的 64 位无符号整数的字符串表示形式。Appends the string representation of a specified 64-bit unsigned integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
- 属性
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(UInt64)方法修改此类的现有实例,而不返回新的类实例。The Append(UInt64) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(UInt64) method calls the UInt64.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Char[], Int32, Int32)
向此实例追加指定的 Unicode 字符子数组的字符串表示形式。Appends the string representation of a specified subarray of Unicode characters to this instance.
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[]
字符数组。A character array.
- startIndex
- Int32
value 中的起始位置。The starting position in value.
- charCount
- Int32
要追加的字符数。The number of characters to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
value 为 null,且 startIndex 和 charCount 不为零。value is null, and startIndex and charCount are not zero.
charCount 小于零。charCount is less than zero.
或-or-
startIndex 小于零。startIndex is less than zero.
- 或 --or-
startIndex + charCount 大于 value 的长度。startIndex + charCount is greater than the length of value.
- 或 --or-
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
此方法将指定范围的字符追加 value 到当前实例中。This method appends the specified range of characters in value to the current instance. 如果 value 为 null 和 startIndex 且 count 均为零,则不进行任何更改。If value is null and startIndex and count are both zero, no changes are made.
Append(Char[], Int32, Int32)方法修改此类的现有实例,而不返回新的类实例。The Append(Char[], Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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.
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.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Char*, Int32)
将从指定地址开始的 Unicode 字符数组追加到此实例。Appends an array of Unicode characters starting at a specified address to this instance.
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);
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
member this.Append : nativeptr<char> * int -> System.Text.StringBuilder
参数
- value
- Char*
指向字符数组的指针。A pointer to an array of characters.
- valueCount
- Int32
数组中的字符数。The number of characters in the array.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
- 属性
例外
valueCount 小于零。valueCount is less than zero.
- 或 --or-
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
value 为 null 指针。value is a null pointer.
注解
此方法 valueCount 将从 address 开始的字符追加 value 到当前实例。This method appends valueCount characters starting at address value to the current instance.
Append(Char*, Int32)方法修改此类的现有实例,而不返回新的类实例。The Append(Char*, Int32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
适用于
Append(String)
向此实例追加指定字符串的副本。Appends a copy of the specified string to this instance.
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
要追加的字符串。The string to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(String)方法修改此类的现有实例,而不返回新的类实例。The Append(String) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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.
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 ,则不进行任何更改。If value is null, no changes are made.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(String, Int32, Int32)
向此实例追加指定子字符串的副本。Appends a copy of a specified substring to this instance.
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
包含要追加的子字符串的字符串。The string that contains the substring to append.
- startIndex
- Int32
value 中子字符串开始的位置。The starting position of the substring within value.
- count
- Int32
要追加的 value 中的字符数。The number of characters in value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
value 为 null,且 startIndex 和 count 不为零。value is null, and startIndex and count are not zero.
count 小于零。count less than zero.
- 或 --or-
startIndex 小于零。startIndex less than zero.
- 或 --or-
startIndex + count 大于 value 的长度。startIndex + count is greater than the length of value.
- 或 --or-
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
此方法将指定范围的字符追加 value 到当前实例中。This method appends the specified range of characters in value to the current instance. 如果 value 为 null 和 startIndex 且 count 均为零,则不进行任何更改。If value is null and startIndex and count are both zero, no changes are made.
Append(String, Int32, Int32)方法修改此类的现有实例,而不返回新的类实例。The Append(String, Int32, Int32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(StringBuilder, Int32, Int32)
向此实例追加指定字符串生成器中的子字符串副本。Appends a copy of a substring within a specified string builder to this instance.
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
包含要追加的子字符串的字符串生成器。The string builder that contains the substring to append.
- startIndex
- Int32
value 中子字符串开始的位置。The starting position of the substring within value.
- count
- Int32
要追加的 value 中的字符数。The number of characters in value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
适用于
Append(Char, Int32)
向此实例追加 Unicode 字符的字符串表示形式指定数目的副本。Appends a specified number of copies of the string representation of a Unicode character to this instance.
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
要追加的字符。The character to append.
- repeatCount
- Int32
要追加 value 的次数。The number of times to append value.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
repeatCount 小于零。repeatCount is less than zero.
- 或 --or-
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
内存不足。Out of memory.
注解
Append(Char, Int32)方法修改此类的现有实例,而不返回新的类实例。The Append(Char, Int32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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*****
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*****
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(SByte)
重要
此 API 不符合 CLS。
向此实例追加指定的 8 位有符号整数的字符串表示形式。Appends the string representation of a specified 8-bit signed integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
- 属性
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(SByte)方法修改此类的现有实例,而不返回新的类实例。The Append(SByte) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(SByte) method calls the SByte.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Single)
向此实例追加指定的单精度浮点数的字符串表示形式。Appends the string representation of a specified single-precision floating-point number to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Single)方法修改此类的现有实例,而不返回新的类实例。The Append(Single) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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*****
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 。The Append(Single) method calls the Single.ToString method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(ReadOnlyMemory<Char>)
向此实例追加指定的只读字符内存区域的字符串表示形式。Appends the string representation of a specified read-only character memory region to this instance.
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>
要追加的只读字符内存区域。The read-only character memory region to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation is completed.
适用于
Append(Boolean)
向此实例追加指定的布尔值的字符串表示形式。Appends the string representation of a specified Boolean value to this instance.
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
要追加的布尔值。The Boolean value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Boolean)方法修改此类的现有实例,而不返回新的类实例。The Append(Boolean) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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.
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 。The Append(Boolean) method calls the Boolean.ToString() method to get the string representation of value. 此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(ReadOnlySpan<Char>)
向此实例追加指定的只读字符范围的字符串表示形式。Appends the string representation of a specified read-only character span to this instance.
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>
要追加的只读字符范围。The read-only character span to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation is completed.
适用于
Append(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 编码的代码单元。The UTF-16-encoded code unit to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Char)方法修改此类的现有实例,而不返回新的类实例。The Append(Char) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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' '.'
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' '.'
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Char[])
向此实例追加指定数组中的 Unicode 字符的字符串表示形式。Appends the string representation of the Unicode characters in a specified array to this instance.
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[]
要追加的字符数组。The array of characters to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
此方法将指定数组中的所有字符追加到当前实例,其顺序与它们在中出现的顺序相同 value 。This method appends all the characters in the specified array to the current instance in the same order as they appear in value. 如果 value 为 null ,则不进行任何更改。If value is null, no changes are made.
Append(Char[])方法修改此类的现有实例,而不返回新的类实例。The Append(Char[]) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
适用于
Append(Decimal)
向此实例追加指定的十进制数的字符串表示形式。Appends the string representation of a specified decimal number to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Decimal)方法修改此类的现有实例,而不返回新的类实例。The Append(Decimal) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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*****
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 。The Append(Decimal) method calls the Decimal.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Byte)
向此实例追加指定的 8 位无符号整数的字符串表示形式。Appends the string representation of a specified 8-bit unsigned integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Byte)方法修改此类的现有实例,而不返回新的类实例。The Append(Byte) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(Byte) method calls the ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Int16)
向此实例追加指定的 16 位有符号整数的字符串表示形式。Appends the string representation of a specified 16-bit signed integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Int16)方法修改此类的现有实例,而不返回新的类实例。The Append(Int16) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(Int16) method calls the Int16.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Int32)
向此实例追加指定的 32 位有符号整数的字符串表示形式。Appends the string representation of a specified 32-bit signed integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Int32)方法修改此类的现有实例,而不返回新的类实例。The Append(Int32) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(Int32) method calls the Int32.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Int64)
向此实例追加指定的 64 位有符号整数的字符串表示形式。Appends the string representation of a specified 64-bit signed integer to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Int64)方法修改此类的现有实例,而不返回新的类实例。The Append(Int64) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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
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 。The Append(Int64) method calls the Int64.ToString(IFormatProvider) to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Object)
向此实例追加指定对象的字符串表示形式。Appends the string representation of a specified object to this instance.
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
要追加的对象。The object to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Object)方法修改此类的现有实例,而不返回新的类实例。The Append(Object) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates. 它定义了一个 Dog 类,创建一个 Dog 对象,并对方法进行了三次调用, Append 以创建一个包含狗名称和同类的字符串。It defines a Dog class, creates a Dog object, and makes three calls to the Append method to create a string that contains the dog's name and breed.
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
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 。The Append(Object) method calls the Object.ToString method to get the string representation of value. 如果 value 为 null ,则不会对对象进行任何更改 StringBuilder 。If value is null, no changes are made to the StringBuilder object.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.
另请参阅
适用于
Append(Double)
向此实例追加指定的双精度浮点数的字符串表示形式。Appends the string representation of a specified double-precision floating-point number to this instance.
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
要追加的值。The value to append.
返回
完成追加操作后对此实例的引用。A reference to this instance after the append operation has completed.
例外
增大此实例的值将超过 MaxCapacity。Enlarging the value of this instance would exceed MaxCapacity.
注解
Append(Double)方法修改此类的现有实例,而不返回新的类实例。The Append(Double) method modifies the existing instance of this class; it does not return a new class instance. 因此,你可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象,如下面的示例所示。Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a StringBuilder object, as the following example illustrates.
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*****
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 。The Append(Double) method calls the Double.ToString(IFormatProvider) method to get the string representation of value for the current culture. 若要控制的格式 value ,请调用 AppendFormat 方法。To control the formatting of value, call the AppendFormat method.
此实例的容量会根据需要进行调整。The capacity of this instance is adjusted as needed.
调用方说明
在 .NET Core 和 .NET Framework 4.0 及更高版本中,当你 StringBuilder 通过调用构造函数实例化对象时, StringBuilder(Int32, Int32) 实例的长度和容量 StringBuilder 可能会超出其属性的值 MaxCapacity 。In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 当调用 Append(String) 和 AppendFormat(String, Object) 方法追加小字符串时,尤其如此。This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.