Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

Date de publication : novembre 2016

Écrit une chaîne mise en forme et une nouvelle ligne 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)

public virtual void WriteLine(
	string format,
	object arg0,
	object arg1
)

Paramètres

format
Type: System.String

Chaîne de format composite (consultez la section Notes).

arg0
Type: System.Object

Premier objet à mettre en forme et à écrire.

arg1
Type: System.Object

Deuxième objet à mettre en forme et à écrire.

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 valide.

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 (c'est-à-dire, cette surcharge de méthode, pour les deux).

Cette méthode utilise 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 fournit une prise en charge complète de la mise en forme, est décrite en détail dans les rubriques de mise en forme suivantes :

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

La syntaxe d’un élément de format est comme suit :

{index[,longueur] [ :formatString]}

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

Élément

Description

index

Position de base zéro dans la liste des paramètres de l’objet à mettre en forme. Si l’objet spécifié par index est null, l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge a deux objets dans son paramètre de liste, la valeur de index doit toujours être 0 ou 1. S’il n’existe pas de paramètre dans le index position, un FormatException est levée.

,longueur

Le nombre minimal de caractères dans la représentation sous forme de chaîne du paramètre. Si elle est positive, le paramètre est aligné à droite ; s’il est négatif, il est aligné à gauche.

:formatString

Chaîne de format standard ou personnalisé qui est pris en charge par l’objet à mettre en forme. Les valeurs possibles de formatString sont les mêmes que les valeurs prises en charge par l’objet ToString(format) (méthode). Si formatString n’est pas spécifié et l’objet à mettre en forme implémente la IFormattable interface, null est passé comme valeur de le format paramètre qui est utilisé comme le IFormattable.ToString chaîne de format.

Le début et fin des accolades, « { » et «} », sont requis. Pour spécifier une accolade littérale dans format, spécifiez deux début ou fin accolades ; autrement dit, « {{ » ou «}} ».

Cette méthode ne pas rechercher la chaîne spécifiée pour les caractères de saut de ligne individuels (0x000a hexadécimal) et les remplacer par NewLine.

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

Le terminateur de ligne est défini par le CoreNewLine champ.

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

Plateforme Windows universelle
Disponible depuis 10
.NET Framework
Disponible depuis 1.1
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Retour au début
Afficher: