String Konstruktoren
Definition
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
| 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> -> stringParameter
- value
- Char*
Ein Zeiger auf ein mit Null beendetes Array von Unicode-Zeichen.
- Attribute
Ausnahmen
Der aktuelle Prozess hat keinen Lesezugriff auf alle adressierten Zeichen.
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[] -> stringPublic 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> -> stringPublic 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> -> stringParameter
- 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
Ausnahmen
value ist null.
Eine neue Instanz von String konnte nicht mithilfe von valueinitialisiert werden, vorausgesetzt, value in ANSI codiert ist.
Die Länge der zu initialisierenden neuen Zeichenfolge, die durch das NULL-Beendigungszeichen von valuebestimmt wird, ist zu groß, um sie zuzuweisen.
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 -> stringPublic Sub New (c As Char, count As Integer)Parameter
- c
- Char
Ein Unicode-Zeichen.
- count
- Int32
Die Häufigkeit, mit der c auftritt.
Ausnahmen
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 -> stringParameter
- 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
Ausnahmen
startIndex oder length kleiner als Null ist, value + startIndex einen Zeigerüberlauf verursachen, oder der aktuelle Prozess hat keinen Lesezugriff auf alle adressierten Zeichen.
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 -> stringPublic 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
value ist null.
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 -> stringParameter
- 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
Ausnahmen
value ist null.
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.
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.
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.
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 -> stringParameter
- 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
Ausnahmen
value ist null.
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.
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.
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.
