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 en fonction des caractères Unicode indiqués dans le tableau de caractères spécifié. |
String(ReadOnlySpan<Char>) |
Initialise une nouvelle instance de la classe String en fonction des 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é et répété un certain nombre 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, un point de départ pour le caractère 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 départ de caractère 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 supplémentaires sur l’API 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> -> string
Paramètres
- value
- Char*
Pointeur vers un tableau de caractères Unicode terminé par un caractère null.
- Attributs
Exceptions
Le processus actuel n’a pas d’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 à 64000.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
S’applique à
String(Char[])
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String en fonction des 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[] -> string
Public Sub New (value As Char())
Paramètres
- value
- Char[]
Tableau de caractères Unicode.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
S’applique à
String(ReadOnlySpan<Char>)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
Initialise une nouvelle instance de la classe String en fonction des 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> -> string
Public Sub New (value As ReadOnlySpan(Of Char))
Paramètres
- value
- ReadOnlySpan<Char>
Étendue de caractères Unicode en lecture seule.
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> -> string
Paramètres
- value
- SByte*
Pointeur vers un tableau d'entiers signés 8 bits terminé par le caractère null. Les entiers sont interprétés à l’aide de l’encodage de page de codes système actuel (autrement dit, l’encodage spécifié par Default).
- Attributs
Exceptions
value
a la valeur null
.
Une nouvelle instance de String n’a pas pu être initialisée à l’aide de value
, en supposant que value
est encodé au format ANSI.
La longueur de la nouvelle chaîne à initialiser, déterminée par le caractère de fin Null de value
, est trop grande à allouer.
value
spécifie une adresse non valide.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
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é et répété un certain nombre de fois.
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)
Paramètres
- c
- Char
Caractère Unicode.
- count
- Int32
Nombre d'occurrences de c
.
Exceptions
count
est inférieur à zéro.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
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, un point de départ pour le caractère 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 -> string
Paramè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
entraîne un dépassement de capacité de pointeur ou le processus en cours n’a pas accès en lecture à tous les caractères identifiés par l’adresse.
value
spécifie un tableau qui contient un caractère Unicode non valide ou value
+ startIndex
spécifie une adresse inférieure à 64000.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
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 départ de caractère 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 -> string
Public 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
a la valeur null
.
startIndex
ou length
est inférieur à zéro.
- ou -
La somme de startIndex
et length
est supérieure au nombre d’éléments de value
.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
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 -> string
Paramè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 (autrement dit, l’encodage spécifié par Default).
- startIndex
- Int32
Position de départ dans value
.
- length
- Int32
Nombre de caractères dans value
à utiliser.
- Attributs
Exceptions
value
a la valeur 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 d’adresse a été l’objet d’un dépassement de capacité.
- ou -
La longueur de la nouvelle chaîne à initialiser est trop grande à 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é au format ANSI.
value
, startIndex
et length
spécifient collectivement une adresse non valide.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
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 -> string
Paramè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 utilisé par défaut.
- Attributs
Exceptions
value
a la valeur 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 d’adresse a été l’objet d’un dépassement de capacité.
- ou -
La longueur de la nouvelle chaîne à initialiser est trop grande à allouer.
L’adresse spécifiée par value
+ startIndex
est inférieure à 64 Ko.
- ou -
Nous n’avons pas pu initialiser une nouvelle instance de String à l’aide de value
, en supposant que value
est encodé comme indiqué par enc
.
value
, startIndex
et length
spécifient collectivement une adresse non valide.
Remarques
Notes
Pour obtenir des exemples et des informations d’utilisation complètes sur cette surcharge de constructeur et d’autres String
, consultez le résumé du String constructeur.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour