String Konstruktoren

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Initialisiert eine neue Instanz der String-Klasse.

Überlädt

String(Char*)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von Unicode-Zeichen bestimmt wird.
String(Char[])

Initialisiert eine neue Instanz der String-Klasse mit den im angegebenen Zeichenarray genannten Unicode-Zeichen.
String(ReadOnlySpan<Char>)

Initialisiert eine neue Instanz der String-Klasse mit den im angegebenen schreibgeschützten Bereich genannten Unicode-Zeichen.
String(SByte*)

Initialisiert eine neue Instanz der String-Klasse mit dem durch einen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen angegebenen Wert.
String(Char, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch ein angegebenes so oft wie angegeben wiederholtes Unicode-Zeichen bestimmt wird.
String(Char*, Int32, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von Unicode-Zeichen, durch die Position des ersten Zeichens innerhalb dieses Arrays und durch eine Länge bestimmt wird.
String(Char[], Int32, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch ein Array von Unicode-Zeichen, die Position des ersten Zeichens innerhalb dieses Arrays und eine Länge bestimmt wird.
String(SByte*, Int32, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen, die Startposition innerhalb dieses Arrays und die Länge angegeben wird.
String(SByte*, Int32, Int32, Encoding)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen, die Startposition innerhalb dieses Arrays, eine Länge und ein Encoding-Objekt angegeben wird.

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für den String-Konstruktor.

String(Char*)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von Unicode-Zeichen bestimmt wird.

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

Parameter

value
Char*

Ein Zeiger auf ein mit Null endendes Array von Unicode-Zeichen.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

Der aktuelle Prozess hat keinen Lesezugriff auf alle adressierten Zeichen.

ArgumentException

value gibt ein Array an, das ein ungültiges Unicode-Zeichen enthält, oder value gibt eine Adresse kleiner als 64000 an.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(Char[])

Initialisiert eine neue Instanz der String-Klasse mit den im angegebenen Zeichenarray genannten Unicode-Zeichen.

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

Parameter

value
Char[]

Ein Array von Unicode-Zeichen.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(ReadOnlySpan<Char>)

Initialisiert eine neue Instanz der String-Klasse mit den im angegebenen schreibgeschützten Bereich genannten Unicode-Zeichen.

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

Parameter

value
ReadOnlySpan<Char>

Ein schreibgeschützter Bereich von Unicode-Zeichen.

Gilt für:

String(SByte*)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String-Klasse mit dem durch einen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen angegebenen Wert.

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

Parameter

value
SByte*

Ein Zeiger auf ein mit NULL endendes Array von 8-Bit-Ganzzahlen mit Vorzeichen. Die Ganzzahlen werden mit der aktuellen Systemcodeseiten-Codierung interpretiert (d.h. der durch Default angegebenen Codierung).

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

Eine neue Instanz von String konnte nicht mit value initialisiert werden, wobei angenommen wurde, dass value in ANSI codiert ist.

ArgumentOutOfRangeException

Die Länge der neuen zu initialisierenden Zeichenfolge, die durch das NULL-Abschlusszeichen von value bestimmt wird, ist zu groß für die Zuordnung.

AccessViolationException

value gibt eine ungültige Adresse an.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(Char, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch ein angegebenes so oft wie angegeben wiederholtes Unicode-Zeichen bestimmt wird.

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)

Parameter

c
Char

Ein Unicode-Zeichen.

count
Int32

Die Anzahl des Vorkommens von c.

Ausnahmen

ArgumentOutOfRangeException

count ist kleiner als Null.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(Char*, Int32, Int32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von Unicode-Zeichen, durch die Position des ersten Zeichens innerhalb dieses Arrays und durch eine Länge bestimmt wird.

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

Parameter

value
Char*

Ein Zeiger auf ein Array von Unicode-Zeichen.

startIndex
Int32

Die Anfangsposition in value.

length
Int32

Die Anzahl der aus value zu verwendenden Zeichen.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

startIndex oder length ist kleiner als 0 (null), value + startIndex verursacht einen Zeigerüberlauf oder der aktuelle Prozess hat keinen Lesezugriff auf alle adressierten Zeichen.

ArgumentException

value gibt ein Array an, das ein ungültiges Unicode-Zeichen enthält, oder value + startIndex gibt eine Adresse kleiner als 64000 an.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(Char[], Int32, Int32)

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch ein Array von Unicode-Zeichen, die Position des ersten Zeichens innerhalb dieses Arrays und eine Länge bestimmt wird.

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)

Parameter

value
Char[]

Ein Array von Unicode-Zeichen.

startIndex
Int32

Die Anfangsposition in value.

length
Int32

Die Anzahl der aus value zu verwendenden Zeichen.

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als 0.

- oder -

Die Summe von startIndex und length ist größer als die Anzahl von Elementen in value.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(SByte*, Int32, Int32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen, die Startposition innerhalb dieses Arrays und die Länge angegeben wird.

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

Parameter

value
SByte*

Ein Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen. Die Ganzzahlen werden mit der aktuellen Systemcodeseiten-Codierung interpretiert (d.h. der durch Default angegebenen Codierung).

startIndex
Int32

Die Anfangsposition in value.

length
Int32

Die Anzahl der aus value zu verwendenden Zeichen.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als 0.

- oder -

Die durch value + startIndex angegebene Adresse ist für die aktuelle Plattform zu groß, d.h., bei der Berechnung der Adresse ist ein Überlauf aufgetreten.

- oder -

Die Länge der zu initialisierenden neuen Zeichenfolge ist zu groß und kann daher nicht zugeordnet werden.

ArgumentException

Die durch value + startIndex angegebene Adresse ist kleiner als 64K.

- oder -

Eine neue Instanz von String konnte nicht mit value initialisiert werden, wobei angenommen wurde, dass value in ANSI codiert ist.

AccessViolationException

value, startIndex und length geben zusammen eine ungültige Adresse an.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der Zusammenfassung des String Konstruktors.

Gilt für:

String(SByte*, Int32, Int32, Encoding)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String-Klasse mit dem Wert, der durch einen angegebenen Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen, die Startposition innerhalb dieses Arrays, eine Länge und ein Encoding-Objekt angegeben wird.

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

Parameter

value
SByte*

Ein Zeiger auf ein Array von 8-Bit-Ganzzahlen mit Vorzeichen.

startIndex
Int32

Die Anfangsposition in value.

length
Int32

Die Anzahl der aus value zu verwendenden Zeichen.

enc
Encoding

Ein Objekt, das angibt, wie das Array codiert ist, auf das value verweist. Wenn encnull ist, wird von ANSI-Codierung ausgegangen.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als 0.

- oder -

Die durch value + startIndex angegebene Adresse ist für die aktuelle Plattform zu groß, d.h., bei der Berechnung der Adresse ist ein Überlauf aufgetreten.

- oder -

Die Länge der zu initialisierenden neuen Zeichenfolge ist zu groß und kann daher nicht zugeordnet werden.

ArgumentException

Die durch value + startIndex angegebene Adresse ist kleiner als 64K.

- oder -

Eine neue Instanz von String konnte nicht mit value initialisiert werden, wobei angenommen wurde, dass value entsprechend der Angabe durch enc codiert ist.

AccessViolationException

value, startIndex und length geben zusammen eine ungültige Adresse an.

Hinweise

Hinweis

Beispiele und umfassende Informationen zur Verwendung dieser und anderer String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für: