HtmlTextWriter.Write Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit le type de données spécifié dans le flux de sortie, ainsi que tout espacement de tabulation en attente.
Surcharges
| Nom | Description |
|---|---|
| Write(Boolean) |
Écrit la représentation textuelle d’une valeur booléenne dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Char) |
Écrit la représentation textuelle d’un caractère Unicode dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Char[]) |
Écrit la représentation textuelle d’un tableau de caractères Unicode dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Double) |
Écrit la représentation textuelle d’un nombre à virgule flottante double précision dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Int32) |
Écrit la représentation textuelle d’un entier signé de 32 octets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Int64) |
Écrit la représentation textuelle d’un entier signé de 64 octets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Object) |
Écrit la représentation textuelle d’un objet dans le flux de sortie, ainsi que tout espacement de tabulation en attente. |
| Write(Single) |
Écrit la représentation textuelle d’un nombre à virgule flottante simple précision dans le flux de sortie, 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 tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la Format(String, Object) méthode, 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 Format(String, Object[]) méthode. |
| Write(Char[], Int32, Int32) |
Écrit la représentation textuelle d’un sous-tableau de caractères Unicode dans le flux de sortie, 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 Format(String, Object, Object) méthode. |
Write(Boolean)
Écrit la représentation textuelle d’une valeur booléenne dans le flux de sortie, 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
Remarques
La Write méthode génère tous les onglets en attente, puis appelle la Write méthode de base.
Voir aussi
S’applique à
Write(Char)
Écrit la représentation textuelle d’un caractère Unicode dans le flux de sortie, 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 Write méthode de base.
Voir aussi
S’applique à
Write(Char[])
Écrit la représentation textuelle d’un tableau de caractères Unicode dans le flux de sortie, 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 s’affichent hello world. Inclus dans le tableau est le SpaceChar champ, 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 dans 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 Write méthode de base.
Voir aussi
S’applique à
Write(Double)
Écrit la représentation textuelle d’un nombre à virgule flottante double précision dans le flux de sortie, 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 Write méthode de base.
Voir aussi
S’applique à
Write(Int32)
Écrit la représentation textuelle d’un entier signé de 32 octets dans le flux de sortie, 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 Write méthode de base.
Voir aussi
S’applique à
Write(Int64)
Écrit la représentation textuelle d’un entier signé de 64 octets dans le flux de sortie, 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 Write méthode de base.
Voir aussi
S’applique à
Write(Object)
Écrit la représentation textuelle d’un objet dans le flux de sortie, 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 Write méthode de base.
Voir aussi
S’applique à
Write(Single)
Écrit la représentation textuelle d’un nombre à virgule flottante simple précision dans le flux de sortie, 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 Write méthode de 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 Write méthode de base.
Voir aussi
S’applique à
Write(String, Object)
Écrit une chaîne tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la Format(String, Object) méthode, 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 ou plusieurs éléments de format.
- 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 Write méthode de 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 Format(String, Object[]) méthode.
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 ou plusieurs éléments de format.
- arg
- Object[]
Tableau d’objets à mettre en forme.
Exemples
Cette section contient deux exemples de code. Le premier 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 affiche le deuxième membre du tableau avant qu’il ne restitue 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 Write méthode de base.
Voir aussi
S’applique à
Write(Char[], Int32, Int32)
Écrit la représentation textuelle d’un sous-tableau de caractères Unicode dans le flux de sortie, 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 à partir duquel écrire du texte dans le flux de sortie.
- index
- Int32
Emplacement d’index dans le tableau où l’écriture 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 s’affichent hello world. Inclus dans le tableau est le SpaceChar champ, 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 paramètres et count les index paramètres de la Write méthode pour afficher les cinq premiers caractères du tableau créés 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 Write méthode de 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 Format(String, Object, Object) méthode.
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 ou plusieurs éléments de format.
- 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 propriétés et Today des CurrentCulture propriétés.
// 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 Write méthode de base.