Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

TextWriter.Write, méthode (String, Object, Object)

.NET Framework 4.5

Autres versions

Écrit une chaîne mise en forme dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode String.Format(String, Object, Object).

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

Syntaxe

C++

public virtual void Write(
	string format,
	Object arg0,
	Object arg1
)

Paramètres

format: Type : System.String
Chaîne de format composite (consultez Remarques).

arg0: Type : System.Object
Premier objet à mettre en forme et à écrire.

arg1: Type : System.Object
Deuxième objet à mettre en forme et à écrire.

Exceptions

Exception	Condition
ArgumentNullException	format a la valeur null.
ObjectDisposedException	TextWriter est fermé.
IOException	Une erreur d'E/S se produit.
FormatException	format n'est pas une chaîne de format composite. ou L'index d'un élément de format est inférieur à 0 (zéro) ou supérieur ou égal au nombre d'objets à mettre en forme (qui, pour cette surcharge de méthode, s'élève à deux).

Notes

Cette méthode utilise la fonctionnalité de mise en forme composite du .NET Framework pour convertir la valeur d'un objet en sa représentation sous forme de chaîne et pour incorporer cette représentation dans une chaîne. Le .NET Framework assure une prise en charge étendue de la mise en forme, décrite plus en détail dans les rubriques suivantes relatives à la mise en forme :

Pour plus d'informations sur la fonctionnalité de mise en forme composite, consultez Mise en forme composite.
Pour plus d'informations sur les spécificateurs de format numérique, consultez Chaînes de format numériques standard et Chaînes de format numériques personnalisées.
Pour plus d'informations sur les spécificateurs de format date et heure, consultez Chaînes de format de date et d'heure standard et Chaînes de format de date et d'heure personnalisées.
Pour plus d'informations sur les spécificateurs de format d'énumération, consultez Chaînes de format d'énumération.
Pour plus d'informations sur la mise en forme, consultez Mise en forme des types.

Le paramètre format se compose de zéro ou plusieurs séquences de texte associées à zéro ou plusieurs espaces réservés indexés, appelés éléments de format, qui correspondent à un objet de la liste de paramètres de cette méthode. Le processus de mise en forme remplace chaque élément de format par la représentation chaîne de la valeur de l'objet correspondant.

La syntaxe d'un élément de mise en forme est la suivante :

{index[,length][:formatString]}

Les éléments entre crochets sont facultatifs. Le tableau suivant décrit les différents éléments. Pour plus d'informations sur la fonctionnalité de mise en forme composite, notamment la syntaxe d'un élément de format, consultez Mise en forme composite.

Élément	Description
index	Position de base zéro dans la liste de paramètres de l'objet à mettre en forme. Si l'objet spécifié par index est null, l'élément de mise en forme est remplacé par String.Empty. Cette surcharge possède deux objets dans sa liste de paramètres, la valeur d' index doit toujours être 0 ou 1. S'il n'existe aucun paramètre à la position d'index, une FormatException est levée.
,longueur	Nombre minimal de caractères contenus dans la représentation sous forme de chaîne du paramètre. Si la valeur est positive, le paramètre est aligné à droite ; si la valeur est négative, il est aligné à gauche.
:formatString	Chaîne de format standard ou personnalisée prise en charge par l'objet à mettre en forme. Les valeurs possible pour formatString sont les mêmes que les valeurs prises en charge par la méthode d'objet ToString(format). Si formatString n'est pas spécifié et que l'objet à mettre en forme implémente l'interface IFormattable, null est passée en tant que valeur du paramètre format utilisé en tant que chaîne de format IFormattable.ToString.

Les accolades de début et de fin, « { » et « } » sont obligatoires. Pour spécifier une accolade littérale dans format, entrez deux accolades de début ou de fin ; par exemple, "{{" ou "}}".

Cette méthode ne trouve pas la chaîne spécifiée pour les différents caractères de saut de ligne (0x000a hexadécimal) et les ne remplace pas par TextWriter.NewLine.

Si un objet spécifié n'est pas référencé dans la chaîne de format, il est ignoré.

Pour obtenir la liste des tâches d'E/S courantes, consultez Tâches d'E/S courantes.

Informations de version

.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

Voir aussi