Cette documentation est archivée et n’est pas conservée.

String, constructeur (Char*, Int32, Int32)

Mise à jour : novembre 2007

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.

Cette API n'est pas conforme CLS. 

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

[CLSCompliantAttribute(false)]
public String(
	char* value,
	int startIndex,
	int length
)
J#  ne prend pas en charge les API qui consomment ou retournent des types non sécurisés.
JScript ne prend pas en charge les API qui consomment ou retournent des types non sécurisés.

Paramètres

value
Type : System.Char*
Pointeur vers un tableau de caractères Unicode.
startIndex
Type : System.Int32
Point de départ dans value.
length
Type : System.Int32
Nombre de caractères dans value à utiliser.

ExceptionCondition
ArgumentOutOfRangeException

startIndex ou length est inférieur à zéro, value + startIndex entraînent un dépassement de capacité de pointeur ou le processus actuel n'a pas l'accès en lecture à tous les caractères identifiés par l'adresse.

ArgumentNullException

value est null.

ArgumentException

value spécifie un tableau qui contient un caractère Unicode non valide ou value + startIndex spécifie une adresse inférieure à 64000.

Si length équivaut à zéro, une instance de Empty est initialisée.

Ce constructeur copie les caractères Unicode à partir de value, en commençant à startIndex et en terminant à (startIndex + length - 1).

Si la plage spécifiée dépasse la mémoire allouée à la séquence de caractères, le comportement de ce constructeur dépend alors du système. Ce type de situation peut, par exemple, provoquer une violation d'accès.

En C#, ce constructeur est uniquement défini dans un contexte de code unsafe.

ms131423.alert_note(fr-fr,VS.90).gifRemarque :

   Les appels à ce constructeur sur des systèmes utilisant le processeur Intel Itanium peuvent lever une DataMisalignedException. Si cela se produit, appelez plutôt le constructeur String.String(Char[], Int32, Int32).

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0
Afficher: