String Constructeurs

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Initialise une nouvelle instance de la classe String.

Surcharges

Nom Description
String(Char*)

Initialise une nouvelle instance de la String classe à la valeur indiquée par un pointeur spécifié vers un tableau de caractères Unicode.
String(Char[])

Initialise une nouvelle instance de la String classe aux caractères Unicode indiqués dans le tableau de caractères spécifié.
String(ReadOnlySpan<Char>)

Initialise une nouvelle instance de la String classe aux caractères Unicode indiqués dans l’étendue en lecture seule spécifiée.
String(SByte*)

Initialise une nouvelle instance de la String classe à 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 String classe à 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 String classe à 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 String classe à 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 String classe à 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 String classe à 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 Encoding objet.

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour le constructeur string.

String(Char*)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la String classe à 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 null.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentOutOfRangeException

Le processus actuel n’a pas d’accès en lecture à tous les caractères adressés.

ArgumentException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(Char[])

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Initialise une nouvelle instance de la String classe 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[] -> string
Public 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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(ReadOnlySpan<Char>)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Initialise une nouvelle instance de la String classe 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> -> string
Public 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
Source:
String.cs
Source:
String.cs

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la String classe à 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 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 des Windows non-Windows.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentException

Une nouvelle instance de n’a String pas pu être initialisée à l’aide valuede , en supposant qu’elle value est encodée dans ANSI.

ArgumentOutOfRangeException

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.

AccessViolationException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(Char, Int32)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Initialise une nouvelle instance de la String classe à 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 -> string
Public Sub New (c As Char, count As Integer)

Paramètres

c
Char

Caractère Unicode.

count
Int32

Le nombre de fois c se produit.

Exceptions

ArgumentOutOfRangeException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(Char*, Int32, Int32)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la String classe à 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 -> 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 à value utiliser.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentOutOfRangeException

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.

ArgumentException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(Char[], Int32, Int32)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Initialise une nouvelle instance de la String classe à 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 -> 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 à value utiliser.

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentOutOfRangeException

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

Note

Pour obtenir des exemples et des informations d’utilisation complètes sur ces surcharges de constructeur et d’autres String constructeurs, consultez le résumé du String constructeur.

S’applique à

String(SByte*, Int32, Int32)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la String classe à 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 sur Windows (appelé CP_ACP) et en tant qu’encodage UTF-8 sur des Windows non-Windows.

startIndex
Int32

Position de départ dans value.

length
Int32

Nombre d’octets à value utiliser.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentOutOfRangeException

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.

ArgumentException

L’adresse spécifiée est value + startIndex inférieure à 64 Ko.

- ou -

Une nouvelle instance de n’a String pas pu être initialisée à l’aide valuede , en supposant qu’elle value est encodée dans ANSI.

AccessViolationException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à

String(SByte*, Int32, Int32, Encoding)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la String classe à 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 Encoding objet.

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 d’octets à value utiliser.

enc
Encoding

Objet qui spécifie la façon dont le tableau référencé par value est encodé. Si enc c’est nullle cas, l’encodage ANSI est supposé.

Attributs
CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

value a la valeur null.

ArgumentOutOfRangeException

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.

ArgumentException

L’adresse spécifiée est value + startIndex inférieure à 64 Ko.

- ou -

Impossible d’initialiser String une nouvelle instance à l’aide valuede , en supposant value qu’elle est encodée comme spécifié par enc.

AccessViolationException

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 constructeurs, consultez le résumé du String constructeur.

S’applique à