HtmlTextWriter.Write Méthode

Définition

Écrit le type de données spécifié dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

Surcharges

Write(Boolean)

Écrit dans le flux de sortie la représentation textuelle d'une valeur Boolean, ainsi que tout espacement de tabulation en attente.

Write(Char)

Écrit dans le flux de sortie la représentation textuelle d'un caractère Unicode, ainsi que tout espacement de tabulation en attente.

Write(Char[])

Écrit dans le flux de sortie la représentation textuelle d'un tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente.

Write(Double)

Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante double précision, ainsi que tout espacement de tabulation en attente.

Write(Int32)

Écrit dans le flux de sortie la représentation textuelle d'un entier signé de 32 octets, ainsi que tout espacement de tabulation en attente.

Write(Int64)

Écrit dans le flux de sortie la représentation textuelle d’un entier signé de 64 octets, ainsi que tout espacement de tabulation en attente.

Write(Object)

Écrit dans le flux de sortie la représentation textuelle d'un objet, ainsi que tout espacement de tabulation en attente.

Write(Single)

Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante simple précision, ainsi que tout espacement de tabulation en attente.

Write(String)

Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

Write(String, Object)

Écrit une chaîne de tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la méthode Format(String, Object), ainsi que tout espacement de tabulation en attente.

Write(String, Object[])

Écrit une chaîne mise en forme qui contient la représentation textuelle d'un tableau d'objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object[]).

Write(Char[], Int32, Int32)

Écrit dans le flux de sortie la représentation textuelle d'un sous-tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente.

Write(String, Object, Object)

Écrit une chaîne mise en forme qui contient la représentation textuelle de deux objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object, Object).

Write(Boolean)

Écrit dans le flux de sortie la représentation textuelle d'une valeur Boolean, ainsi que tout espacement de tabulation en attente.

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

Paramètres

value
Boolean

Boolean à écrire dans le flux de sortie.

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Char)

Écrit dans le flux de sortie la représentation textuelle d'un caractère Unicode, ainsi que tout espacement de tabulation en attente.

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

Paramètres

value
Char

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

Exemples

L’exemple de code suivant illustre l’utilisation de la Write méthode pour mettre fin à la balise d’ouverture d’un <img> élément à l’aide de la TagRightChar constante .

Cet exemple de code affiche le balisage suivant :

<img alt="A custom image">

</img>

// Create a manually rendered <img> element
// that contains an alt attribute.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "A custom image.");
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
' Create a manually rendered <img> element
' that contains an alt attribute.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "A custom image.")
writer.Write(HtmlTextWriter.TagRightChar)
writer.WriteEndTag("img")

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Char[])

Écrit dans le flux de sortie la représentation textuelle d'un tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente.

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

Paramètres

buffer
Char[]

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

Exemples

Cette section fournit 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 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 montre comment utiliser la Write méthode pour afficher le hello world tableau de caractères créé dans l’exemple de code précédent sur une page, lorsque le contrôle qui contient cet exemple de code est inclus dans une page.

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Double)

Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante double précision, ainsi que tout espacement de tabulation en attente.

public:
 override void Write(double value);
public override void Write (double value);
override this.Write : double -> unit
Public Overrides Sub Write (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 Write 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 Write(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(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 Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Int32)

Écrit dans le flux de sortie la représentation textuelle d'un entier signé de 32 octets, ainsi que tout espacement de tabulation en attente.

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

Paramètres

value
Int32

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Int64)

Écrit dans le flux de sortie la représentation textuelle d’un entier signé de 64 octets, ainsi que tout espacement de tabulation en attente.

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

Paramètres

value
Int64

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Object)

Écrit dans le flux de sortie la représentation textuelle d'un objet, ainsi que tout espacement de tabulation en attente.

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

Paramètres

value
Object

Objet à écrire dans le flux de sortie.

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour afficher la valeur de la CultureInfo.CurrentCulture propriété .

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

This is a rendered CultureInfo object.

<bold>

Valeur de la CurrentCulture propriété :

</bold>

// Use the Write method to render an arbitrary
// object, in this case a CultureInfo object. 
writer.Write("This is a rendered CultureInfo Object.");
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(CultureInfo.CurrentCulture);
writer.RenderEndTag();
' Use the Write method to render an arbitrary
' object, in this case a CultureInfo object.
writer.Write("This is a rendered CultureInfo Object.")
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(CultureInfo.CurrentCulture)
writer.RenderEndTag()

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Single)

Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante simple précision, ainsi que tout espacement de tabulation en attente.

public:
 override void Write(float value);
public override void Write (float value);
override this.Write : single -> unit
Public Overrides Sub Write (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 Write 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 Write(Single) method to render the
// Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(Single.Epsilon);
writer.RenderEndTag();
' Use the Write(Single) method to render the
' Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(Single.Epsilon)
writer.RenderEndTag()

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(String)

Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

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

Paramètres

s
String

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

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour afficher une chaîne entre les balises d’ouverture et de fermeture d’un élément de balisage personnalisé.

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

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();
// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();
' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(String, Object)

Écrit une chaîne de tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la méthode Format(String, Object), ainsi que tout espacement de tabulation en attente.

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

Paramètres

format
String

Chaîne qui contient 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 Write méthode pour afficher une chaîne mise en forme avec la valeur de la CurrentCulture propriété .

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(String, Object[])

Écrit une chaîne mise en forme qui contient la représentation textuelle d'un tableau d'objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object[]).

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

Paramètres

format
String

Chaîne qui contient 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 afficher une chaîne mise en forme et le contenu d’un tableau. La deuxième montre comment déclarer le tableau.

L’exemple de code suivant montre comment utiliser la Write méthode pour afficher une chaîne mise en forme et le contenu d’un tableau d’objets, nommé curPriceTime. L’appel de méthode restitue le deuxième membre du tableau avant d’afficher le premier membre.

// 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.Write("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.Write("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

L’exemple de code suivant illustre la déclaration du tableau d’objets curPriceTime .

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(Char[], Int32, Int32)

Écrit dans le flux de sortie la représentation textuelle d'un sous-tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente.

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

Paramètres

buffer
Char[]

Tableau de caractères permettant d'écrire du texte dans le flux de sortie.

index
Int32

Emplacement dans le tableau de l'index auquel la copie commence.

count
Int32

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

Exemples

Cette section fournit deux exemples de code. La première 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}

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

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à

Write(String, Object, Object)

Écrit une chaîne mise en forme qui contient la représentation textuelle de deux objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object, Object).

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

Paramètres

format
String

Chaîne qui contient 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 Write méthode pour afficher une chaîne mise en forme et les valeurs des CurrentCulture propriétés et Today .

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

Remarques

La Write méthode génère tous les onglets en attente, puis appelle la méthode de Write base.

Voir aussi

S’applique à