String Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe String.
Surcharges
| String(Char*) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau de caractères Unicode. |
| String(Char[]) |
Initialise une nouvelle instance de la classe String aux caractères Unicode indiqués dans le tableau de caractères spécifié. |
| String(ReadOnlySpan<Char>) |
Initialise une nouvelle instance de la classe String aux caractères Unicode indiqués dans l’étendue en lecture seule spécifiée. |
| String(SByte*) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur vers un tableau d’entiers signés 8 bits. |
| String(Char, Int32) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un caractère Unicode spécifié répété un nombre spécifié de fois. |
| String(Char*, Int32, Int32) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau de caractères Unicode, une position de caractère de départ dans ce tableau et une longueur. |
| String(Char[], Int32, Int32) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un tableau de caractères Unicode, une position de caractère de départ dans ce tableau et une longueur. |
| String(SByte*, Int32, Int32) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau d’entiers signés 8 bits, une position de départ dans ce tableau et une longueur. |
| String(SByte*, Int32, Int32, Encoding) |
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau d’entiers signés 8 bits, une position de départ dans ce tableau, une longueur et un objet Encoding. |
Remarques
Pour plus d’informations sur cette API, consultez remarques de l’API supplémentaire pour le constructeur string.
String(Char*)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Important
Cette API n’est pas conforme CLS.
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau de caractères Unicode.
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> -> stringParamètres
- value
- Char*
Pointeur vers un tableau de caractères Unicode terminé par null.
- Attributs
Exceptions
Le processus actuel n’a pas accès en lecture à tous les caractères adressés.
value spécifie un tableau qui contient un caractère Unicode non valide, ou value spécifie une adresse inférieure à 64 000.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(Char[])
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String aux caractères Unicode indiqués dans le tableau de caractères spécifié.
public:
String(cli::array <char> ^ value);public String (char[] value);public String (char[]? value);new string : char[] -> stringPublic Sub New (value As Char())Paramètres
- value
- Char[]
Tableau de caractères Unicode.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(ReadOnlySpan<Char>)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String aux caractères Unicode indiqués dans l’étendue en lecture seule spécifiée.
public:
String(ReadOnlySpan<char> value);public String (ReadOnlySpan<char> value);new string : ReadOnlySpan<char> -> stringPublic Sub New (value As ReadOnlySpan(Of Char))Paramètres
- value
- ReadOnlySpan<Char>
Étendue en lecture seule de caractères Unicode.
S’applique à
String(SByte*)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Important
Cette API n’est pas conforme CLS.
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur vers un tableau d’entiers signés 8 bits.
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> -> stringParamètres
- value
- SByte*
Pointeur vers un tableau terminé par null d’entiers signés 8 bits. Les entiers sont interprétés à l’aide de l’encodage de page de codes système actuel sur Windows (appelé CP_ACP) et en tant qu’encodage UTF-8 sur non-Windows.
- Attributs
Exceptions
value est null.
Une nouvelle instance de String n’a pas pu être initialisée à l’aide de value, en supposant que value est encodé dans ANSI.
La longueur de la nouvelle chaîne à initialiser, qui est déterminée par le caractère de terminaison Null de value, est trop grande pour allouer.
value spécifie une adresse non valide.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(Char, Int32)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String à la valeur indiquée par un caractère Unicode spécifié répété un nombre spécifié de fois.
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)Paramètres
- c
- Char
Caractère Unicode.
- count
- Int32
Nombre de fois où c se produit.
Exceptions
count est inférieur à zéro.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(Char*, Int32, Int32)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Important
Cette API n’est pas conforme CLS.
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau de caractères Unicode, une position de caractère de départ dans ce tableau et une longueur.
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 -> stringParamètres
- value
- Char*
Pointeur vers un tableau de caractères Unicode.
- startIndex
- Int32
Position de départ dans value.
- length
- Int32
Nombre de caractères dans value à utiliser.
- Attributs
Exceptions
startIndex ou length est inférieur à zéro, value + startIndex provoquer un dépassement de pointeur, ou le processus actuel n’a pas accès en lecture à tous les caractères adressés.
value spécifie un tableau qui contient un caractère Unicode non valide, ou value + startIndex spécifie une adresse inférieure à 64 000.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(Char[], Int32, Int32)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String à la valeur indiquée par un tableau de caractères Unicode, une position de caractère de départ dans ce tableau et une longueur.
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)Paramètres
- value
- Char[]
Tableau de caractères Unicode.
- startIndex
- Int32
Position de départ dans value.
- length
- Int32
Nombre de caractères dans value à utiliser.
Exceptions
value est null.
startIndex ou length est inférieur à zéro.
-ou-
La somme de startIndex et de length est supérieure au nombre d’éléments dans value.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(SByte*, Int32, Int32)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Important
Cette API n’est pas conforme CLS.
Initialise une nouvelle instance de la classe String à la valeur indiquée par un pointeur spécifié vers un tableau d’entiers signés 8 bits, une position de départ dans ce tableau et une longueur.
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 -> stringParamètres
- value
- SByte*
Pointeur vers un tableau d’entiers signés 8 bits. Les entiers sont interprétés à l’aide de l’encodage de page de codes système actuel sur Windows (appelé CP_ACP) et en tant qu’encodage UTF-8 sur non-Windows.
- startIndex
- Int32
Position de départ dans value.
- length
- Int32
Nombre de caractères dans value à utiliser.
- Attributs
Exceptions
value est null.
startIndex ou length est inférieur à zéro.
-ou-
L’adresse spécifiée par value + startIndex est trop grande pour la plateforme actuelle ; autrement dit, le calcul de l’adresse a dépassé.
-ou-
La longueur de la nouvelle chaîne à initialiser est trop grande pour allouer.
L’adresse spécifiée par value + startIndex est inférieure à 64 Ko.
-ou-
Une nouvelle instance de String n’a pas pu être initialisée à l’aide de value, en supposant que value est encodé dans ANSI.
value, startIndexet length spécifiez collectivement une adresse non valide.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
S’applique à
String(SByte*, Int32, Int32, Encoding)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Important
Cette API n’est pas conforme CLS.
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 -> stringParamètres
- value
- SByte*
Pointeur vers un tableau d’entiers signés 8 bits.
- startIndex
- Int32
Position de départ dans value.
- length
- Int32
Nombre de caractères dans value à utiliser.
- enc
- Encoding
Objet qui spécifie la façon dont le tableau référencé par value est encodé. Si enc est null, l’encodage ANSI est supposé.
- Attributs
Exceptions
value est null.
startIndex ou length est inférieur à zéro.
-ou-
L’adresse spécifiée par value + startIndex est trop grande pour la plateforme actuelle ; autrement dit, le calcul de l’adresse a dépassé.
-ou-
La longueur de la nouvelle chaîne à initialiser est trop grande pour allouer.
L’adresse spécifiée par value + startIndex est inférieure à 64 Ko.
-ou-
Une nouvelle instance de String n’a pas pu être initialisée à l’aide de value, en supposant que value est encodée comme spécifié par enc.
value, startIndexet length spécifiez collectivement une adresse non valide.
Remarques
Note
Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String, consultez le résumé du constructeur String.
