HtmlTextWriter.WriteLine Méthode

Définition

Écrit des données dans un flux de sortie HtmlTextWriter, de la manière spécifiée par les paramètres surchargés, suivies d'une chaîne de terminaison de ligne. Toutes les versions de cette méthode écrivent les espacements de tabulation en attente dans le flux de sortie.

Surcharges

WriteLine(String, Object, Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle de deux objets, suivis d'une chaîne de terminaison de ligne.

WriteLine(Char[], Int32, Int32)

Écrit dans le flux de sortie les espacements de tabulation en attente et un sous-tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne.

WriteLine(String, Object[])

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un tableau d'objets, suivis d'une chaîne de terminaison de ligne.

WriteLine(String, Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne.

WriteLine(UInt32)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier non signé de 4 octets, suivis d'une chaîne de terminaison de ligne.

WriteLine(String)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne de texte, suivis d'une chaîne de terminaison de ligne.

WriteLine(Single)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante simple précision, suivis d'une chaîne de terminaison de ligne.

WriteLine(Int32)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier signé de 32 octets, suivis d'une chaîne de terminaison de ligne.

WriteLine(Int64)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d’un entier signé de 64 octets, suivis d’une chaîne de terminaison de ligne.

WriteLine(Double)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante double précision, suivis d'une chaîne de terminaison de ligne.

WriteLine(Char[])

Écrit dans le flux de sortie les espacements de tabulation en attente et un tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne.

WriteLine(Char)

Écrit dans le flux de sortie les espacements de tabulation en attente et un caractère Unicode, suivis d'une chaîne de terminaison de ligne.

WriteLine(Boolean)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'une valeur Boolean, suivis d'une chaîne de terminaison de ligne.

WriteLine()

Écrit une chaîne de terminaison de ligne dans le flux de sortie.

WriteLine(Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

WriteLine(String, Object, Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle de deux objets, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void WriteLine (string format, object arg0, object arg1);
override this.WriteLine : string * obj * obj -> unit
Public Overrides Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

Paramètres

format
String

Chaîne contenant zéro, un ou plusieurs éléments de mise en forme.

arg0
Object

Objet à mettre en forme.

arg1
Object

Objet à mettre en forme.

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour afficher une chaîne mise en forme et les valeurs de la CurrentCulture propriété et de la Today propriété.

// Use the WriteLine(string,object,object) method to
// render a formatted string and two objects 
// in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.",
    CultureInfo.CurrentCulture, DateTime.Today);
writer.RenderEndTag();
' Use the WriteLine(string,object,object) method to
' render a formatted string and two objects 
' in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}. Today's date is {1}.", _
    CultureInfo.CurrentCulture, DateTime.Today)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode utilise la même sémantique que la Format(String, Object, Object) méthode . La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Char[], Int32, Int32)

Écrit dans le flux de sortie les espacements de tabulation en attente et un sous-tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(cli::array <char> ^ buffer, int index, int count);
public override void WriteLine (char[] buffer, int index, int count);
override this.WriteLine : char[] * int * int -> unit
Public Overrides Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

Paramètres

buffer
Char[]

Tableau de caractères à partir duquel le texte est écrit dans le flux de sortie.

index
Int32

Emplacement dans le tableau de caractères où l'écriture commence.

count
Int32

Nombre de caractères du tableau à écrire dans le flux de sortie.

Exemples

Cette section contient deux exemples de code. Le premier montre comment créer un tableau de caractères. La deuxième montre comment utiliser le tableau.

Ces exemples de code génèrent le balisage suivant :

<label>

hello

</label>

L’exemple de code suivant montre comment créer un tableau de caractères qui indique hello world. Le champ est inclus dans le SpaceChar tableau, qui crée un espace entre les deux mots.

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};
Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

L’exemple de code suivant utilise les index paramètres et count de la WriteLine méthode pour afficher les cinq premiers caractères du tableau créé dans l’exemple de code précédent.

// Render a subarray of a character array
// as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars, 0, 5);
writer.RenderEndTag();
' Render a subarray of a character array
' as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars, 0, 5)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(String, Object[])

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un tableau d'objets, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void WriteLine (string format, params object[] arg);
override this.WriteLine : string * obj[] -> unit
Public Overrides Sub WriteLine (format As String, ParamArray arg As Object())

Paramètres

format
String

Chaîne contenant zéro, un ou plusieurs éléments de mise en forme.

arg
Object[]

Tableau d'objets à mettre en forme.

Exemples

Cette section contient deux exemples de code. La première montre comment restituer une chaîne et un tableau dans le flux de sortie. La deuxième montre comment déclarer le tableau.

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour restituer une chaîne mise en forme et le contenu d’un tableau d’objets dans le flux de sortie.

// Render a formatted string and the
// text representation of an object array,
// myObjectArray, as the contents of
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime);
writer.RenderEndTag();
' Render a formatted string and the
' text representation of an object array,
' myObjectArray, as the contents of
' a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

L’exemple de code suivant montre comment déclarer le tableau d’objets qui a été rendu dans l’exemple de code précédent.

private object[] curPriceTime = {4.25, DateTime.Now};
Private curPriceTime() As Object = {4.25, DateTime.Now}

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode utilise la même sémantique que la Format(String, Object[]) méthode . La WriteLine méthode de base est utilisée pour écrire la value méthode.

Voir aussi

S’applique à

WriteLine(String, Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::String ^ format, System::Object ^ arg0);
public override void WriteLine (string format, object arg0);
override this.WriteLine : string * obj -> unit
Public Overrides Sub WriteLine (format As String, arg0 As Object)

Paramètres

format
String

Chaîne contenant zéro, un ou plusieurs éléments de mise en forme.

arg0
Object

Objet à mettre en forme.

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour afficher une chaîne mise en forme avec la valeur de la CurrentCulture propriété.

// Use the WriteLine(string, object) method to
// render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine("The current cultural settings are {0}",
    CultureInfo.CurrentCulture);
writer.RenderEndTag();
' Use the WriteLine(string, object) method to
' render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine("The current cultural settings are {0}.", _
    CultureInfo.CurrentCulture)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode utilise la même sémantique que la Format(String, Object) méthode . La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(UInt32)

Important

Cette API n’est pas conforme CLS.

Alternative à la conformité CLS
System.Web.UI.HtmlTextWriter.WriteLine(Int64)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier non signé de 4 octets, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public override void WriteLine (uint value);
[<System.CLSCompliant(false)>]
override this.WriteLine : uint32 -> unit
Public Overrides Sub WriteLine (value As UInteger)

Paramètres

value
UInt32

Entier non signé de 4 octets à écrire dans le flux de sortie.

Attributs

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(String)

Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne de texte, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::String ^ s);
public override void WriteLine (string s);
override this.WriteLine : string -> unit
Public Overrides Sub WriteLine (s As String)

Paramètres

s
String

Chaîne à écrire dans le flux de sortie.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Single)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante simple précision, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(float value);
public override void WriteLine (float value);
override this.WriteLine : single -> unit
Public Overrides Sub WriteLine (value As Single)

Paramètres

value
Single

Nombre à virgule flottante simple précision à écrire dans le flux de sortie.

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour afficher la valeur du Single.Epsilon champ, qui est la plus petite valeur possible de la Single structure.

Cet exemple de code génère le balisage suivant :

<b>

1.401298E-45

</b>

// Use the WriteLine(Single) method to render the
// Epsilon field of the Single structure.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(Single.Epsilon);
writer.RenderEndTag();
' Use the WriteLine(Single) method to render the
' Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(Single.Epsilon)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Int32)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier signé de 32 octets, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(int value);
public override void WriteLine (int value);
override this.WriteLine : int -> unit
Public Overrides Sub WriteLine (value As Integer)

Paramètres

value
Int32

Entier signé de 32 octets à écrire dans le flux de sortie.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Int64)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d’un entier signé de 64 octets, suivis d’une chaîne de terminaison de ligne.

public:
 override void WriteLine(long value);
public override void WriteLine (long value);
override this.WriteLine : int64 -> unit
Public Overrides Sub WriteLine (value As Long)

Paramètres

value
Int64

Entier signé de 64 octets à écrire dans le flux de sortie.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Double)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante double précision, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(double value);
public override void WriteLine (double value);
override this.WriteLine : double -> unit
Public Overrides Sub WriteLine (value As Double)

Paramètres

value
Double

Nombre à virgule flottante double précision à écrire dans le flux de sortie.

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour afficher la valeur du Double.MaxValue champ.

Cet exemple de code génère le balisage suivant :

<label>

1.79769313486232E+308

</label>

// Use the WriteLine(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(Double.MaxValue);
writer.RenderEndTag();
' Use the WriteLine(Double) method to render
' the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(Double.MaxValue)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Char[])

Écrit dans le flux de sortie les espacements de tabulation en attente et un tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(cli::array <char> ^ buffer);
public override void WriteLine (char[] buffer);
override this.WriteLine : char[] -> unit
Public Overrides Sub WriteLine (buffer As Char())

Paramètres

buffer
Char[]

Tableau de caractères à écrire dans le flux de sortie.

Exemples

Cette section fournit deux exemples de code. Le premier montre comment créer un tableau. La deuxième montre comment utiliser ce tableau.

Ces exemples de code génèrent le balisage suivant :

<label>

hello world

</label>

L’exemple de code suivant montre comment créer un tableau de caractères qui indique hello world. Le champ est inclus dans le SpaceChar tableau, qui crée un espace entre les deux mots.

private char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};
Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

L’exemple de code suivant restitue le hello world tableau de caractères qui a été créé dans l’exemple précédent à l’aide de la WriteLine méthode .

// Render a character array as the contents of 
// a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.WriteLine(testChars);
writer.RenderEndTag();
' Render a character array as the 
' contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Char)

Écrit dans le flux de sortie les espacements de tabulation en attente et un caractère Unicode, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(char value);
public override void WriteLine (char value);
override this.WriteLine : char -> unit
Public Overrides Sub WriteLine (value As Char)

Paramètres

value
Char

Caractère à écrire dans le flux de sortie.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine(Boolean)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'une valeur Boolean, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(bool value);
public override void WriteLine (bool value);
override this.WriteLine : bool -> unit
Public Overrides Sub WriteLine (value As Boolean)

Paramètres

value
Boolean

Boolean à écrire dans le flux de sortie.

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à

WriteLine()

Écrit une chaîne de terminaison de ligne dans le flux de sortie.

public:
 override void WriteLine();
public override void WriteLine ();
override this.WriteLine : unit -> unit
Public Overrides Sub WriteLine ()

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour insérer une ligne après le rendu d’un <img> élément.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();
// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();
' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). Pour plus d'informations, consultez WriteLine.

Voir aussi

S’applique à

WriteLine(Object)

Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne.

public:
 override void WriteLine(System::Object ^ value);
public override void WriteLine (object value);
override this.WriteLine : obj -> unit
Public Overrides Sub WriteLine (value As Object)

Paramètres

value
Object

Objet à écrire dans le flux de sortie.

Exemples

L’exemple de code suivant montre comment utiliser la WriteLine méthode pour restituer la valeur de la CultureInfo.CurrentCulture propriété dans un contrôle.

// Use the WriteLine method to render an arbitrary
// object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.WriteLine(CultureInfo.CurrentCulture);
writer.RenderEndTag();
' Use the WriteLine method to render an arbitrary
' object, in this case a CutltureInfo object.
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.WriteLine(CultureInfo.CurrentCulture)
writer.RenderEndTag()

Remarques

La chaîne de terminaison de ligne par défaut est un retour chariot suivi d’un flux de ligne (« \r\n »). La WriteLine méthode de base est utilisée pour écrire le value paramètre.

Voir aussi

S’applique à