Udostępnij za pośrednictwem


StringBuilder.Append Metoda

Definicja

Dołącza do tego wystąpienia reprezentację ciągu określonego obiektu.

Przeciążenia

Append(StringBuilder)

Dołącza do tego wystąpienia reprezentację ciągu określonego konstruktora ciągów.

Append(StringBuilder+AppendInterpolatedStringHandler)

Dołącza określony ciąg interpolowany do tego wystąpienia.

Append(UInt16)

Dołącza do tego wystąpienia reprezentację ciągu określonej 16-bitowej liczby całkowitej bez znaku.

Append(UInt32)

Dołącza do tego wystąpienia reprezentację ciągu określonej 32-bitowej liczby całkowitej bez znaku.

Append(Char, Int32)

Dołącza określoną liczbę kopii ciągu reprezentującego znak Unicode do tego wystąpienia.

Append(Char[], Int32, Int32)

Dołącza do tego wystąpienia reprezentację ciągu określonego podtablicy znaków Unicode.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Dołącza określony ciąg interpolowany do tego wystąpienia przy użyciu określonego formatu.

Append(String)

Dołącza kopię określonego ciągu do tego wystąpienia.

Append(String, Int32, Int32)

Dołącza kopię określonego podciągu do tego wystąpienia.

Append(StringBuilder, Int32, Int32)

Dołącza kopię podciągów w ramach określonego konstruktora ciągów do tego wystąpienia.

Append(Char*, Int32)

Dołącza tablicę znaków Unicode rozpoczynających się od określonego adresu do tego wystąpienia.

Append(Single)

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby zmiennoprzecinkowa o pojedynczej precyzji.

Append(UInt64)

Dołącza do tego wystąpienia reprezentację ciągu określonej 64-bitowej liczby całkowitej bez znaku.

Append(ReadOnlySpan<Char>)

Dołącza do tego wystąpienia reprezentację ciągu określonego zakresu znaków tylko do odczytu.

Append(SByte)

Dołącza do tego wystąpienia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem.

Append(Boolean)

Dołącza do tego wystąpienia reprezentację ciągu określonej wartości logicznej.

Append(Byte)

Dołącza do tego wystąpienia reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku.

Append(Char)

Dołącza do tego wystąpienia reprezentację ciągu określonego Char obiektu.

Append(Decimal)

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby dziesiętnej.

Append(Double)

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby zmiennoprzecinkowa o podwójnej precyzji.

Append(Char[])

Dołącza do tego wystąpienia reprezentację ciągów znaków Unicode w określonej tablicy.

Append(Int16)

Dołącza do tego wystąpienia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem.

Append(Int32)

Dołącza do tego wystąpienia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem.

Append(Int64)

Dołącza do tego wystąpienia reprezentację ciągu określonej 64-bitowej liczby całkowitej ze znakiem.

Append(Object)

Dołącza do tego wystąpienia reprezentację ciągu określonego obiektu.

Append(ReadOnlyMemory<Char>)

Dołącza do tego wystąpienia reprezentację ciągu określonego regionu pamięci znaków tylko do odczytu.

Append(StringBuilder)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonego konstruktora ciągów.

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

Konstruktor ciągów do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy

Append(StringBuilder+AppendInterpolatedStringHandler)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza określony ciąg interpolowany do tego wystąpienia.

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

Ciąg interpolowany do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy

Append(UInt16)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dołącza do tego wystąpienia reprezentację ciągu określonej 16-bitowej liczby całkowitej bez znaku.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Atrybuty

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(UInt16) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę UInt16.ToString(IFormatProvider) , aby uzyskać reprezentację valueciągu . Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(UInt32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dołącza do tego wystąpienia reprezentację ciągu określonej 32-bitowej liczby całkowitej bez znaku.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Atrybuty

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(UInt32) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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

Metoda Append(UInt32) wywołuje metodę UInt32.ToString , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Char, Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza określoną liczbę kopii ciągu reprezentującego znak Unicode do tego wystąpienia.

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 do dołączenia.

repeatCount
Int32

Liczba razy do dołączenia value.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Parametr repeatCount ma wartość niższą niż zero.

-lub-

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Za mało pamięci.

Uwagi

Metoda Append(Char, Int32) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Char[], Int32, Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza reprezentację ciągu określonej podarray znaków Unicode do tego wystąpienia.

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

Tablica znaków.

startIndex
Int32

Pozycja początkowa w elemecie value.

charCount
Int32

Liczba znaków do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

value to null, i startIndexcharCount nie są zerowe.

Parametr charCount ma wartość niższą niż zero.

-lub-

Parametr startIndex ma wartość niższą niż zero.

-lub-

startIndex + charCount jest większa niż długość obiektu value.

-lub-

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Ta metoda dołącza określony zakres znaków do value bieżącego wystąpienia. Jeśli value wartość jest null i countstartIndex jest równa zero, nie zostaną wprowadzone żadne zmiany.

Metoda Append(Char[], Int32, Int32) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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.

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza określony ciąg interpolowany do tego wystąpienia przy użyciu określonego formatu.

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

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.

handler
StringBuilder.AppendInterpolatedStringHandler

Ciąg interpolowany do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy

Append(String)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza kopię określonego ciągu do tego wystąpienia.

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

Ciąg do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Metoda Append(String) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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.

Jeśli value wartość to null, nie zostaną wprowadzone żadne zmiany.

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(String, Int32, Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza kopię określonego podciągu do tego wystąpienia.

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

Ciąg zawierający podciąg do dołączenia.

startIndex
Int32

Pozycja początkowa podciągu w obrębie value.

count
Int32

Liczba znaków w pliku do value dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

value to null, i startIndexcount nie są zerowe.

count mniejsze niż zero.

-lub-

startIndex mniejsze niż zero.

-lub-

startIndex + count jest większa niż długość obiektu value.

-lub-

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Ta metoda dołącza określony zakres znaków do value bieżącego wystąpienia. Jeśli value wartość jest null i countstartIndex jest równa zero, nie zostaną wprowadzone żadne zmiany.

Metoda Append(String, Int32, Int32) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(StringBuilder, Int32, Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza kopię podciągów w określonym konstruktorze ciągów do tego wystąpienia.

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

Konstruktor ciągów zawierający podciąg do dołączenia.

startIndex
Int32

Pozycja początkowa podciągu w obrębie value.

count
Int32

Liczba znaków w pliku do value dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy

Append(Char*, Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Alternatywa zgodna ze specyfikacją CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Dołącza tablicę znaków Unicode rozpoczynających się od określonego adresu do tego wystąpienia.

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*

Wskaźnik do tablicy znaków.

valueCount
Int32

Liczba znaków w tablicy.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Atrybuty

Wyjątki

Parametr valueCount ma wartość niższą niż zero.

-lub-

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

value jest wskaźnikiem o wartości null.

Uwagi

Ta metoda dołącza znaki rozpoczynające valueCount się od adresu value do bieżącego wystąpienia.

Metoda Append(Char*, Int32) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu.

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Dotyczy

Append(Single)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby zmiennoprzecinkowej o określonej precyzji.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Metoda Append(Single) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Single.ToString , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie metody value, wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(UInt64)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dołącza reprezentację ciągu określonej 64-bitowej liczby całkowitej bez znaku do tego wystąpienia.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Atrybuty

Wyjątki

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Metoda Append(UInt64) modyfikuje istniejące wystąpienie tej klasy. Nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę UInt64.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie metody value, wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowywana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(ReadOnlySpan<Char>)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza reprezentację ciągu określonego zakresu znaków tylko do odczytu do tego wystąpienia.

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>

Zakres znaków tylko do odczytu do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy

Append(SByte)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Dołącza do tego wystąpienia reprezentację ciągu określonej 8-bitowej liczby całkowitej ze znakiem.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Atrybuty

Wyjątki

Rozszerzenie wartości tego wystąpienia spowoduje przekroczenie wartości MaxCapacity.

Uwagi

Metoda Append(SByte) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę SByte.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

W programie .NET Core i w wersji .NET Framework 4.0 i nowszych podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora długość i pojemność StringBuilder wystąpienia wystąpienia mogą wzrosnąć poza wartość jej MaxCapacity właściwości. Może się to zdarzyć szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Boolean)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej wartości logicznej.

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

Wartość logiczna do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Boolean) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Boolean.ToString() , aby uzyskać reprezentację valueciągu . Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Byte)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej 8-bitowej liczby całkowitej bez znaku.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Byte) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Char)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonego Char obiektu.

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

Jednostka kodu zakodowana w formacie UTF-16 do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Char) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Decimal)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby dziesiętnej.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Decimal) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Decimal.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Double)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej liczby zmiennoprzecinkowa o podwójnej precyzji.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Double) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Double.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Char[])

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągów znaków Unicode w określonej tablicy.

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

Tablica znaków do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Ta metoda dołącza wszystkie znaki w określonej tablicy do bieżącego wystąpienia w takiej samej kolejności, jak w pliku value. Jeśli value parametr ma nullwartość , żadne zmiany nie zostaną wprowadzone.

Metoda Append(Char[]) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Dotyczy

Append(Int16)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej 16-bitowej liczby całkowitej ze znakiem.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Int16) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Int16.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Int32)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej 32-bitowej liczby całkowitej ze znakiem.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Int32) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę Int32.ToString(IFormatProvider) , aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Int64)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonej 64-bitowej liczby całkowitej ze znakiem.

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

Wartość do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Int64) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie.

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) wywołuje metodę , Int64.ToString(IFormatProvider) aby uzyskać reprezentację value ciągu dla bieżącej kultury. Aby kontrolować formatowanie valueelementu , wywołaj metodę AppendFormat .

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(Object)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonego obiektu.

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

Obiekt do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Wyjątki

Rozszerzenie wartości tego wystąpienia spowodowałoby przekroczenie MaxCapacitywartości .

Uwagi

Metoda Append(Object) modyfikuje istniejące wystąpienie tej klasy; nie zwraca nowego wystąpienia klasy. W związku z tym można wywołać metodę lub właściwość w istniejącym odwołaniu i nie trzeba przypisywać wartości zwracanej do StringBuilder obiektu, jak pokazano w poniższym przykładzie. Definiuje klasę Dog , tworzy Dog obiekt i wykonuje trzy wywołania Append metody w celu utworzenia ciągu zawierającego nazwę i rasę 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) wywołuje metodę Object.ToString , aby uzyskać reprezentację valueciągu . Jeśli value parametr ma nullwartość , żadne zmiany nie są wprowadzane do StringBuilder obiektu.

Pojemność tego wystąpienia jest dostosowana zgodnie z potrzebami.

Uwagi dotyczące wywoływania

Na platformie .NET Core i w .NET Framework 4.0 i nowszych wersjach podczas tworzenia wystąpienia StringBuilder obiektu przez wywołanie StringBuilder(Int32, Int32) konstruktora zarówno długość, jak i pojemność StringBuilder wystąpienia mogą wzrosnąć poza wartość jego MaxCapacity właściwości. Może to wystąpić szczególnie w przypadku wywołania Append(String) metod i AppendFormat(String, Object) w celu dołączenia małych ciągów.

Zobacz też

Dotyczy

Append(ReadOnlyMemory<Char>)

Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs
Źródło:
StringBuilder.cs

Dołącza do tego wystąpienia reprezentację ciągu określonego regionu pamięci znaków tylko do odczytu.

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>

Region pamięci tylko do odczytu do dołączenia.

Zwraca

Odwołanie do tego wystąpienia po zakończeniu operacji dołączania.

Dotyczy