StringBuilder Constructors

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de StringBuilder klasse.

Overloads

Name	Description
StringBuilder()	Initialiseert een nieuw exemplaar van de StringBuilder klasse.
StringBuilder(Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven capaciteit.
StringBuilder(String)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks.
StringBuilder(Int32, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse die begint met een opgegeven capaciteit en kan toenemen tot een opgegeven maximum.
StringBuilder(String, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks en capaciteit.
StringBuilder(String, Int32, Int32, Int32)	Initialiseert een nieuw exemplaar van de StringBuilder klasse op basis van de opgegeven subtekenreeks en capaciteit.

StringBuilder()

Initialiseert een nieuw exemplaar van de StringBuilder klasse.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor zonder parameters aanroept.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

Opmerkingen

De tekenreekswaarde van dit exemplaar is ingesteld op String.Emptyen de capaciteit wordt ingesteld op de implementatiespecifieke standaardcapaciteit.

Van toepassing op

StringBuilder(Int32)

Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven capaciteit.

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

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

Public Sub New (capacity As Integer)

Parameters

capacity: Int32

De voorgestelde begingrootte van dit exemplaar.

Uitzonderingen

ArgumentOutOfRangeException

capacity is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor aanroept met een opgegeven capaciteit.

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)

Opmerkingen

De capacity parameter definieert het maximum aantal tekens dat kan worden opgeslagen in het geheugen dat door het huidige exemplaar is toegewezen. De waarde wordt toegewezen aan de Capacity eigenschap. Als het aantal tekens dat moet worden opgeslagen in de huidige instantie deze capacity waarde overschrijdt, wijst het StringBuilder object extra geheugen toe om deze op te slaan.

De tekenreekswaarde van dit exemplaar is ingesteld op String.Empty. Als capacity dit nul is, wordt de standaardcapaciteit van de implementatie gebruikt.

Zie ook

Capacity

Van toepassing op

StringBuilder(String)

Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks.

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

public StringBuilder(string value);

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

Public Sub New (value As String)

Parameters

value: String

De tekenreeks die wordt gebruikt om de waarde van het exemplaar te initialiseren. Als value dat het is, bevat de nieuwe StringBuilder de lege tekenreeks (dat wil nullgezegd, het bevatEmpty).

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor aanroept met de opgegeven tekenreeks.

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)

Opmerkingen

Als value dat het is, bevat de nieuwe StringBuilder de lege tekenreeks (dat wil nullgezegd, het bevatEmpty).

Van toepassing op

StringBuilder(Int32, Int32)

Initialiseert een nieuw exemplaar van de StringBuilder klasse die begint met een opgegeven capaciteit en kan toenemen tot een opgegeven 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)

Parameters

capacity: Int32

De voorgestelde begingrootte van de StringBuilder.

maxCapacity: Int32

Het maximum aantal tekens dat de huidige tekenreeks mag bevatten.

Uitzonderingen

ArgumentOutOfRangeException

maxCapacity is kleiner dan één, capacity kleiner dan nul of capacity groter dan maxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor aanroept met een opgegeven capaciteit en maximale capaciteit.

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)

Opmerkingen

Als capacity dit nul is, wordt de standaardcapaciteit van de implementatie gebruikt.

De maxCapacity eigenschap definieert het maximum aantal tekens dat het huidige exemplaar kan bevatten. De waarde wordt toegewezen aan de MaxCapacity eigenschap. Als het aantal tekens dat moet worden opgeslagen in de huidige instantie deze maxCapacity waarde overschrijdt, wijst het StringBuilder object geen extra geheugen toe, maar wordt er een uitzondering gegenereerd.

Notities voor bellers

Wanneer u in .NET Core en in de .NET Framework 4.0- en latere versies het StringBuilder-object instantiëren door de constructor StringBuilder(Int32, Int32) aan te roepen, kan zowel de lengte als de capaciteit van het StringBuilder-exemplaar groter worden dan de waarde van de eigenschap MaxCapacity. Dit kan met name gebeuren wanneer u de Append(String) en AppendFormat(String, Object) methoden aanroept om kleine tekenreeksen toe te voegen.

Zie ook

Van toepassing op

StringBuilder(String, Int32)

Initialiseert een nieuw exemplaar van de StringBuilder klasse met behulp van de opgegeven tekenreeks en capaciteit.

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)

Parameters

value: String

De tekenreeks die wordt gebruikt om de waarde van het exemplaar te initialiseren. Als value dat het is, bevat de nieuwe StringBuilder de lege tekenreeks (dat wil nullgezegd, het bevatEmpty).

capacity: Int32

De voorgestelde begingrootte van de StringBuilder.

Uitzonderingen

ArgumentOutOfRangeException

capacity is kleiner dan nul.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor aanroept met een initiële tekenreeks en een opgegeven capaciteit.

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)

Opmerkingen

Als capacity dit nul is, wordt de standaardcapaciteit van de implementatie gebruikt.

Zie ook

Capacity

Van toepassing op

StringBuilder(String, Int32, Int32, Int32)

Initialiseert een nieuw exemplaar van de StringBuilder klasse op basis van de opgegeven subtekenreeks en capaciteit.

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)

Parameters

value: String

De tekenreeks die de subtekenreeks bevat die wordt gebruikt om de waarde van dit exemplaar te initialiseren. Als value dat het is, bevat de nieuwe StringBuilder de lege tekenreeks (dat wil nullgezegd, het bevatEmpty).

startIndex: Int32

De positie binnen value waar de subtekenreeks begint.

length: Int32

Het aantal tekens in de subtekenreeks.

capacity: Int32

De voorgestelde begingrootte van de StringBuilder.

Uitzonderingen

ArgumentOutOfRangeException

capacity is kleiner dan nul.

– of –

startIndex plus length is geen positie binnen value.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de StringBuilder constructor aanroept met de opgegeven tekenreeks.

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)

Opmerkingen

Als capacity dit nul is, wordt de standaardcapaciteit van de implementatie gebruikt.

Zie ook

Capacity

Van toepassing op

Feedback

Is deze pagina nuttig?