StringBuilder.Append Metoda

Definice

Obor názvů:: System.Text

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: netstandard.dll

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Připojí k této instanci řetězcovou reprezentaci zadaného objektu.

Přetížení

Name	Description
Append(Rune)
Append(StringBuilder)	Připojí k této instanci řetězcovou reprezentaci zadaného tvůrce řetězců.
Append(StringBuilder+AppendInterpolatedStringHandler)	Připojí k této instanci zadaný interpolovaný řetězec.
Append(UInt16)	Připojí řetězcovou reprezentaci zadaného 16bitového celého čísla bez znaménka k této instanci.
Append(UInt64)	Připojí řetězcové vyjádření zadaného 64bitového celého čísla bez znaménka k této instanci.
Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Připojí zadaný interpolovaný řetězec k této instanci pomocí zadaného formátu.
Append(Char*, Int32)	Připojí k této instanci pole znaků Unicode začínající zadanou adresou.
Append(String)	Připojí kopii zadaného řetězce k této instanci.
Append(Char[], Int32, Int32)	Připojí k této instanci řetězcovou reprezentaci zadaného podarray znaků Unicode.
Append(String, Int32, Int32)	Připojí kopii zadaného podřetětěce k této instanci.
Append(StringBuilder, Int32, Int32)	Připojí kopii podřetězce v zadaném tvůrci řetězců k této instanci.
Append(Char, Int32)	Připojí k této instanci zadaný počet kopií řetězcové reprezentace znaku Unicode.
Append(Single)	Připojí k této instanci řetězcovou reprezentaci zadaného čísla s plovoucí desetinnou čárkou s jednoduchou přesností.
Append(UInt32)	Připojí řetězcovou reprezentaci zadaného 32bitového celého čísla bez znaménka k této instanci.
Append(ReadOnlySpan<Char>)	Připojí k této instanci řetězcovou reprezentaci zadaného rozsahu znaků jen pro čtení.
Append(SByte)	Připojí k této instanci řetězcovou reprezentaci zadaného 8bitového celého čísla se znaky signed.
Append(Boolean)	Připojí řetězcovou reprezentaci zadané logické hodnoty k této instanci.
Append(Byte)	Připojí řetězcovou reprezentaci zadaného 8bitového celého čísla bez znaménka k této instanci.
Append(Char)	Připojí k této instanci řetězcovou reprezentaci zadaného Char objektu.
Append(Decimal)	Připojí k této instanci řetězcovou reprezentaci zadaného desetinného čísla.
Append(Double)	Připojí k této instanci řetězcovou reprezentaci zadaného čísla s plovoucí desetinnou čárkou s dvojitou přesností.
Append(Char[])	Připojí k této instanci řetězcovou reprezentaci znaků Unicode v zadaném poli.
Append(Int32)	Připojí k této instanci řetězcovou reprezentaci zadaného 32bitového celého čísla se znaky signed.
Append(Int64)	Připojí k této instanci řetězcovou reprezentaci zadaného 64bitového celého čísla se znaky signed.
Append(Object)	Připojí k této instanci řetězcovou reprezentaci zadaného objektu.
Append(ReadOnlyMemory<Char>)	Připojí k této instanci řetězcovou reprezentaci zadané oblasti paměti jen pro čtení.
Append(Int16)	Připojí k této instanci řetězcovou reprezentaci zadaného 16bitového celého čísla se znaky signed.

Append(Rune)

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

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

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

Public Function Append (value As Rune) As StringBuilder

Parametry

value: Rune

Návraty

StringBuilder

Platí pro

Append(StringBuilder)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného tvůrce řetězců.

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

Parametry

value: StringBuilder

Tvůrce řetězců, který se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(StringBuilder+AppendInterpolatedStringHandler)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci zadaný interpolovaný řetězec.

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

Parametry

handler: StringBuilder.AppendInterpolatedStringHandler

Interpolovaný řetězec, který se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(UInt16)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Připojí řetězcovou reprezentaci zadaného 16bitového celého čísla bez znaménka k této instanci.

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

Parametry

value: UInt16

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(UInt16) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(UInt16) volá metodu UInt16.ToString(IFormatProvider) pro získání řetězcové reprezentace value. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

V .NET Core a v rozhraní .NET Framework 4.0 a novějších verzích při vytváření instance StringBuilder objektu voláním StringBuilder(Int32, Int32) konstruktoru může délka i kapacita StringBuilder instance růst nad hodnotu jeho MaxCapacity vlastnosti. K tomu může dojít zejména při volání Append(String) a AppendFormat(String, Object) metod pro připojení malých řetězců.

Viz také

UInt16

Platí pro

Append(UInt64)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Připojí řetězcové vyjádření zadaného 64bitového celého čísla bez znaménka k této instanci.

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

Parametry

value: UInt64

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(UInt64) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(UInt64) volá metodu UInt64.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

UInt64

Platí pro

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí zadaný interpolovaný řetězec k této instanci pomocí zadaného formátu.

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

Parametry

provider: IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

handler: StringBuilder.AppendInterpolatedStringHandler

Interpolovaný řetězec, který se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(Char*, Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Alternativa odpovídající specifikaci CLS: System.Text.StringBuilder.Append(Char[], Int32, Int32)

Připojí k této instanci pole znaků Unicode začínající zadanou adresou.

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

Parametry

value: Char*

Ukazatel na pole znaků.

valueCount: Int32

Počet znaků v poli.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Atributy: CLSCompliantAttribute SecurityCriticalAttribute

Výjimky

ArgumentOutOfRangeException

valueCount je menší než nula.

-or-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

NullReferenceException

value je ukazatel null.

Poznámky

Tato metoda připojí valueCount znaky začínající na adrese value k aktuální instanci.

Metoda Append(Char*, Int32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Platí pro

Append(String)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí kopii zadaného řetězce k této instanci.

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

Parametry

value: String

Řetězec, který se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(String) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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.

Pokud value ano null, neprovedou se žádné změny.

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

String

Platí pro

Append(Char[], Int32, Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného podarray znaků 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

Parametry

value: Char[]

Pole znaků.

startIndex: Int32

Počáteční pozice v value.

charCount: Int32

Počet znaků, které se mají připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentNullException

value je nulla startIndexcharCount nejsou nula.

ArgumentOutOfRangeException

charCount je menší než nula.

-or-

startIndex je menší než nula.

-or-

startIndex + charCount je větší než délka value.

-or-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Tato metoda připojí k aktuální instanci zadaný rozsah znaků value . Pokud value je null a startIndexcount oba jsou nula, neprovedou se žádné změny.

Metoda Append(Char[], Int32, Int32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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.

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Char

Platí pro

Append(String, Int32, Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí kopii zadaného podřetětěce k této instanci.

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

Parametry

value: String

Řetězec, který obsahuje podřetězce, který se má připojit.

startIndex: Int32

Počáteční pozice podřetězdce uvnitř value.

count: Int32

Počet znaků, které value se mají připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentNullException

value je nulla startIndexcount nejsou nula.

ArgumentOutOfRangeException

count menší než nula.

-or-

startIndex menší než nula.

-or-

startIndex + count je větší než délka value.

-or-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Tato metoda připojí k aktuální instanci zadaný rozsah znaků value . Pokud value je null a startIndexcount oba jsou nula, neprovedou se žádné změny.

Metoda Append(String, Int32, Int32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

String

Platí pro

Append(StringBuilder, Int32, Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí kopii podřetězce v zadaném tvůrci řetězců k této instanci.

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

Parametry

value: StringBuilder

Tvůrce řetězců, který obsahuje podřetězce, který se má připojit.

startIndex: Int32

Počáteční pozice podřetězdce uvnitř value.

count: Int32

Počet znaků, které value se mají připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(Char, Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci zadaný počet kopií řetězcové reprezentace znaku 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

Parametry

value: Char

Znak, který se má připojit.

repeatCount: Int32

Počet připojení value.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

repeatCount je menší než nula.

-or-

Zvětšení hodnoty této instance by překročilo MaxCapacity.

OutOfMemoryException

Nedostatek paměti.

Poznámky

Metoda Append(Char, Int32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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*****

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Char

Platí pro

Append(Single)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného čísla s plovoucí desetinnou čárkou s jednoduchou přesností.

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

Parametry

value: Single

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Single) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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*****

Metoda Append(Single) volá metodu Single.ToString pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Single

Platí pro

Append(UInt32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Připojí řetězcovou reprezentaci zadaného 32bitového celého čísla bez znaménka k této instanci.

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

Parametry

value: UInt32

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(UInt32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Volání Append(UInt32)UInt32.ToString metody získat řetězcové value vyjádření pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

UInt32

Platí pro

Append(ReadOnlySpan<Char>)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného rozsahu znaků jen pro čtení.

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

Parametry

value: ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, který se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(SByte)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Připojí k této instanci řetězcovou reprezentaci zadaného 8bitového celého čísla se znaky signed.

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

Parametry

value: SByte

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Atributy: CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(SByte) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(SByte) volá metodu SByte.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

SByte

Platí pro

Append(Boolean)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí řetězcovou reprezentaci zadané logické hodnoty k této instanci.

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

Parametry

value: Boolean

Logická hodnota, kterou chcete připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Boolean) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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.

Metoda Append(Boolean) volá metodu Boolean.ToString() pro získání řetězcové reprezentace value. Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Boolean

Platí pro

Append(Byte)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí řetězcovou reprezentaci zadaného 8bitového celého čísla bez znaménka k této instanci.

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

Parametry

value: Byte

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Byte) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(Byte) volá metodu ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Byte

Platí pro

Append(Char)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného Char objektu.

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

Parametry

value: Char

Připojte jednotku kódu s kódováním UTF-16.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Char) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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'  '.'

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Char

Platí pro

Append(Decimal)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného desetinného čísla.

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

Parametry

value: Decimal

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Decimal) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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*****

Metoda Append(Decimal) volá metodu Decimal.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Decimal

Platí pro

Append(Double)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného čísla s plovoucí desetinnou čárkou s dvojitou přesností.

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

Parametry

value: Double

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Double) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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*****

Metoda Append(Double) volá metodu Double.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Double

Platí pro

Append(Char[])

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci znaků Unicode v zadaném poli.

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

Parametry

value: Char[]

Pole znaků, které se mají připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Tato metoda připojí všechny znaky v zadaném poli k aktuální instanci ve stejném pořadí jako v value. Pokud value ano null, neprovedou se žádné změny.

Metoda Append(Char[]) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Platí pro

Append(Int32)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného 32bitového celého čísla se znaky signed.

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

Parametry

value: Int32

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Int32) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(Int32) volá metodu Int32.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Int32

Platí pro

Append(Int64)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného 64bitového celého čísla se znaky signed.

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

Parametry

value: Int64

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Int64) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(Int64) volá Int64.ToString(IFormatProvider) k získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Int64

Platí pro

Append(Object)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného objektu.

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

Parametry

value: Object

Objekt, který chcete připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Object) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad. Definuje Dog třídu, vytvoří Dog objekt a provede tři volání Append metody k vytvoření řetězce, který obsahuje jméno a plemena psa.

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

Metoda Append(Object) volá metodu Object.ToString pro získání řetězcové reprezentace value. Pokud value ano null, neprovedou se žádné změny objektu StringBuilder .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Object

Platí pro

Append(ReadOnlyMemory<Char>)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadané oblasti paměti jen pro čtení.

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

Parametry

value: ReadOnlyMemory<Char>

Oblast paměti jen pro čtení, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Platí pro

Append(Int16)

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Zdroj:: StringBuilder.cs

Připojí k této instanci řetězcovou reprezentaci zadaného 16bitového celého čísla se znaky signed.

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

Parametry

value: Int16

Hodnota, která se má připojit.

Návraty

StringBuilder

Odkaz na tuto instanci po dokončení operace připojení.

Výjimky

ArgumentOutOfRangeException

Zvětšení hodnoty této instance by překročilo MaxCapacity.

Poznámky

Metoda Append(Int16) upraví existující instanci této třídy; nevrací novou instanci třídy. Z tohoto důvodu můžete volat metodu nebo vlastnost existujícího odkazu a nemusíte přiřazovat návratovou hodnotu k objektu StringBuilder , jak ukazuje následující příklad.

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

Metoda Append(Int16) volá metodu Int16.ToString(IFormatProvider) pro získání řetězcové value reprezentace pro aktuální jazykovou verzi. Chcete-li řídit formátování value, zavolejte metodu AppendFormat .

Kapacita této instance se podle potřeby upraví.

Poznámky pro volající

Viz také

Int16

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

StringBuilder.Append Metoda

Definice

Přetížení

Append(Rune)

Parametry

Návraty

Platí pro

Append(StringBuilder)

Parametry

Návraty

Platí pro

Append(StringBuilder+AppendInterpolatedStringHandler)

Parametry

Návraty

Platí pro

Append(UInt16)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(UInt64)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parametry

Návraty

Platí pro

Append(Char*, Int32)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Platí pro

Append(String)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(Char[], Int32, Int32)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(String, Int32, Int32)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(StringBuilder, Int32, Int32)

Parametry

Návraty

Platí pro

Append(Char, Int32)

Parametry

Návraty

Výjimky

Poznámky

Poznámky pro volající

Viz také

Platí pro

Append(Single)