String Konstruktoren

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der String-Klasse.

Überlädt

Name	Beschreibung
String(Char*)	Initialisiert eine neue Instanz der String Klasse auf den Von einem angegebenen Zeiger angegebenen Wert auf ein Array von Unicode-Zeichen.
String(Char[])	Initialisiert eine neue Instanz der String Klasse an die Unicode-Zeichen, die im angegebenen Zeichenarray angegeben sind.
String(ReadOnlySpan<Char>)	Initialisiert eine neue Instanz der String Klasse mit den Unicode-Zeichen, die in der angegebenen schreibgeschützten Spanne angegeben sind.
String(SByte*)	Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch einen Zeiger auf ein Array mit 8-Bit-ganzzahlen angegeben ist.
String(Char, Int32)	Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch ein angegebenes Unicode-Zeichen angegeben wird, wiederholt eine bestimmte Anzahl von Malen.
String(Char*, Int32, Int32)	Initialisiert eine neue Instanz der String Klasse auf den von einem angegebenen Zeiger angegebenen Wert auf ein Array von Unicode-Zeichen, eine Anfangszeichenposition innerhalb dieses Arrays und eine Länge.
String(Char[], Int32, Int32)	Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch ein Array von Unicode-Zeichen, eine Anfangszeichenposition innerhalb dieses Arrays und eine Länge angegeben wird.
String(SByte*, Int32, Int32)	Initialisiert eine neue Instanz der String Klasse auf den Wert, der von einem angegebenen Zeiger auf ein Array mit 8-Bit-ganzzahlen, eine Anfangsposition innerhalb dieses Arrays und eine Länge angegeben wird.
String(SByte*, Int32, Int32, Encoding)	Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch einen angegebenen Zeiger auf ein Array mit 8-Bit-ganzzahlen angegeben ist, eine Anfangsposition innerhalb dieses Arrays, eine Länge und ein Encoding Objekt.

Hinweise

Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für den Zeichenfolgenkonstruktor.

String(Char*)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String Klasse auf den Von einem angegebenen Zeiger angegebenen Wert auf ein Array von Unicode-Zeichen.

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 beendetes 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 eine Adresse kleiner als 64000 angibt.

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(Char[])

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Initialisiert eine neue Instanz der String Klasse an die Unicode-Zeichen, die im angegebenen Zeichenarray angegeben sind.

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

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(ReadOnlySpan<Char>)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Initialisiert eine neue Instanz der String Klasse mit den Unicode-Zeichen, die in der angegebenen schreibgeschützten Spanne angegeben sind.

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>

Eine schreibgeschützte Spanne von Unicode-Zeichen.

Gilt für:

String(SByte*)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch einen Zeiger auf ein Array mit 8-Bit-ganzzahlen angegeben ist.

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 null-beendetes Array mit 8-Bit-ganzzahligen Vorzeichen. Die ganzen Zahlen werden mithilfe der aktuellen Systemcodepage-Codierung für Windows (als CP_ACP bezeichnet) und als UTF-8-Codierung für nicht-Windows interpretiert.

Attribute: CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

Eine neue Instanz von String konnte nicht mithilfe von valueANSI initialisiert werden, vorausgesetzt value , sie ist in ANSI codiert.

ArgumentOutOfRangeException

Die Länge der zu initialisierenden neuen Zeichenfolge, die durch das NULL-Beendigungszeichen valuebestimmt wird, ist zu groß, um sie zuzuweisen.

AccessViolationException

value Gibt eine ungültige Adresse an.

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(Char, Int32)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch ein angegebenes Unicode-Zeichen angegeben wird, wiederholt eine bestimmte Anzahl von Malen.

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 der Male c tritt auf.

Ausnahmen

ArgumentOutOfRangeException

count ist kleiner als 0 (null).

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(Char*, Int32, Int32)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String Klasse auf den von einem angegebenen Zeiger angegebenen Wert auf ein Array von Unicode-Zeichen, eine Anfangszeichenposition innerhalb dieses Arrays und eine Länge.

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 Startposition innerhalb valuevon .

length: Int32

Die Anzahl der Zeichen, die verwendet value werden sollen.

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 eine Adresse kleiner als 64000 angibt.

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(Char[], Int32, Int32)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch ein Array von Unicode-Zeichen, eine Anfangszeichenposition innerhalb dieses Arrays und eine Länge angegeben 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 Startposition innerhalb valuevon .

length: Int32

Die Anzahl der Zeichen, die verwendet value werden sollen.

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

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

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(SByte*, Int32, Int32)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String Klasse auf den Wert, der von einem angegebenen Zeiger auf ein Array mit 8-Bit-ganzzahlen, eine Anfangsposition innerhalb dieses Arrays und eine 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 mit 8-Bit-ganzzahligen Vorzeichen. Die ganzen Zahlen werden mithilfe der aktuellen Systemcodepage-Codierung für Windows (als CP_ACP bezeichnet) und als UTF-8-Codierung für nicht-Windows interpretiert.

startIndex: Int32

Die Startposition innerhalb valuevon .

length: Int32

Die Anzahl der zu verwendenden Sbytes value .

Attribute: CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

Die angegebene value + startIndex Adresse ist für die aktuelle Plattform zu groß, d. h., die Adressberechnung überläuft.

-oder-

Die Länge der zu initialisierenden neuen Zeichenfolge ist zu groß, um sie zuzuweisen.

ArgumentException

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

-oder-

Eine neue Instanz von String konnte nicht mithilfe von valueANSI initialisiert werden, vorausgesetzt value , sie ist in ANSI codiert.

AccessViolationException

value, startIndexund length geben Sie zusammen eine ungültige Adresse an.

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

String(SByte*, Int32, Int32, Encoding)

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Quelle:: String.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der String Klasse auf den Wert, der durch einen angegebenen Zeiger auf ein Array mit 8-Bit-ganzzahlen angegeben ist, eine Anfangsposition innerhalb dieses Arrays, eine Länge und ein Encoding Objekt.

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 mit 8-Bit-ganzzahligen Vorzeichen.

startIndex: Int32

Die Startposition innerhalb valuevon .

length: Int32

Die Anzahl der zu verwendenden Sbytes value .

enc: Encoding

Ein Objekt, das angibt, wie das Array codiert wird, auf value das verwiesen wird. Wenn enc ja null, wird die ANSI-Codierung angenommen.

Attribute: CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

Die angegebene value + startIndex Adresse ist für die aktuelle Plattform zu groß, d. h., die Adressberechnung überläuft.

-oder-

Die Länge der zu initialisierenden neuen Zeichenfolge ist zu groß, um sie zuzuweisen.

ArgumentException

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

-oder-

Eine neue Instanz von String konnte nicht mit valueinitialisiert werden, vorausgesetzt value , dass sie wie angegeben enccodiert ist.

AccessViolationException

value, startIndexund length geben Sie zusammen eine ungültige Adresse an.

Hinweise

Note

Beispiele und umfassende Verwendungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der String Konstruktorzusammenfassung.

Gilt für:

Feedback

War diese Seite hilfreich?