String Constructors

Definitie

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

Initialiseert een nieuw exemplaar van de String klasse.

Overloads

Name Description
String(Char*)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix met Unicode-tekens.
String(Char[])

Initialiseert een nieuw exemplaar van de String klasse naar de Unicode-tekens die worden aangegeven in de opgegeven tekenmatrix.
String(ReadOnlySpan<Char>)

Initialiseert een nieuw exemplaar van de String klasse naar de Unicode-tekens die zijn aangegeven in de opgegeven periode met het kenmerk Alleen-lezen.
String(SByte*)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een aanwijzer naar een matrix van 8-bits ondertekende gehele getallen.
String(Char, Int32)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven Unicode-teken dat een opgegeven aantal keren wordt herhaald.
String(Char*, Int32, Int32)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix met Unicode-tekens, een begintekenpositie binnen die matrix en een lengte.
String(Char[], Int32, Int32)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een matrix met Unicode-tekens, een begintekenpositie binnen die matrix en een lengte.
String(SByte*, Int32, Int32)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix van 8-bits ondertekende gehele getallen, een beginpositie binnen die matrix en een lengte.
String(SByte*, Int32, Int32, Encoding)

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix van 8-bits ondertekende gehele getallen, een beginpositie binnen die matrix, een lengte en een Encoding object.

Opmerkingen

Zie Aanvullende API-opmerkingen voor tekenreeksconstructor voor meer informatie over deze API.

String(Char*)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix met Unicode-tekens.

public:
 String(char* value);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String(char* value);
[System.CLSCompliant(false)]
public String(char* value);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> -> string
[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Parameters

value
Char*

Een aanwijzer naar een null-beëindigde matrix met Unicode-tekens.

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentOutOfRangeException

Het huidige proces heeft geen leestoegang tot alle geadresseerde tekens.

ArgumentException

value geeft een matrix op die een ongeldig Unicode-teken bevat of value een adres kleiner dan 64000.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(Char[])

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Initialiseert een nieuw exemplaar van de String klasse naar de Unicode-tekens die worden aangegeven in de opgegeven tekenmatrix.

public:
 String(cli::array <char> ^ value);
public String(char[] value);
public String(char[]? value);
new string : char[] -> string
Public Sub New (value As Char())

Parameters

value
Char[]

Een matrix met Unicode-tekens.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(ReadOnlySpan<Char>)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Initialiseert een nieuw exemplaar van de String klasse naar de Unicode-tekens die zijn aangegeven in de opgegeven periode met het kenmerk Alleen-lezen.

public:
 String(ReadOnlySpan<char> value);
public String(ReadOnlySpan<char> value);
new string : ReadOnlySpan<char> -> string
Public Sub New (value As ReadOnlySpan(Of Char))

Parameters

value
ReadOnlySpan<Char>

Een alleen-lezen reeks Unicode-tekens.

Van toepassing op

String(SByte*)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een aanwijzer naar een matrix van 8-bits ondertekende gehele getallen.

public:
 String(System::SByte* value);
[System.CLSCompliant(false)]
public String(sbyte* value);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String(sbyte* value);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> -> string

Parameters

value
SByte*

Een aanwijzer naar een door null beëindigde matrix van 8-bits ondertekende gehele getallen. De gehele getallen worden geïnterpreteerd met behulp van de huidige codetabelcodering van het systeem op Windows (aangeduid als CP_ACP) en als UTF-8-codering op niet-Windows.

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

value is null.

ArgumentException

Een nieuwe instantie van kan niet worden geïnitialiseerd met behulp Stringvanvalue, ervan uitgaande dat value deze is gecodeerd in ANSI.

ArgumentOutOfRangeException

De lengte van de nieuwe tekenreeks die moet worden geïnitialiseerd, wat wordt bepaald door het null-beëindigingsteken van value, is te groot om toe te wijzen.

AccessViolationException

value geeft een ongeldig adres.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(Char, Int32)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven Unicode-teken dat een opgegeven aantal keren wordt herhaald.

public:
 String(char c, int count);
public String(char c, int count);
new string : char * int -> string
Public Sub New (c As Char, count As Integer)

Parameters

c
Char

Een Unicode-teken.

count
Int32

Het aantal keren c treedt op.

Uitzonderingen

ArgumentOutOfRangeException

count is kleiner dan nul.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(Char*, Int32, Int32)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix met Unicode-tekens, een begintekenpositie binnen die matrix en een lengte.

public:
 String(char* value, int startIndex, int length);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String(char* value, int startIndex, int length);
[System.CLSCompliant(false)]
public String(char* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> * int * int -> string
[<System.CLSCompliant(false)>]
new string : nativeptr<char> * int * int -> string

Parameters

value
Char*

Een aanwijzer naar een matrix met Unicode-tekens.

startIndex
Int32

De beginpositie binnen value.

length
Int32

Het aantal tekens dat moet value worden gebruikt.

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentOutOfRangeException

startIndex of length kleiner is dan nul, value + startIndex veroorzaakt een overloop van een aanwijzer of het huidige proces heeft geen leestoegang tot alle geadresseerde tekens.

ArgumentException

value geeft een matrix op die een ongeldig Unicode-teken bevat of value + startIndex een adres kleiner dan 64000.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(Char[], Int32, Int32)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een matrix met Unicode-tekens, een begintekenpositie binnen die matrix en een lengte.

public:
 String(cli::array <char> ^ value, int startIndex, int length);
public String(char[] value, int startIndex, int length);
new string : char[] * int * int -> string
Public Sub New (value As Char(), startIndex As Integer, length As Integer)

Parameters

value
Char[]

Een matrix met Unicode-tekens.

startIndex
Int32

De beginpositie binnen value.

length
Int32

Het aantal tekens dat moet value worden gebruikt.

Uitzonderingen

ArgumentNullException

value is null.

ArgumentOutOfRangeException

startIndex of length kleiner is dan nul.

– of –

De som van startIndex en length is groter dan het aantal elementen in value.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(SByte*, Int32, Int32)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix van 8-bits ondertekende gehele getallen, een beginpositie binnen die matrix en een lengte.

public:
 String(System::SByte* value, int startIndex, int length);
[System.CLSCompliant(false)]
public String(sbyte* value, int startIndex, int length);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String(sbyte* value, int startIndex, int length);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> * int * int -> string

Parameters

value
SByte*

Een aanwijzer naar een matrix van 8-bits ondertekende gehele getallen. De gehele getallen worden geïnterpreteerd met behulp van de huidige codetabelcodering van het systeem op Windows (aangeduid als CP_ACP) en als UTF-8-codering op niet-Windows.

startIndex
Int32

De beginpositie binnen value.

length
Int32

Het aantal te gebruiken sbytes value .

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

value is null.

ArgumentOutOfRangeException

startIndex of length kleiner is dan nul.

– of –

Het adres dat is opgegeven door value + startIndex , is te groot voor het huidige platform. Dat wil wel dat de adresberekening is overgelopen.

– of –

De lengte van de nieuwe tekenreeks die moet worden geïnitialiseerd, is te groot om toe te wijzen.

ArgumentException

Het opgegeven value + startIndex adres is kleiner dan 64.000.

– of –

Een nieuwe instantie van kan niet worden geïnitialiseerd met behulp Stringvanvalue, ervan uitgaande dat value deze is gecodeerd in ANSI.

AccessViolationException

value, startIndexen length geef gezamenlijk een ongeldig adres op.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op

String(SByte*, Int32, Int32, Encoding)

Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs
Bron:
String.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de String klasse naar de waarde die wordt aangegeven door een opgegeven aanwijzer naar een matrix van 8-bits ondertekende gehele getallen, een beginpositie binnen die matrix, een lengte en een Encoding object.

public:
 String(System::SByte* value, int startIndex, int length, System::Text::Encoding ^ enc);
[System.CLSCompliant(false)]
public String(sbyte* value, int startIndex, int length, System.Text.Encoding enc);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String(sbyte* value, int startIndex, int length, System.Text.Encoding enc);
[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string

Parameters

value
SByte*

Een aanwijzer naar een matrix van 8-bits ondertekende gehele getallen.

startIndex
Int32

De beginpositie binnen value.

length
Int32

Het aantal te gebruiken sbytes value .

enc
Encoding

Een object dat aangeeft hoe de matrix waarnaar wordt verwezen, value wordt gecodeerd. Als enc dat het is null, wordt van ANSI-codering uitgegaan.

Kenmerken
CLSCompliantAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

value is null.

ArgumentOutOfRangeException

startIndex of length kleiner is dan nul.

– of –

Het adres dat is opgegeven door value + startIndex , is te groot voor het huidige platform. Dat wil wel dat de adresberekening is overgelopen.

– of –

De lengte van de nieuwe tekenreeks die moet worden geïnitialiseerd, is te groot om toe te wijzen.

ArgumentException

Het opgegeven value + startIndex adres is kleiner dan 64.000.

– of –

Een nieuwe instantie van kan niet worden geïnitialiseerd met behulp van String , ervan uitgaande value dat deze is gecodeerd zoals opgegeven door value.enc

AccessViolationException

value, startIndexen length geef gezamenlijk een ongeldig adres op.

Opmerkingen

Note

Zie de samenvatting van de String constructor voor voorbeelden en uitgebreide gebruiksgegevens over deze en andere String overbelastingen van constructors.

Van toepassing op