Aracılığıyla paylaş


StringBuilder.Append Yöntem

Tanım

Belirtilen nesnenin dize gösterimini bu örneğe ekler.

Aşırı Yüklemeler

Append(StringBuilder)

Belirtilen dize oluşturucusunun dize gösterimini bu örneğe ekler.

Append(StringBuilder+AppendInterpolatedStringHandler)

Belirtilen ilişkilendirilmiş dizeyi bu örneğe ekler.

Append(UInt16)

Belirtilen 16 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

Append(UInt32)

Belirtilen 32 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

Append(Char, Int32)

Unicode karakterinin dize gösteriminin belirtilen sayıda kopyasını bu örneğe ekler.

Append(Char[], Int32, Int32)

Belirtilen Unicode karakterlerinin dize gösterimini bu örneğe ekler.

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Belirtilen biçimi kullanarak belirtilen ilişkilendirilmiş dizeyi bu örneğe ekler.

Append(String)

Belirtilen dizenin bir kopyasını bu örneğe ekler.

Append(String, Int32, Int32)

Belirtilen alt dizenin bir kopyasını bu örneğe ekler.

Append(StringBuilder, Int32, Int32)

Belirtilen dize oluşturucusunun içindeki bir alt dizenin kopyasını bu örneğe ekler.

Append(Char*, Int32)

Belirtilen bir adreste başlayan unicode karakter dizisini bu örneğe ekler.

Append(Single)

Belirtilen tek duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.

Append(UInt64)

Belirtilen 64 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

Append(ReadOnlySpan<Char>)

Belirtilen salt okunur karakter aralığının dize gösterimini bu örneğe ekler.

Append(SByte)

Belirtilen 8 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

Append(Boolean)

Belirtilen Boole değerinin dize gösterimini bu örneğe ekler.

Append(Byte)

Belirtilen 8 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

Append(Char)

Belirtilen Char nesnenin dize gösterimini bu örneğe ekler.

Append(Decimal)

Belirtilen ondalık sayının dize gösterimini bu örneğe ekler.

Append(Double)

Belirtilen çift duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.

Append(Char[])

Belirtilen dizideki Unicode karakterlerinin dize gösterimini bu örneğe ekler.

Append(Int16)

Belirtilen 16 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

Append(Int32)

Belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

Append(Int64)

Belirtilen 64 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

Append(Object)

Belirtilen nesnenin dize gösterimini bu örneğe ekler.

Append(ReadOnlyMemory<Char>)

Belirtilen salt okunur karakter bellek bölgesinin dize gösterimini bu örneğe ekler.

Append(StringBuilder)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen dize oluşturucusunun dize gösterimini bu örneğe ekler.

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

Parametreler

value
StringBuilder

Eklenecek dize oluşturucu.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır

Append(StringBuilder+AppendInterpolatedStringHandler)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen ilişkilendirilmiş dizeyi bu örneğe ekler.

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

Parametreler

handler
StringBuilder.AppendInterpolatedStringHandler

Eklenecek ilişkilendirilmiş dize.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır

Append(UInt16)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 16 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
UInt16

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(UInt16) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

Append(UInt16) yöntemi, dize gösterimini valuealmak için yöntemini çağırırUInt16.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(UInt32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 32 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
UInt32

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(UInt32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

geçerli Append(UInt32) kültür için dize gösterimini value almak için yöntemini çağırırUInt32.ToString. biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Char, Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Unicode karakterinin dize gösteriminin belirtilen sayıda kopyasını bu örneğe ekler.

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

Parametreler

value
Char

Eklenecek karakter.

repeatCount
Int32

eklenme valuesayısı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

repeatCount, sıfırdan küçüktür.

-veya-

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Bellek yetersiz.

Açıklamalar

Append(Char, Int32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Char[], Int32, Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen Unicode karakterlerinin dize gösterimini bu örneğe ekler.

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

Parametreler

value
Char[]

Bir karakter dizisi.

startIndex
Int32

içinde valuebaşlangıç konumu.

charCount
Int32

Eklenecek karakter sayısı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

value , nullve startIndexcharCount sıfır değildir.

charCount, sıfırdan küçüktür.

-veya-

startIndex, sıfırdan küçüktür.

-veya-

startIndex + charCount , uzunluğundan valuebüyüktür.

-veya-

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Bu yöntem, belirtilen karakter value aralığını geçerli örneğe ekler. ve ise null ve startIndexcount her ikisi de sıfırsavalue, hiçbir değişiklik yapılmaz.

Append(Char[], Int32, Int32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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.

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen ilişkilendirilmiş dizeyi belirtilen biçimi kullanarak bu örneğe ekler.

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

Parametreler

provider
IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne.

handler
StringBuilder.AppendInterpolatedStringHandler

Eklenecek ilişkilendirilmiş dize.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır

Append(String)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen dizenin bir kopyasını bu örneğe ekler.

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

Parametreler

value
String

Eklenecek dize.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Append(String) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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.

ise valuenull, hiçbir değişiklik yapılmaz.

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(String, Int32, Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen alt dizenin bir kopyasını bu örneğe ekler.

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

Parametreler

value
String

Eklenecek alt dizeyi içeren dize.

startIndex
Int32

alt dizenin içindeki valuebaşlangıç konumu.

count
Int32

eklenecek karakter value sayısı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

value , nullve startIndexcount sıfır değildir.

count sıfırdan küçük.

-veya-

startIndex sıfırdan küçük.

-veya-

startIndex + count , uzunluğundan valuebüyüktür.

-veya-

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Bu yöntem, belirtilen karakter value aralığını geçerli örneğe ekler. ve ise null ve startIndexcount her ikisi de sıfırsavalue, hiçbir değişiklik yapılmaz.

Append(String, Int32, Int32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(StringBuilder, Int32, Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen dize oluşturucusunun içindeki bir alt dizenin kopyasını bu örneğe ekler.

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

Parametreler

value
StringBuilder

Eklenecek alt dizeyi içeren dize oluşturucu.

startIndex
Int32

alt dizenin içindeki valuebaşlangıç konumu.

count
Int32

eklenecek karakter value sayısı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır

Append(Char*, Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif
System.Text.StringBuilder.Append(Char[], Int32, Int32)

Belirtilen bir adreste başlayan unicode karakter dizisini bu örneğe ekler.

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

Parametreler

value
Char*

Bir karakter dizisinin işaretçisi.

valueCount
Int32

Dizideki karakter sayısı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler

Özel durumlar

valueCount, sıfırdan küçüktür.

-veya-

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

value null işaretçidir.

Açıklamalar

Bu yöntem, adreste value başlayan karakterleri geçerli örneğe eklervalueCount.

Append(Char*, Int32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, mevcut başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Şunlara uygulanır

Append(Single)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen tek duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Single

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Append(Single) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Single) geçerli kültür için dize gösterimini value almak için yöntemini çağırırSingle.ToString. biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(UInt64)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 64 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
UInt64

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler

Özel durumlar

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Append(UInt64) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(UInt64) geçerli kültür için dize gösterimini value almak için yöntemini çağırırUInt64.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(ReadOnlySpan<Char>)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen salt okunur karakter aralığının dize gösterimini bu örneğe ekler.

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

Parametreler

value
ReadOnlySpan<Char>

Eklenecek salt okunur karakter aralığı.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır

Append(SByte)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 8 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
SByte

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Öznitelikler

Özel durumlar

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Append(SByte) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(SByte) geçerli kültür için dize gösterimini value almak için yöntemini çağırırSByte.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Boolean)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen Boole değerinin dize gösterimini bu örneğe ekler.

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

Parametreler

value
Boolean

Eklenecek Boole değeri.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Boolean) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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.

Append(Boolean) yöntemi, dize gösterimini valuealmak için yöntemini çağırırBoolean.ToString(). Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Byte)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen 8 bit işaretsiz tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Byte

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Byte) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Byte) geçerli kültür için dize gösterimini value almak için yöntemini çağırırToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Char)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen Char nesnenin dize gösterimini bu örneğe ekler.

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

Parametreler

value
Char

Eklenecek UTF-16 kodlanmış kod birimi.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Char) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Decimal)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen ondalık sayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Decimal

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Decimal) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Decimal) geçerli kültür için dize gösterimini value almak için yöntemini çağırırDecimal.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Double)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen çift duyarlıklı kayan nokta sayısının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Double

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Double) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Double) geçerli kültür için dize gösterimini value almak için yöntemini çağırırDouble.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Char[])

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen dizideki Unicode karakterlerinin dize gösterimini bu örneğe ekler.

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

Parametreler

value
Char[]

Eklenecek karakter dizisi.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Bu yöntem, belirtilen dizideki tüm karakterleri geçerli örneğe içinde valuegöründükleri sırayla ekler. ise valuenull, hiçbir değişiklik yapılmaz.

Append(Char[]) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Şunlara uygulanır

Append(Int16)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen 16 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Int16

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Int16) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Int16) geçerli kültür için dize gösterimini value almak için yöntemini çağırırInt16.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Int32)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen 32 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Int32

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Int32) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Int32) geçerli kültür için dize gösterimini value almak için yöntemini çağırırInt32.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Int64)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen 64 bit imzalı tamsayının dize gösterimini bu örneğe ekler.

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

Parametreler

value
Int64

Eklenecek değer.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerini büyütmek değerini aşacak MaxCapacity.

Açıklamalar

Append(Int64) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez.

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

yöntemi, Append(Int64) geçerli kültür için dize gösterimini value almak için öğesini çağırırInt64.ToString(IFormatProvider). biçimlendirmesini valuedenetlemek için yöntemini çağırın AppendFormat .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde, oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesne örneği oluşturduğunuzdaStringBuilder, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine uzayabilir. Bu, özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) oluşabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(Object)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen nesnenin dize gösterimini bu örneğe ekler.

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

Parametreler

value
Object

Eklenecek nesne.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

Bu örneğin değerinin büyükleştirilmesi değerini aşacak MaxCapacity.

Açıklamalar

Append(Object) yöntemi bu sınıfın mevcut örneğini değiştirir; yeni bir sınıf örneği döndürmez. Bu nedenle, var olan başvuruda bir yöntemi veya özelliği çağırabilirsiniz ve aşağıdaki örnekte gösterildiği gibi dönüş değerini bir StringBuilder nesneye atamanız gerekmez. Bir Dog sınıf tanımlar, bir Dog nesnesi oluşturur ve köpeğin adını ve cinsini Append içeren bir dize oluşturmak için yöntemine üç çağrı yapar.

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

Append(Object) yöntemi, dize gösterimini valuealmak için yöntemini çağırırObject.ToString. ise valuenullnesnesinde StringBuilder hiçbir değişiklik yapılmaz.

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerde oluşturucuyu çağırarak StringBuilder(Int32, Int32) nesnesinin örneğini StringBuilder oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerini aşabilir. Bu durum özellikle küçük dizeleri eklemek için ve AppendFormat(String, Object) yöntemlerini çağırdığınızda Append(String) ortaya çıkabilir.

Ayrıca bkz.

Şunlara uygulanır

Append(ReadOnlyMemory<Char>)

Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs
Kaynak:
StringBuilder.cs

Belirtilen salt okunur karakter bellek bölgesinin dize gösterimini bu örneğe ekler.

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

Parametreler

value
ReadOnlyMemory<Char>

Eklenecek salt okunur karakter bellek bölgesi.

Döndürülenler

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Şunlara uygulanır