Exporter (0) Imprimer
Développer tout
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

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

É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).

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

public virtual void Write(
	string format,
	Object arg0
)

Paramètres

format
Type : System.String
Chaîne de format composite (consultez la section Notes)
arg0
Type : System.Object
Objet à mettre en forme et à écrire.

ExceptionCondition
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 à un).

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 :

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. Étant donné que cette surcharge a uniquement un objet unique dans sa liste de paramètres, la valeur de index doit toujours être 0. 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 recherche pas les chaînes de caractère spécifiées pour des sauts de ligne individuels (0x000a hexadécimaux) ni ne les remplace 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.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 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

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft