共用方式為


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)

將指定的布林 (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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定字串產生器的字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value);
public System.Text.StringBuilder Append (System.Text.StringBuilder value);
member this.Append : System.Text.StringBuilder -> System.Text.StringBuilder
Public Function Append (value As StringBuilder) As StringBuilder

參數

value
StringBuilder

要附加的字串產生器。

傳回

完成附加作業之後,這個執行個體的參考。

適用於

Append(StringBuilder+AppendInterpolatedStringHandler)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的插入字串附加至這個實例。

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

參數

handler
StringBuilder.AppendInterpolatedStringHandler

要附加的插入字串。

傳回

完成附加作業之後,這個執行個體的參考。

適用於

Append(UInt16)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

重要

此 API 不符合 CLS 規範。

將指定的 16 位元不帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::UInt16 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ushort value);
[<System.CLSCompliant(false)>]
member this.Append : uint16 -> System.Text.StringBuilder
Public Function Append (value As UShort) As StringBuilder

參數

value
UInt16

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

屬性

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(UInt16) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 16-bit unsigned integer: ");
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
let sb = StringBuilder "The range of a 16-bit unsigned integer: "
sb.Append(UInt16.MinValue).Append(" to ").Append UInt16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit unsigned integer: 0 to 65535
Dim sb As New System.Text.StringBuilder("The range of a 16-bit unsigned integer: ")
sb.Append(UInt16.MinValue).Append(" to ").Append(UInt16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit unsigned integer: 0 to 65535

方法 Append(UInt16)UInt16.ToString(IFormatProvider) 呼叫 方法,以取得的 value字串表示。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(UInt32)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

重要

此 API 不符合 CLS 規範。

將指定的 32 位元不帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::UInt32 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (uint value);
[<System.CLSCompliant(false)>]
member this.Append : uint32 -> System.Text.StringBuilder
Public Function Append (value As UInteger) As StringBuilder

參數

value
UInt32

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

屬性

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(UInt32) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 32-bit unsigned integer: ");
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
let sb = StringBuilder "The range of a 32-bit unsigned integer: "
sb.Append(UInt32.MinValue).Append(" to ").Append UInt32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit unsigned integer: 0 to 4294967295
Dim sb As New System.Text.StringBuilder("The range of a 32-bit unsigned integer: ")
sb.Append(UInt32.MinValue).Append(" to ").Append(UInt32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit unsigned integer: 0 to 4294967295

Append(UInt32) 呼叫 UInt32.ToString 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Char, Int32)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

使用指定的格式,將指定的插入字串附加至這個實例。

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

參數

provider
IFormatProvider

物件,提供特定文化特性格式資訊。

handler
StringBuilder.AppendInterpolatedStringHandler

要附加的插入字串。

傳回

完成附加作業之後,這個執行個體的參考。

適用於

Append(String)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定字串的複本附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::String ^ value);
public System.Text.StringBuilder Append (string value);
public System.Text.StringBuilder Append (string? value);
member this.Append : string -> System.Text.StringBuilder
Public Function Append (value As String) As StringBuilder

參數

value
String

要附加的字串。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(String) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

bool flag = false;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("The value of the flag is ").Append(flag).Append(".");
Console.WriteLine(sb.ToString());
// The example displays the following output:
//       The value of the flag is False.
let flag = false
let sb = StringBuilder()
sb.Append("The value of the flag is ").Append(flag).Append "." |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The value of the flag is False.
Dim flag As Boolean = false
Dim sb As New System.Text.StringBuilder
sb.Append("The value of the flag is ").Append(flag).Append(".")
Console.WriteLine(sb.ToString())
' The example displays the following output:
'       The value of the flag is False.

如果 valuenull,則不會進行任何變更。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(String, Int32, Int32)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定子字串的複本附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::String ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (string value, int startIndex, int count);
public System.Text.StringBuilder Append (string? value, int startIndex, int count);
member this.Append : string * int * int -> System.Text.StringBuilder
Public Function Append (value As String, startIndex As Integer, count As Integer) As StringBuilder

參數

value
String

包含要附加之子字串的字串。

startIndex
Int32

value 中子字串的開始位置。

count
Int32

value 中要附加的字元數。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將所指定字串產生器內的子字串複本附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::Text::StringBuilder ^ value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder? value, int startIndex, int count);
public System.Text.StringBuilder Append (System.Text.StringBuilder value, int startIndex, int count);
member this.Append : System.Text.StringBuilder * int * int -> System.Text.StringBuilder
Public Function Append (value As StringBuilder, startIndex As Integer, count As Integer) As StringBuilder

參數

value
StringBuilder

字串產生器,其中包含要附加的子字串。

startIndex
Int32

value 中子字串的開始位置。

count
Int32

value 中要附加的字元數。

傳回

完成附加作業之後,這個執行個體的參考。

適用於

Append(Char*, Int32)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
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 指標。

備註

這個方法會將 valueCount 從地址 value 開始的字元附加至目前的 實例。

方法 Append(Char*, Int32) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

適用於

Append(Single)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的單精確度浮點數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(float value);
public System.Text.StringBuilder Append (float value);
member this.Append : single -> System.Text.StringBuilder
Public Function Append (value As Single) As StringBuilder

參數

value
Single

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Single) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

float value = 1034769.47f;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47f
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Single = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

方法 Append(Single)Single.ToString 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(UInt64)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

重要

此 API 不符合 CLS 規範。

將指定的 64 位元不帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::UInt64 value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (ulong value);
[<System.CLSCompliant(false)>]
member this.Append : uint64 -> System.Text.StringBuilder
Public Function Append (value As ULong) As StringBuilder

參數

value
UInt64

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

屬性

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(UInt64) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit unsigned integer: ");
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
let sb = StringBuilder "The range of a 64-bit unsigned integer: "
sb.Append(UInt64.MinValue).Append(" to ").Append UInt64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit unsigned integer: 0 to 18446744073709551615
Dim sb As New System.Text.StringBuilder("The range of a 64-bit unsigned integer: ")
sb.Append(UInt64.MinValue).Append(" to ").Append(UInt64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit unsigned integer: 0 to 18446744073709551615

方法 Append(UInt64)UInt64.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(ReadOnlySpan<Char>)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將所指定唯讀字元範圍的字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(ReadOnlySpan<char> value);
public System.Text.StringBuilder Append (ReadOnlySpan<char> value);
member this.Append : ReadOnlySpan<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlySpan(Of Char)) As StringBuilder

參數

value
ReadOnlySpan<Char>

要附加的唯讀字元範圍。

傳回

完成附加作業之後,這個執行個體的參考。

適用於

Append(SByte)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

重要

此 API 不符合 CLS 規範。

將指定的 8 位元帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::SByte value);
[System.CLSCompliant(false)]
public System.Text.StringBuilder Append (sbyte value);
[<System.CLSCompliant(false)>]
member this.Append : sbyte -> System.Text.StringBuilder
Public Function Append (value As SByte) As StringBuilder

參數

value
SByte

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

屬性

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(SByte) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of an 8-bit signed integer: ");
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
let sb = StringBuilder "The range of an 8-bit signed integer: "
sb.Append(SByte.MinValue).Append(" to ").Append SByte.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of an 8-bit unsigned integer: -128 to 127
Dim sb As New System.Text.StringBuilder("The range of an 8-bit signed integer: ")
sb.Append(SByte.MinValue).Append(" to ").Append(SByte.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of an 8-bit unsigned integer: -128 to 127

方法 Append(SByte)SByte.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Boolean)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的布林 (Boolean) 值之字串表示附加至這個執行個體。

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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的 8 位元不帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::Byte value);
public System.Text.StringBuilder Append (byte value);
member this.Append : byte -> System.Text.StringBuilder
Public Function Append (value As Byte) As StringBuilder

參數

value
Byte

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Byte) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

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

Console.WriteLine("The byte array: {0}", sb.ToString());
// The example displays the following output:
//         The byte array: 16 132 27 253
let bytes = [| 16uy; 132uy; 27uy; 253uy |]
let sb = StringBuilder()

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

printfn $"The byte array: {sb}"
// The example displays the following output:
//         The byte array: 16 132 27 253
Dim bytes() As Byte = { 16, 132, 27, 253 }
Dim sb As New System.Text.StringBuilder()
For Each value In bytes
   sb.Append(value).Append(" ")         
Next
Console.WriteLine("The byte array: {0}", sb.ToString())
' The example displays the following output:
'         The byte array: 16 132 27 253

方法 Append(Byte)ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Char)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定 Char 物件的字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(char value);
public System.Text.StringBuilder Append (char value);
member this.Append : char -> System.Text.StringBuilder
Public Function Append (value As Char) As StringBuilder

參數

value
Char

要附加的 UTF-16 編碼字碼單位。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Char) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

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

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

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

printfn "Characters in the string:"
printfn $"  {sb}"
// The example displays the following output:
//    Characters in the string:
//       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'
Dim str As String = "Characters in a string."
Dim sb As New System.Text.StringBuilder()
For Each ch In str
   sb.Append(" '").Append(ch).Append("' ")
Next
Console.WriteLine("Characters in the string:")
Console.WriteLine("  {0}", sb)
' The example displays the following output:
'    Characters in the string:
'       'C'  'h'  'a'  'r'  'a'  'c'  't'  'e'  'r'  's'  ' '  'i'  'n'  ' '  'a'  ' '  's'  't' 'r'  'i'  'n'  'g'  '.'

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Decimal)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的小數位數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::Decimal value);
public System.Text.StringBuilder Append (decimal value);
member this.Append : decimal -> System.Text.StringBuilder
Public Function Append (value As Decimal) As StringBuilder

參數

value
Decimal

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Decimal) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

decimal value = 1346.19m;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1346.19*****
let value = 1346.19m
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1346.19*****
Dim value As Decimal = 1346.19d
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1346.19*****

方法 Append(Decimal)Decimal.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Double)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的雙精度浮點數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(double value);
public System.Text.StringBuilder Append (double value);
member this.Append : double -> System.Text.StringBuilder
Public Function Append (value As Double) As StringBuilder

參數

value
Double

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Double) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

double value = 1034769.47;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append('*', 5).Append(value).Append('*', 5);
Console.WriteLine(sb);
// The example displays the following output:
//       *****1034769.47*****
let value = 1034769.47
let sb = StringBuilder()
sb.Append('*', 5).Append(value).Append('*', 5) |> ignore
printfn $"{sb}"
// The example displays the following output:
//       *****1034769.47*****
Dim value As Double = 1034769.47
Dim sb As New System.Text.StringBuilder()
sb.Append("*"c, 5).Append(value).Append("*"c, 5)
Console.WriteLine(sb)
' The example displays the following output:
'       *****1034769.47*****

方法 Append(Double)Double.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Char[])

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
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)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的 16 位元帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(short value);
public System.Text.StringBuilder Append (short value);
member this.Append : int16 -> System.Text.StringBuilder
Public Function Append (value As Short) As StringBuilder

參數

value
Int16

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Int16) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 16-bit integer: ");
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
let sb = StringBuilder "The range of a 16-bit integer: "
sb.Append(Int16.MinValue).Append(" to ").Append Int16.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 16-bit integer: -32768 to 32767
Dim sb As New System.Text.StringBuilder("The range of a 16-bit integer: ")
sb.Append(Int16.MinValue).Append(" to ").Append(Int16.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 16-bit integer: -32768 to 32767

方法 Append(Int16)Int16.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Int32)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的 32 位元帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(int value);
public System.Text.StringBuilder Append (int value);
member this.Append : int -> System.Text.StringBuilder
Public Function Append (value As Integer) As StringBuilder

參數

value
Int32

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Int32) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
       System.Text.StringBuilder("The range of a 32-bit integer: ");
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
let sb = StringBuilder "The range of a 32-bit integer: "
sb.Append(Int32.MinValue).Append(" to ").Append Int32.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 32-bit integer: -2147483648 to 2147483647
Dim sb As New System.Text.StringBuilder("The range of a 32-bit integer: ")
sb.Append(Int32.MinValue).Append(" to ").Append(Int32.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 32-bit integer: -2147483648 to 2147483647

方法 Append(Int32)Int32.ToString(IFormatProvider) 呼叫 方法,以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

此實例的容量會視需要進行調整。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Int64)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定的 64 位元帶正負號的整數之字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(long value);
public System.Text.StringBuilder Append (long value);
member this.Append : int64 -> System.Text.StringBuilder
Public Function Append (value As Long) As StringBuilder

參數

value
Int64

要附加的值。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Int64) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。

System.Text.StringBuilder sb = new 
            System.Text.StringBuilder("The range of a 64-bit integer: ");
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue);
Console.WriteLine(sb);
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
let sb = StringBuilder "The range of a 64-bit integer: "
sb.Append(Int64.MinValue).Append(" to ").Append Int64.MaxValue |> ignore
printfn $"{sb}"
// The example displays the following output:
//       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807
Dim sb As New System.Text.StringBuilder("The range of a 64-bit integer: ")
sb.Append(Int64.MinValue).Append(" to ").Append(Int64.MaxValue)
Console.WriteLine(sb)
' The example displays the following output:
'       The range of a 64-bit integer:  -9223372036854775808 to 9223372036854775807

方法 Append(Int64) 會呼叫 , Int64.ToString(IFormatProvider) 以取得目前文化特性的字串表示 value 。 若要控制的格式 value設定,請呼叫 AppendFormat 方法。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化 StringBuilder 物件時,實例的StringBuilder長度和容量可以成長超過其 MaxCapacity 屬性的值。 特別是當您呼叫 Append(String)AppendFormat(String, Object) 方法以附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(Object)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將指定物件的字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(System::Object ^ value);
public System.Text.StringBuilder Append (object value);
public System.Text.StringBuilder Append (object? value);
member this.Append : obj -> System.Text.StringBuilder
Public Function Append (value As Object) As StringBuilder

參數

value
Object

要附加的物件。

傳回

完成附加作業之後,這個執行個體的參考。

例外狀況

加大此執行個體的值可能會超過 MaxCapacity

備註

方法 Append(Object) 會修改這個類別的現有實例;它不會傳回新的類別實例。 因此,您可以在現有的參考上呼叫方法或屬性,而不需要將傳回值指派給 StringBuilder 物件,如下列範例所示。 它會定義 Dog 類別、建立 Dog 物件,並對方法進行三次呼叫 Append ,以建立包含狗名稱和寵物的字串。

using System;

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

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

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

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

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

方法 Append(Object)Object.ToString 呼叫 方法,以取得的 value字串表示。 如果 為 valuenull,則不會對 StringBuilder 對象進行任何變更。

視需要調整此實例的容量。

給呼叫者的注意事項

在 .NET Core 和 .NET Framework 4.0 和更新版本中,當您藉由呼叫 StringBuilder(Int32, Int32) 建構函式來具現化StringBuilder物件時,實例的StringBuilder長度和容量都可以成長超過其 MaxCapacity 屬性的值。 當您呼叫 Append(String)AppendFormat(String, Object) 方法來附加小型字串時,就會發生此情況。

另請參閱

適用於

Append(ReadOnlyMemory<Char>)

來源:
StringBuilder.cs
來源:
StringBuilder.cs
來源:
StringBuilder.cs

將所指定唯讀字元記憶體區域的字串表示附加至這個執行個體。

public:
 System::Text::StringBuilder ^ Append(ReadOnlyMemory<char> value);
public System.Text.StringBuilder Append (ReadOnlyMemory<char> value);
member this.Append : ReadOnlyMemory<char> -> System.Text.StringBuilder
Public Function Append (value As ReadOnlyMemory(Of Char)) As StringBuilder

參數

value
ReadOnlyMemory<Char>

要附加的唯讀字元記憶體區域。

傳回

完成附加作業之後,這個執行個體的參考。

適用於