StringBuilder.Append 方法

定义

向此实例追加指定对象的字符串表示形式。

重载

Append(StringBuilder)

向此实例追加指定的字符串生成器的字符串表示形式。

Append(StringBuilder+AppendInterpolatedStringHandler)

将指定的内插字符串追加到此实例。

Append(UInt16)

向此实例追加指定的 16 位无符号整数的字符串表示形式。

Append(UInt32)

向此实例追加指定的 32 位无符号整数的字符串表示形式。

Append(Char, Int32)

向此实例追加 Unicode 字符的字符串表示形式指定数目的副本。

Append(Char[], Int32, Int32)

向此实例追加指定的 Unicode 字符子数组的字符串表示形式。

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

使用指定的格式将指定的内插字符串追加到此实例。

Append(String)

向此实例追加指定字符串的副本。

Append(String, Int32, Int32)

向此实例追加指定子字符串的副本。

Append(StringBuilder, Int32, Int32)

向此实例追加指定字符串生成器中的子字符串副本。

Append(Char*, Int32)

将从指定地址开始的 Unicode 字符数组追加到此实例。

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[])

向此实例追加指定数组中的 Unicode 字符的字符串表示形式。

Append(Int16)

向此实例追加指定的 16 位有符号整数的字符串表示形式。

Append(Int32)

向此实例追加指定的 32 位有符号整数的字符串表示形式。

Append(Int64)

向此实例追加指定的 64 位有符号整数的字符串表示形式。

Append(Object)

向此实例追加指定对象的字符串表示形式。

Append(ReadOnlyMemory<Char>)

向此实例追加指定的只读字符内存区域的字符串表示形式。

Append(StringBuilder)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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

要追加的字符串生成器。

返回

完成追加操作后对此实例的引用。

适用于

Append(StringBuilder+AppendInterpolatedStringHandler)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

将指定的内插字符串追加到此实例。

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

参数

handler
StringBuilder.AppendInterpolatedStringHandler

要追加的内插字符串。

返回

完成追加操作后对此实例的引用。

适用于

Append(UInt16)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(UInt32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Char, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

向此实例追加 Unicode 字符的字符串表示形式指定数目的副本。

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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Char[], Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

向此实例追加指定的 Unicode 字符子数组的字符串表示形式。

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

要追加的字符数。

返回

完成追加操作后对此实例的引用。

例外

valuenull,且 startIndexcharCount 不为零。

charCount 小于零。

startIndex 小于零。

- 或 -

startIndex + charCount 大于 value 的长度。

- 或 -

增大此实例的值将超过 MaxCapacity

注解

此方法将 中的 value 指定字符范围追加到当前实例。 如果 valuenullstartIndexcount 都为零,则不做任何更改。

方法 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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

使用指定的格式将指定的内插字符串追加到此实例。

public:
 System::Text::StringBuilder ^ Append(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);
public System.Text.StringBuilder Append (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);
member this.Append : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder
Public Function Append (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

参数

provider
IFormatProvider

一个提供区域性特定的格式设置信息的对象。

handler
StringBuilder.AppendInterpolatedStringHandler

要追加的内插字符串。

返回

完成追加操作后对此实例的引用。

适用于

Append(String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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.

如果 valuenull,则不进行更改。

此实例的容量会根据需要进行调整。

调用方说明

在 .NET Core 和 .NET Framework 4.0 及更高版本中,通过调用 StringBuilder(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(String, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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 中的字符数。

返回

完成追加操作后对此实例的引用。

例外

valuenull,且 startIndexcount 不为零。

count 小于零。

- 或 -

startIndex 小于零。

- 或 -

startIndex + count 大于 value 的长度。

- 或 -

增大此实例的值将超过 MaxCapacity

注解

此方法将 中的 value 指定字符范围追加到当前实例。 如果 valuenullstartIndexcount 都为零,则不做任何更改。

方法 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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(StringBuilder, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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 中的字符数。

返回

完成追加操作后对此实例的引用。

适用于

Append(Char*, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

重要

此 API 不符合 CLS。

符合 CLS 的替代方案
System.Text.StringBuilder.Append(Char[], Int32, Int32)

将从指定地址开始的 Unicode 字符数组追加到此实例。

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 为 null 指针。

注解

此方法将地址value开头的valueCount字符追加到当前实例。

方法 Append(Char*, Int32) 修改此类的现有实例;它不返回新的类实例。 因此,可以对现有引用调用方法或属性,并且不必将返回值分配给 StringBuilder 对象。

此实例的容量会根据需要进行调整。

调用方说明

在 .NET Core 和 .NET Framework 4.0 及更高版本中,通过调用 StringBuilder(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

适用于

Append(Single)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(UInt64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(ReadOnlySpan<Char>)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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>

要追加的只读字符范围。

返回

完成追加操作后对此实例的引用。

适用于

Append(SByte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Boolean)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Byte)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Char)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Decimal)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Double)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Char[])

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

向此实例追加指定数组中的 Unicode 字符的字符串表示形式。

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顺序相同。 如果 valuenull,则不进行更改。

方法 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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

适用于

Append(Int16)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Int64)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其MaxCapacity属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法以追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(Object)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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字符串表示形式。 如果 valuenull,则不会对 StringBuilder 对象进行更改。

此实例的容量会根据需要进行调整。

调用方说明

在 .NET Core 和 .NET Framework 4.0 及更高版本中,通过调用 StringBuilder(Int32, Int32) 构造函数实例化 StringBuilder 对象时,实例的StringBuilder长度和容量都可能超出其 MaxCapacity 属性的值。 尤其是在调用 Append(String)AppendFormat(String, Object) 方法来追加小字符串时,可能会出现这种情况。

另请参阅

适用于

Append(ReadOnlyMemory<Char>)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
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>

要追加的只读字符内存区域。

返回

完成追加操作后对此实例的引用。

适用于