StringBuilder.Append Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
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.
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.