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 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*)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
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
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[])
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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>)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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*)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
Ausnahmen
value
ist null
.
Eine neue Instanz von String konnte nicht mit value
initialisiert werden, wobei angenommen wurde, dass value
in ANSI codiert ist.
Die Länge der neuen zu initialisierenden Zeichenfolge, die durch das NULL-Abschlusszeichen von value
bestimmt wird, ist zu groß für die Zuordnung.
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)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
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)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
Ausnahmen
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.
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)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
value
ist null
.
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)
- Quelle:
- String.cs
- Quelle:
- String.cs
- Quelle:
- String.cs
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
Ausnahmen
value
ist null
.
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.
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.
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)
- 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 -> 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 enc
null
ist, wird von ANSI-Codierung ausgegangen.
- Attribute
Ausnahmen
value
ist null
.
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.
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.
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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für