StringBuilder Konstruktorer

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av StringBuilder klassen.

Överlagringar

Name	Description
StringBuilder()	Initierar en ny instans av StringBuilder klassen.
StringBuilder(Int32)	Initierar en ny instans av StringBuilder klassen med den angivna kapaciteten.
StringBuilder(String)	Initierar en ny instans av StringBuilder klassen med den angivna strängen.
StringBuilder(Int32, Int32)	Initierar en ny instans av StringBuilder klassen som börjar med en angiven kapacitet och kan växa till ett angivet maximum.
StringBuilder(String, Int32)	Initierar en ny instans av StringBuilder klassen med den angivna strängen och kapaciteten.
StringBuilder(String, Int32, Int32, Int32)	Initierar en ny instans av StringBuilder klassen från den angivna delsträngen och kapaciteten.

StringBuilder()

Initierar en ny instans av StringBuilder klassen.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn utan parametrar.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Kommentarer

Strängvärdet för den här instansen är inställt på String.Empty, och kapaciteten är inställd på den implementeringsspecifika standardkapaciteten.

Gäller för

StringBuilder(Int32)

Initierar en ny instans av StringBuilder klassen med den angivna kapaciteten.

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

Parametrar

capacity: Int32

Den föreslagna startstorleken för den här instansen.

Undantag

ArgumentOutOfRangeException

capacity är mindre än noll.

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn med en angiven kapacitet.

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

Kommentarer

Parametern capacity definierar det maximala antalet tecken som kan lagras i det minne som allokeras av den aktuella instansen. Dess värde tilldelas egenskapen Capacity . Om antalet tecken som ska lagras i den aktuella instansen överskrider det här capacity värdet StringBuilder allokerar objektet ytterligare minne för att lagra dem.

Strängvärdet för den här instansen är inställt på String.Empty. Om capacity är noll används den implementeringsspecifika standardkapaciteten.

Se även

Capacity

Gäller för

StringBuilder(String)

Initierar en ny instans av StringBuilder klassen med den angivna strängen.

public:
 StringBuilder(System::String ^ value);

public StringBuilder(string value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

Parametrar

value: String

Strängen som används för att initiera instansens värde. Om value är nullinnehåller den nya StringBuilder den tomma strängen (det vill: den innehåller Empty).

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn med den angivna strängen.

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

Kommentarer

Om value är nullinnehåller den nya StringBuilder den tomma strängen (det vill: den innehåller Empty).

Gäller för

StringBuilder(Int32, Int32)

Initierar en ny instans av StringBuilder klassen som börjar med en angiven kapacitet och kan växa till ett angivet maximum.

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder(int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

Parametrar

capacity: Int32

Den föreslagna startstorleken för StringBuilder.

maxCapacity: Int32

Det maximala antalet tecken som den aktuella strängen kan innehålla.

Undantag

ArgumentOutOfRangeException

maxCapacity är mindre än en, capacity är mindre än noll eller capacity större än maxCapacity.

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn med en angiven kapacitet och maximal kapacitet.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

Kommentarer

Om capacity är noll används den implementeringsspecifika standardkapaciteten.

Egenskapen maxCapacity definierar det maximala antalet tecken som den aktuella instansen kan innehålla. Dess värde tilldelas egenskapen MaxCapacity . Om antalet tecken som ska lagras i den aktuella instansen överskrider det här maxCapacity värdet StringBuilder allokerar objektet inte ytterligare minne, utan genererar i stället ett undantag.

Anteckningar till anropare

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

Se även

Gäller för

StringBuilder(String, Int32)

Initierar en ny instans av StringBuilder klassen med den angivna strängen och kapaciteten.

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder(string value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

Parametrar

value: String

Strängen som används för att initiera instansens värde. Om value är nullinnehåller den nya StringBuilder den tomma strängen (det vill: den innehåller Empty).

capacity: Int32

Den föreslagna startstorleken för StringBuilder.

Undantag

ArgumentOutOfRangeException

capacity är mindre än noll.

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn med en inledande sträng och en angiven kapacitet.

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

Kommentarer

Om capacity är noll används den implementeringsspecifika standardkapaciteten.

Se även

Capacity

Gäller för

StringBuilder(String, Int32, Int32, Int32)

Initierar en ny instans av StringBuilder klassen från den angivna delsträngen och kapaciteten.

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);

public StringBuilder(string value, int startIndex, int length, int capacity);

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

Parametrar

value: String

Strängen som innehåller den delsträng som används för att initiera värdet för den här instansen. Om value är nullinnehåller den nya StringBuilder den tomma strängen (det vill: den innehåller Empty).

startIndex: Int32

Positionen där value delsträngen börjar.

length: Int32

Antalet tecken i understrängen.

capacity: Int32

Den föreslagna startstorleken för StringBuilder.

Undantag

ArgumentOutOfRangeException

capacity är mindre än noll.

-eller-

startIndex plus length är inte en position inom value.

Exempel

I följande exempel visas hur du anropar StringBuilder konstruktorn med den angivna strängen.

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

Kommentarer

Om capacity är noll används den implementeringsspecifika standardkapaciteten.

Se även

Capacity

Gäller för

Feedback

Var den här sidan till hjälp?