StringBuilder.Append Metod

Definition

Lägger till strängrepresentationen av ett angivet objekt i den här instansen.

Överlagringar

Name Description
Append(Rune)
Append(StringBuilder)

Lägger till strängrepresentationen av en angiven strängbyggare i den här instansen.

Append(StringBuilder+AppendInterpolatedStringHandler)

Lägger till den angivna interpolerade strängen i den här instansen.

Append(UInt16)

Lägger till strängrepresentationen av ett angivet 16-bitars osignerat heltal i den här instansen.

Append(UInt64)

Lägger till strängrepresentationen av ett angivet 64-bitars osignerat heltal i den här instansen.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Lägger till den angivna interpolerade strängen i den här instansen med det angivna formatet.

Append(Char*, Int32)

Lägger till en matris med Unicode-tecken som börjar på en angiven adress i den här instansen.

Append(String)

Lägger till en kopia av den angivna strängen i den här instansen.

Append(Char[], Int32, Int32)

Lägger till strängrepresentationen av en angiven underordning med Unicode-tecken i den här instansen.

Append(String, Int32, Int32)

Lägger till en kopia av en angiven delsträng i den här instansen.

Append(StringBuilder, Int32, Int32)

Lägger till en kopia av en delsträng i en angiven strängbyggare i den här instansen.

Append(Char, Int32)

Lägger till ett angivet antal kopior av strängrepresentationen av ett Unicode-tecken i den här instansen.

Append(Single)

Lägger till strängrepresentationen av ett angivet flyttal med enkel precision i den här instansen.

Append(UInt32)

Lägger till strängrepresentationen av ett angivet 32-bitars osignerat heltal i den här instansen.

Append(ReadOnlySpan<Char>)

Lägger till strängrepresentationen av ett angivet skrivskyddat teckenintervall i den här instansen.

Append(SByte)

Lägger till strängrepresentationen av ett angivet 8-bitars signerat heltal i den här instansen.

Append(Boolean)

Lägger till strängrepresentationen av ett angivet booleskt värde i den här instansen.

Append(Byte)

Lägger till strängrepresentationen av ett angivet 8-bitars osignerat heltal i den här instansen.

Append(Char)

Lägger till strängrepresentationen av ett angivet Char objekt i den här instansen.

Append(Decimal)

Lägger till strängrepresentationen av ett angivet decimaltal i den här instansen.

Append(Double)

Lägger till strängrepresentationen av ett angivet flyttal med dubbel precision i den här instansen.

Append(Char[])

Lägger till strängrepresentationen av Unicode-tecknen i en angiven matris i den här instansen.

Append(Int32)

Lägger till strängrepresentationen av ett angivet 32-bitars signerat heltal i den här instansen.

Append(Int64)

Lägger till strängrepresentationen av ett angivet 64-bitars signerat heltal i den här instansen.

Append(Object)

Lägger till strängrepresentationen av ett angivet objekt i den här instansen.

Append(ReadOnlyMemory<Char>)

Lägger till strängrepresentationen av en angiven skrivskyddad teckenminnesregion i den här instansen.

Append(Int16)

Lägger till strängrepresentationen av ett angivet 16-bitars signerat heltal i den här instansen.

Append(Rune)

Källa:
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

Parametrar

value
Rune

Returer

Gäller för

Append(StringBuilder)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av en angiven strängbyggare i den här instansen.

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

Parametrar

value
StringBuilder

Strängverktyget som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(StringBuilder+AppendInterpolatedStringHandler)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till den angivna interpolerade strängen i den här instansen.

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

Parametrar

handler
StringBuilder.AppendInterpolatedStringHandler

Den interpolerade strängen som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(UInt16)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Lägger till strängrepresentationen av ett angivet 16-bitars osignerat heltal i den här instansen.

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

Parametrar

value
UInt16

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Attribut

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(UInt16) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(UInt16) anropar UInt16.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(UInt64)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Lägger till strängrepresentationen av ett angivet 64-bitars osignerat heltal i den här instansen.

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

Parametrar

value
UInt64

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Attribut

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(UInt64) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(UInt64) anropar UInt64.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till den angivna interpolerade strängen i den här instansen med det angivna formatet.

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

Parametrar

provider
IFormatProvider

Ett objekt som tillhandahåller kulturspecifik formateringsinformation.

handler
StringBuilder.AppendInterpolatedStringHandler

Den interpolerade strängen som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(Char*, Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Alternativ som uppfyller CLS
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Lägger till en matris med Unicode-tecken som börjar på en angiven adress i den här instansen.

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

Parametrar

value
Char*

En pekare till en matris med tecken.

valueCount
Int32

Antalet tecken i matrisen.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Attribut

Undantag

valueCount är mindre än noll.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

value är en null-pekare.

Kommentarer

Den här metoden lägger till valueCount tecken som börjar vid adressen value till den aktuella instansen.

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Char*, Int32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Gäller för

Append(String)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till en kopia av den angivna strängen i den här instansen.

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

Parametrar

value
String

Strängen som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(String) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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.

Om value är nullgörs inga ändringar.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Char[], Int32, Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av en angiven underordning med Unicode-tecken i den här instansen.

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

Parametrar

value
Char[]

En teckenmatris.

startIndex
Int32

Startpositionen i value.

charCount
Int32

Antalet tecken som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

value är null, och startIndex och charCount är inte noll.

charCount är mindre än noll.

-eller-

startIndex är mindre än noll.

-eller-

startIndex + charCount är större än längden på value.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Den här metoden lägger till det angivna teckenintervallet i value den aktuella instansen. Om value både är null och startIndex är count noll görs inga ändringar.

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Char[], Int32, Int32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(String, Int32, Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till en kopia av en angiven delsträng i den här instansen.

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

Parametrar

value
String

Strängen som innehåller delsträngen som ska läggas till.

startIndex
Int32

Startpositionen för delsträngen i value.

count
Int32

Antalet tecken som value ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

value är null, och startIndex och count är inte noll.

count mindre än noll.

-eller-

startIndex mindre än noll.

-eller-

startIndex + count är större än längden på value.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Den här metoden lägger till det angivna teckenintervallet i value den aktuella instansen. Om value både är null och startIndex är count noll görs inga ändringar.

Metoden ändrar den befintliga instansen av den här klassen. Den Append(String, Int32, Int32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(StringBuilder, Int32, Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till en kopia av en delsträng i en angiven strängbyggare i den här instansen.

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

Parametrar

value
StringBuilder

Strängverktyget som innehåller delsträngen som ska läggas till.

startIndex
Int32

Startpositionen för delsträngen i value.

count
Int32

Antalet tecken som value ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(Char, Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till ett angivet antal kopior av strängrepresentationen av ett Unicode-tecken i den här instansen.

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

Parametrar

value
Char

Tecknet som ska läggas till.

repeatCount
Int32

Antalet gånger som ska läggas valuetill .

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

repeatCount är mindre än noll.

-eller-

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Slut på minne.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Char, Int32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Single)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet flyttal med enkel precision i den här instansen.

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

Parametrar

value
Single

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Single) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Single) anropar Single.ToString metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(UInt32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Lägger till strängrepresentationen av ett angivet 32-bitars osignerat heltal i den här instansen.

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

Parametrar

value
UInt32

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Attribut

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(UInt32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Anropar Append(UInt32)UInt32.ToString metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(ReadOnlySpan<Char>)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet skrivskyddat teckenintervall i den här instansen.

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

Parametrar

value
ReadOnlySpan<Char>

Det skrivskyddade teckenintervallet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(SByte)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Viktigt!

Detta API uppfyller inte CLS.

Lägger till strängrepresentationen av ett angivet 8-bitars signerat heltal i den här instansen.

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

Parametrar

value
SByte

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Attribut

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(SByte) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(SByte) anropar SByte.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Boolean)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet booleskt värde i den här instansen.

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

Parametrar

value
Boolean

Det booleska värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Boolean) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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.

Metoden Append(Boolean) anropar Boolean.ToString() metoden för att hämta strängrepresentationen av value. Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Byte)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet 8-bitars osignerat heltal i den här instansen.

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

Parametrar

value
Byte

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Byte) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Byte) anropar ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Char)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet Char objekt i den här instansen.

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

Parametrar

value
Char

DEN UTF-16-kodade kodenheten som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Char) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Decimal)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet decimaltal i den här instansen.

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

Parametrar

value
Decimal

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Decimal) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Decimal) anropar Decimal.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Double)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet flyttal med dubbel precision i den här instansen.

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

Parametrar

value
Double

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Double) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Double) anropar Double.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Char[])

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av Unicode-tecknen i en angiven matris i den här instansen.

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

Parametrar

value
Char[]

Matrisen med tecken som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Den här metoden lägger till alla tecken i den angivna matrisen till den aktuella instansen i samma ordning som de visas i value. Om value är nullgörs inga ändringar.

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Char[]) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Gäller för

Append(Int32)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet 32-bitars signerat heltal i den här instansen.

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

Parametrar

value
Int32

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Int32) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Int32) anropar Int32.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Int64)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet 64-bitars signerat heltal i den här instansen.

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

Parametrar

value
Int64

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Int64) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Int64) anropar Int64.ToString(IFormatProvider) för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(Object)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet objekt i den här instansen.

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

Parametrar

value
Object

Objektet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Object) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel. Den definierar en Dog klass, skapar ett Dog objekt och gör tre anrop till Append metoden för att skapa en sträng som innehåller hundens namn och ras.

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

Metoden Append(Object) anropar Object.ToString metoden för att hämta strängrepresentationen av value. Om value är nullgörs inga ändringar i objektet StringBuilder .

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för

Append(ReadOnlyMemory<Char>)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av en angiven skrivskyddad teckenminnesregion i den här instansen.

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

Parametrar

value
ReadOnlyMemory<Char>

Den skrivskyddade teckenminnesregion som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Gäller för

Append(Int16)

Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs
Källa:
StringBuilder.cs

Lägger till strängrepresentationen av ett angivet 16-bitars signerat heltal i den här instansen.

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

Parametrar

value
Int16

Värdet som ska läggas till.

Returer

En referens till den här instansen när tilläggsåtgärden har slutförts.

Undantag

Om värdet för den här instansen förstoras skulle det överstiga MaxCapacity.

Kommentarer

Metoden ändrar den befintliga instansen av den här klassen. Den Append(Int16) returnerar inte en ny klassinstans. Därför kan du anropa en metod eller egenskap för den befintliga referensen och du behöver inte tilldela returvärdet till ett StringBuilder objekt, vilket visas i följande exempel.

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

Metoden Append(Int16) anropar Int16.ToString(IFormatProvider) metoden för att hämta strängrepresentationen av value för den aktuella kulturen. Om du vill styra formateringen av valueanropar du AppendFormat metoden.

Kapaciteten för den här instansen justeras efter behov.

Anteckningar till anropare

När du i .NET Core och i .NET Framework 4.0 och senare versioner instansierar objektet StringBuilder genom att anropa konstruktorn StringBuilder(Int32, Int32) kan både längden och kapaciteten för instansen StringBuilder växa utöver värdet för dess egenskap MaxCapacity. Detta kan inträffa särskilt när du anropar Append(String) metoderna och AppendFormat(String, Object) för att lägga till små strängar.

Se även

Gäller för