StringBuilder.Append Metódus

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Attribútumok

CLSCompliantAttribute

Kivételek

Megjegyzések

A Append(UInt16) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(UInt16) metódus meghívja a metódust a UInt16.ToString(IFormatProvider) sztring megjelenítésének lekéréséhez value. A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• UInt16

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Attribútumok

CLSCompliantAttribute

Kivételek

Megjegyzések

A Append(UInt64) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(UInt64) metódus meghívja a metódust, UInt64.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• UInt64

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Attribútumok

CLSCompliantAttribute SecurityCriticalAttribute

Kivételek

Megjegyzések

Ez a metódus hozzáfűzi valueCount az aktuális példány címétől value kezdődő karaktereket.

A Append(Char*, Int32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz.

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(String) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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.

Ha value igen null, a rendszer nem módosítja a módosításokat.

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• String

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value, int startIndex, int charCount);

public System.Text.StringBuilder Append(char[] value, int startIndex, int charCount);

public System.Text.StringBuilder Append(char[]? value, int startIndex, int charCount);

member this.Append : char[] * int * int -> System.Text.StringBuilder

Public Function Append (value As Char(), startIndex As Integer, charCount As Integer) As StringBuilder

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

Ez a metódus hozzáfűzi a megadott karaktertartományt value az aktuális példányhoz. Ha value igennull, és startIndexcount mindkettő nulla, akkor nem történik módosítás.

A Append(Char[], Int32, Int32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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.

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Char

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

Ez a metódus hozzáfűzi a megadott karaktertartományt value az aktuális példányhoz. Ha value igennull, és startIndexcount mindkettő nulla, akkor nem történik módosítás.

A Append(String, Int32, Int32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• String

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

public:
 System::Text::StringBuilder ^ Append(char value, int repeatCount);

public System.Text.StringBuilder Append(char value, int repeatCount);

member this.Append : char * int -> System.Text.StringBuilder

Public Function Append (value As Char, repeatCount As Integer) As StringBuilder

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Char, Int32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Char

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Single) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Single) metódus meghívja a metódust, Single.ToString hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Single

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Attribútumok

CLSCompliantAttribute

Kivételek

Megjegyzések

A Append(UInt32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(UInt32) metódus meghívja a UInt32.ToString metódust, hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• UInt32

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Attribútumok

CLSCompliantAttribute

Kivételek

Megjegyzések

A Append(SByte) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(SByte) metódus meghívja a metódust, SByte.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• SByte

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

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

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

Public Function Append (value As Boolean) As StringBuilder

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Boolean) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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.

A Append(Boolean) metódus meghívja a metódust a Boolean.ToString() sztring megjelenítésének lekéréséhez value. A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Boolean

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Byte) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Byte) metódus meghívja a metódust, ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Byte

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Char) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Char

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Decimal) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Decimal) metódus meghívja a metódust, Decimal.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Decimal

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Double) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Double) metódus meghívja a metódust, Double.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Double

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

public:
 System::Text::StringBuilder ^ Append(cli::array <char> ^ value);

public System.Text.StringBuilder Append(char[] value);

public System.Text.StringBuilder Append(char[]? value);

member this.Append : char[] -> System.Text.StringBuilder

Public Function Append (value As Char()) As StringBuilder

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

Ez a metódus a megadott tömb összes karakterét hozzáfűzi az aktuális példányhoz a megjelenő sorrendben value. Ha value igen null, a rendszer nem módosítja a módosításokat.

A Append(Char[]) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Int32) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Int32) metódus meghívja a metódust, Int32.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Int32

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Int64) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Int64) metódus meghívja az Int64.ToString(IFormatProvider) aktuális kultúra sztring-ábrázolásának lekérését value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Int64

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Object) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti. Definiál egy osztályt Dog , létrehoz egy Dog objektumot, és három hívást indít a Append metódushoz, hogy létrehozzon egy sztringet, amely tartalmazza a kutya nevét és fajtáját.

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

A Append(Object) metódus meghívja a metódust a Object.ToString sztring megjelenítésének lekéréséhez value. Ha value igen null, az objektumon nem történik StringBuilder módosítás.

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Object

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

Forrás:

StringBuilder.cs

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

Paraméterek

Válaszok

Hivatkozás erre a példányra a hozzáfűzési művelet befejezése után.

Kivételek

Megjegyzések

A Append(Int16) metódus módosítja az osztály meglévő példányát; nem ad vissza új osztálypéldányt. Emiatt meghívhat egy metódust vagy tulajdonságot a meglévő hivatkozáson, és nem kell hozzárendelnie a visszatérési értéket egy StringBuilder objektumhoz, ahogyan azt az alábbi példa szemlélteti.

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

A Append(Int16) metódus meghívja a metódust, Int16.ToString(IFormatProvider) hogy lekérje az aktuális kultúra sztring-ábrázolását value . A formázás valueszabályozásához hívja meg a metódust AppendFormat .

A példány kapacitása szükség szerint módosul.

Megjegyzések a hívókhoz

Az .NET Core-ban, valamint a .NET Framework 4.0-s és újabb verzióiban a StringBuilder objektum példányosításakor a StringBuilder(Int32, Int32) konstruktor meghívásával a StringBuilder példány hossza és kapacitása is meghaladhatja a MaxCapacity tulajdonság értékét. Ez különösen akkor fordulhat elő, ha kis sztringek összefűzésére hívja meg a Append(String) metódusokat és a AppendFormat(String, Object) metódusokat.

Lásd még

• Int16