StringBuilder.Append Yöntem

Başvuru

Tanım

Ad Alanı:: System.Text

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: netstandard.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

StringBuilder

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

StringBuilder

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

StringBuilder

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

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

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.

UInt16

Ş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

StringBuilder

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

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

UInt32

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

-veya-

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

OutOfMemoryException

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

Ayrıca bkz.

Char

Ş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

StringBuilder

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

Özel durumlar

ArgumentNullException

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

ArgumentOutOfRangeException

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.

Char

Ş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

StringBuilder

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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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.

String

Ş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

StringBuilder

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

Özel durumlar

ArgumentNullException

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

ArgumentOutOfRangeException

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

Ayrıca bkz.

String

Ş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

StringBuilder

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

StringBuilder

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

Öznitelikler: CLSCompliantAttribute SecurityCriticalAttribute

Özel durumlar

ArgumentOutOfRangeException

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

-veya-

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

NullReferenceException

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

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Single

Ş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

StringBuilder

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

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

UInt64

Ş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

StringBuilder

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

StringBuilder

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

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

SByte

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Boolean

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Byte

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Char

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Decimal

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Double

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Int16

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Int32

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Int64

Ş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

StringBuilder

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

Özel durumlar

ArgumentOutOfRangeException

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

Ayrıca bkz.

Object

Ş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

StringBuilder

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

Şunlara uygulanır

Aracılığıyla paylaş

StringBuilder.Append Yöntem

Tanım

Aşırı Yüklemeler

Append(StringBuilder)

Parametreler

Döndürülenler

Şunlara uygulanır

Append(StringBuilder+AppendInterpolatedStringHandler)

Parametreler

Döndürülenler

Şunlara uygulanır

Append(UInt16)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(UInt32)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(Char, Int32)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(Char[], Int32, Int32)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parametreler

Döndürülenler

Şunlara uygulanır

Append(String)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(String, Int32, Int32)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Ayrıca bkz.

Şunlara uygulanır

Append(StringBuilder, Int32, Int32)

Parametreler

Döndürülenler

Şunlara uygulanır

Append(Char*, Int32)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Arayanlara Notlar

Şunlara uygulanır

Append(Single)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar