Teilen über

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 auf den wert, der durch einen angegebenen Zeiger auf ein Array von Unicode-Zeichen angegeben wird.
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 auf die 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 angegebene 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-vorzeichenigen 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, eine Anfangsposition 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 Zeichenfolgenkonstruktor.

String(Char*)

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 von Unicode-Zeichen angegeben 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 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 unter 64000 angibt.

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(Char[])

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

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(ReadOnlySpan<Char>)

Quelle:
String.cs
Quelle:
String.cs
Quelle:
String.cs

Initialisiert eine neue Instanz der String Klasse auf die 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

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 Systemcodeseitencodierung unter Windows (als CP_ACP bezeichnet) und als UTF-8-Codierung unter Windows interpretiert.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

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

ArgumentOutOfRangeException

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

AccessViolationException

value gibt eine ungültige Adresse an.

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(Char, Int32)

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 angegebene 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 Häufigkeit, mit der c auftritt.

Ausnahmen

ArgumentOutOfRangeException

count ist kleiner als Null.

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(Char*, Int32, Int32)

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 Anfangsposition innerhalb value.

length
Int32

Die Anzahl der zeichen in value zu verwenden.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentOutOfRangeException

startIndex oder length kleiner als Null ist, value + startIndex einen Zeigerüberlauf verursachen, 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

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(Char[], Int32, Int32)

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 Anfangsposition innerhalb value.

length
Int32

Die Anzahl der zeichen in value zu verwenden.

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

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

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(SByte*, Int32, Int32)

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-vorzeichenigen 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 Systemcodeseitencodierung unter Windows (als CP_ACP bezeichnet) und als UTF-8-Codierung unter Windows interpretiert.

startIndex
Int32

Die Anfangsposition innerhalb value.

length
Int32

Die Anzahl der zeichen in value zu verwenden.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

Die durch value + startIndex angegebene Adresse ist für die aktuelle Plattform zu groß; d. h., die Adressberechnung wurde überlaufen.

-oder-

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

ArgumentException

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

-oder-

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

AccessViolationException

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

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für:

String(SByte*, Int32, Int32, Encoding)

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

startIndex
Int32

Die Anfangsposition innerhalb value.

length
Int32

Die Anzahl der zeichen in value zu verwenden.

enc
Encoding

Ein Objekt, das angibt, wie das Array, auf das von value verwiesen wird, codiert wird. Wenn encnullist, wird die ANSI-Codierung angenommen.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex oder length ist kleiner als Null.

-oder-

Die durch value + startIndex angegebene Adresse ist für die aktuelle Plattform zu groß; d. h., die Adressberechnung wurde überlaufen.

-oder-

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

ArgumentException

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

-oder-

Eine neue Instanz von String konnte nicht mithilfe von valueinitialisiert werden, vorausgesetzt, value wird wie durch encangegeben codiert.

AccessViolationException

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

Hinweise

Anmerkung

Beispiele und umfassende Nutzungsinformationen zu diesem und anderen String Konstruktorüberladungen finden Sie in der zusammenfassung String Konstruktor.

Gilt für: