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.Writes the specified data type to the output stream, along with any pending tab spacing.

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.Writes the text representation of a Boolean value to the output stream, along with any pending tab spacing.

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.Writes the text representation of a Unicode character to the output stream, along with any pending tab spacing.

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.Writes the text representation of an array of Unicode characters to the output stream, along with any pending tab spacing.

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.Writes the text representation of a double-precision floating-point number to the output stream, along with any pending tab spacing.

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.Writes the text representation of a 32-byte signed integer to the output stream, along with any pending tab spacing.

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.Writes the text representation of a 64-byte signed integer to the output stream, along with any pending tab spacing.

Write(Object)

Écrit dans le flux de sortie la représentation textuelle d'un objet, ainsi que tout espacement de tabulation en attente.Writes the text representation of an object to the output stream, along with any pending tab spacing.

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.Writes the text representation of a single-precision floating-point number to the output stream, along with any pending tab spacing.

Write(String)

Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente.Writes the specified string to the output stream, along with any pending tab spacing.

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.Writes a tab string and a formatted string to the output stream, using the same semantics as the Format(String, Object) method, along with any pending tab spacing.

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.Writes a formatted string that contains the text representation of an object array to the output stream, along with any pending tab spacing. Cette méthode utilise la même sémantique que la méthode Format(String, Object[]).This method uses the same semantics as the Format(String, Object[]) method.

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.Writes the text representation of a subarray of Unicode characters to the output stream, along with any pending tab spacing.

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.Writes a formatted string that contains the text representation of two objects to the output stream, along with any pending tab spacing. Cette méthode utilise la même sémantique que la méthode Format(String, Object, Object).This method uses the same semantics as the Format(String, Object, Object) method.

Write(Boolean)

Écrit dans le flux de sortie la représentation textuelle d'une valeur Boolean, ainsi que tout espacement de tabulation en attente.Writes the text representation of a Boolean value to the output stream, along with any pending tab spacing.

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.The Boolean to write to the output stream.

Remarques

La Write méthode génère tous les onglets qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a Unicode character to the output stream, along with any pending tab spacing.

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.The Unicode character to write to the output stream.

Exemples

L’exemple de code suivant illustre l' Write utilisation de la méthode pour terminer la balise d’ouverture d' TagRightChar un <img> élément à l’aide de la constante.The following code example demonstrates using the Write method to end the opening tag of an <img> element by using the TagRightChar constant.

Cet exemple de code restitue le balisage suivant :This code example renders the following markup:

<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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of an array of Unicode characters to the output stream, along with any pending tab spacing.

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.The array of Unicode characters to write to the output stream.

Exemples

Cette section fournit deux exemples de code.This section provides two code examples. Le premier montre comment créer un tableau de caractères.The first one demonstrates how to create an array of characters. Le second montre comment utiliser le tableau.The second one demonstrates how to use the array.

Ces exemples de code génèrent le balisage suivant :These code examples generate the following markup:

<label>

hello world

</label>

L’exemple de code suivant montre comment créer un tableau de caractères épelés hello world.The following code example demonstrates how to create an array of characters that spell out hello world. Le SpaceChar champ, qui est inclus dans le tableau, crée un espace entre les deux mots.Included in the array is the SpaceChar field, which creates a space between the two words.

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 restituer hello world le 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.The following code example demonstrates how to use the Write method to render the hello world character array created in the preceding code example to a page, when the control that contains this example code is included in a 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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a double-precision floating-point number to the output stream, along with any pending tab spacing.

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.The double-precision floating-point number to write to the output stream.

Exemples

L’exemple Write Double.MaxValue de code suivant montre comment utiliser la méthode pour restituer la valeur du champ.The following code example shows how to use the Write method to render the value of the Double.MaxValue field.

Cet exemple de code génère le balisage suivant :This code example generates the following markup:

<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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a 32-byte signed integer to the output stream, along with any pending tab spacing.

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.The 32-byte signed integer to write to the output stream.

Remarques

La Write méthode génère tous les onglets qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a 64-byte signed integer to the output stream, along with any pending tab spacing.

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.The 64-byte signed integer to write to the output stream.

Remarques

La Write méthode génère tous les onglets qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

Write(Object)

Écrit dans le flux de sortie la représentation textuelle d'un objet, ainsi que tout espacement de tabulation en attente.Writes the text representation of an object to the output stream, along with any pending tab spacing.

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.The object to write to the output stream.

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour restituer la valeur de CultureInfo.CurrentCulture la propriété.The following code example shows how to use the Write method to render the value of the CultureInfo.CurrentCulture property.

Cet exemple de code génère le balisage suivant :This code example generates the following markup:

This is a rendered CultureInfo object.

<bold>

Valeur de la CurrentCulture propriété :The value of the CurrentCulture property:

</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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a single-precision floating-point number to the output stream, along with any pending tab spacing.

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.The single-precision floating-point number to write to the output stream.

Exemples

L’exemple Write Single de code suivant montre comment utiliser la méthode pour restituer la valeur du champ,quiestlapluspetitevaleurpossibledelastructure.Single.EpsilonThe following code example demonstrates how to use the Write method to render the value of the Single.Epsilon field, which is the smallest possible value of the Single structure.

Cet exemple de code génère le balisage suivant :This code example generates the following markup:

<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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

Write(String)

Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente.Writes the specified string to the output stream, along with any pending tab spacing.

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.The string to write to the output stream.

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour restituer une chaîne entre les balises d’ouverture et de fermeture d’un élément de balisage personnalisé.The following code example demonstrates how to use the Write method to render a string between the opening and closing tags of a custom markup element.

Cet exemple de code génère le balisage suivant :This code example generates the following markup:

<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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes a tab string and a formatted string to the output stream, using the same semantics as the Format(String, Object) method, along with any pending tab spacing.

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.A string that contains zero or more format items.

arg0
Object

Objet à mettre en forme.An object to format.

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour restituer une chaîne mise en forme avec la CurrentCulture valeur de la propriété.The following code example shows how to use the Write method to render a formatted string with the value of the CurrentCulture property.

// 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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes a formatted string that contains the text representation of an object array to the output stream, along with any pending tab spacing. Cette méthode utilise la même sémantique que la méthode Format(String, Object[]).This method uses the same semantics as the Format(String, Object[]) method.

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.A string that contains zero or more format items.

arg
Object[]

Tableau d'objets à mettre en forme.An object array to format.

Exemples

Cette section contient deux exemples de code.This section contains two code examples. Le premier montre comment restituer une chaîne mise en forme et le contenu d’un tableau.The first one demonstrates how to render a formatted string and the contents of an array. Le deuxième montre comment déclarer le tableau.The second one demonstrates how to declare the array.

L’exemple de code suivant montre comment utiliser la Write méthode pour restituer une chaîne mise en forme et le contenu d’un tableau curPriceTimed’objets, nommé.The following code example shows how to use the Write method to render a formatted string and the contents of an object array, named curPriceTime. L’appel de méthode restitue le deuxième membre du tableau avant de restituer le premier membre.The method call renders the second member of the array before it renders the first member.

// 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 curPriceTime du tableau d’objets.The following code example demonstrates declaring the curPriceTime object array.

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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes the text representation of a subarray of Unicode characters to the output stream, along with any pending tab spacing.

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.The array of characters from which to write text to the output stream.

index
Int32

Emplacement dans le tableau de l'index auquel la copie commence.The index location in the array where writing begins.

count
Int32

Nombre de caractères à écrire dans le flux de sortie.The number of characters to write to the output stream.

Exemples

Cette section fournit deux exemples de code.This section provides two code examples. Le premier montre comment créer un tableau de caractères.The first one demonstrates how to create a character array. Le second montre comment utiliser le tableau.The second one demonstrates how to use the array.

Ces exemples de code génèrent le balisage suivant :These code examples generate the following markup:

<label>

hello

</label>

L’exemple de code suivant montre comment créer un tableau de caractères hello world.The following code example shows how to create an array of characters that spell out hello world. Le SpaceChar champ, qui est inclus dans le tableau, crée un espace entre les deux mots.Included in the array is the SpaceChar field, which creates a space between the two words.

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 index les count paramètres et de Write la méthode pour restituer les cinq premiers caractères du tableau créé dans l’exemple précédent.The following portion of the code example uses the index and count parameters of the Write method to render the first five characters of the array created in the preceding example.

// 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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

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.Writes a formatted string that contains the text representation of two objects to the output stream, along with any pending tab spacing. Cette méthode utilise la même sémantique que la méthode Format(String, Object, Object).This method uses the same semantics as the Format(String, Object, Object) method.

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.A string that contains zero or more format items.

arg0
Object

Objet à mettre en forme.An object to format.

arg1
Object

Objet à mettre en forme.An object to format.

Exemples

L’exemple de code suivant montre comment utiliser la Write méthode pour restituer une chaîne mise en forme et les CurrentCulture valeurs Today des propriétés et.The following code example shows how to use the Write method to render a formatted string and the values of the CurrentCulture and Today properties.

// 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 qui sont en attente, puis Write appelle la méthode de base.The Write method generates any tabs that are pending, and then calls the Write base method.

Voir aussi

S’applique à