HtmlTextWriter.Write Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Escreve o tipo de dado especificado no fluxo de saída, juntamente com qualquer espaçamento de tabulação pendente.
Sobrecargas
| Name | Description |
|---|---|
| Write(Boolean) |
Escreve a representação textual de um valor booleano no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Char) |
Escreve a representação textual de um carácter Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Char[]) |
Escreve a representação textual de um array de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre separadores. |
| Write(Double) |
Escreve a representação textual de um número de ponto flutuante de dupla precisão no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Int32) |
Escreve a representação em texto de um inteiro assinado de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Int64) |
Escreve a representação em texto de um inteiro assinado de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Object) |
Escreve a representação textual de um objeto no stream de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(Single) |
Escreve a representação textual de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(String) |
Escreve a cadeia especificada no fluxo de saída, juntamente com qualquer espaçamento pendente de tabulação. |
| Write(String, Object) |
Escreve uma string de tabulação e uma string formatada no fluxo de saída, usando a mesma semântica do Format(String, Object) método, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(String, Object[]) |
Escreve uma cadeia formatada que contém a representação de texto de um array de objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object[]) método. |
| Write(Char[], Int32, Int32) |
Escreve a representação de texto de um subarray de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. |
| Write(String, Object, Object) |
Escreve uma cadeia formatada que contém a representação textual de dois objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object, Object) método. |
Write(Boolean)
Escreve a representação textual de um valor booleano no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(bool value);
public override void Write(bool value);
override this.Write : bool -> unit
Public Overrides Sub Write (value As Boolean)
Parâmetros
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Char)
Escreve a representação textual de um carácter Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(char value);
public override void Write(char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)
Parâmetros
- value
- Char
O carácter Unicode para escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte demonstra o uso do Write método para terminar a etiqueta de abertura de um <img> elemento usando a TagRightChar constante.
Este exemplo de código gera a seguinte marcação:
<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")
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Char[])
Escreve a representação textual de um array de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre separadores.
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())
Parâmetros
- buffer
- Char[]
O array de caracteres Unicode a escrever no fluxo de saída.
Exemplos
Esta secção fornece dois exemplos de código. A primeira mostra como criar uma variedade de personagens. O segundo mostra como usar o array.
Estes exemplos de código geram a seguinte marcação:
<label>
hello world
</label>
O seguinte exemplo de código demonstra como criar um array de caracteres que formam hello world. Incluído no array está o SpaceChar campo, que cria um espaço entre as duas palavras.
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}
O exemplo de código seguinte demonstra como usar o Write método para renderizar o hello world array de caracteres criado no exemplo de código anterior para uma página, quando o controlo que contém esse código de exemplo está incluído numa página.
// 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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Double)
Escreve a representação textual de um número de ponto flutuante de dupla precisão no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(double value);
public override void Write(double value);
override this.Write : double -> unit
Public Overrides Sub Write (value As Double)
Parâmetros
- value
- Double
O número de ponto flutuante de dupla precisão para escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte mostra como usar o Write método para renderizar o valor do Double.MaxValue campo.
Este exemplo de código gera a seguinte marcação:
<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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Int32)
Escreve a representação em texto de um inteiro assinado de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(int value);
public override void Write(int value);
override this.Write : int -> unit
Public Overrides Sub Write (value As Integer)
Parâmetros
- value
- Int32
O inteiro assinado de 32 bytes para escrever no fluxo de saída.
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Int64)
Escreve a representação em texto de um inteiro assinado de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(long value);
public override void Write(long value);
override this.Write : int64 -> unit
Public Overrides Sub Write (value As Long)
Parâmetros
- value
- Int64
O inteiro assinado de 64 bytes para escrever no fluxo de saída.
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Object)
Escreve a representação textual de um objeto no stream de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
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)
Parâmetros
- value
- Object
O objeto a escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte mostra como usar o Write método para renderizar o valor da CultureInfo.CurrentCulture propriedade.
Este exemplo de código gera a seguinte marcação:
This is a rendered CultureInfo object.
<bold>
O valor da CurrentCulture propriedade:
</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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Single)
Escreve a representação textual de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
public:
override void Write(float value);
public override void Write(float value);
override this.Write : single -> unit
Public Overrides Sub Write (value As Single)
Parâmetros
- value
- Single
O número de ponto flutuante de precisão simples para escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte demonstra como usar o Write método para renderizar o valor do Single.Epsilon campo, que é o menor valor possível da Single estrutura.
Este exemplo de código gera a seguinte marcação:
<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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(String)
Escreve a cadeia especificada no fluxo de saída, juntamente com qualquer espaçamento pendente de tabulação.
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)
Parâmetros
- s
- String
A cadeia a escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte demonstra como usar o Write método para renderizar uma cadeia entre as etiquetas de abertura e fecho de um elemento de marcação personalizado.
Este exemplo de código gera a seguinte marcação:
<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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(String, Object)
Escreve uma string de tabulação e uma string formatada no fluxo de saída, usando a mesma semântica do Format(String, Object) método, juntamente com qualquer espaçamento pendente entre tabuladores.
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)
Parâmetros
- format
- String
Uma cadeia que contém zero ou mais itens de formato.
- arg0
- Object
Um objeto a formatar.
Exemplos
O seguinte exemplo de código mostra como usar o Write método para renderizar uma cadeia formatada com o valor da CurrentCulture propriedade.
// 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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(String, Object[])
Escreve uma cadeia formatada que contém a representação de texto de um array de objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object[]) método.
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())
Parâmetros
- format
- String
Uma cadeia que contém zero ou mais itens de formato.
- arg
- Object[]
Um array de objetos para formatar.
Exemplos
Esta seção contém dois exemplos de código. O primeiro demonstra como renderizar uma string formatada e o conteúdo de um array. O segundo mostra como declarar o array.
O seguinte exemplo de código mostra como usar o Write método para renderizar uma string formatada e o conteúdo de um array de objetos, chamado curPriceTime. A chamada ao método renderiza o segundo membro do array antes de renderizar o primeiro membro.
// 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()
O exemplo de código seguinte demonstra como declarar o curPriceTime array de objetos.
private object[] curPriceTime = {4.25, DateTime.Now};
Private curPriceTime() As Object = {4.25, DateTime.Now}
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(Char[], Int32, Int32)
Escreve a representação de texto de um subarray de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.
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)
Parâmetros
- buffer
- Char[]
O array de caracteres a partir do qual escrever texto para o fluxo de saída.
- index
- Int32
A localização do índice no array onde a escrita começa.
- count
- Int32
O número de caracteres a escrever no fluxo de saída.
Exemplos
Esta secção fornece dois exemplos de código. O primeiro mostra como criar um array de caracteres. O segundo mostra como usar o array.
Estes exemplos de código geram a seguinte marcação:
<label>
hello
</label>
O seguinte exemplo de código mostra como criar um array de caracteres que formam hello world. Incluído no array está o SpaceChar campo, que cria um espaço entre as duas palavras.
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}
A parte seguinte do exemplo de código usa os index parâmetros e count do Write método para renderizar os primeiros cinco caracteres do array criados no exemplo anterior.
// 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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.
Ver também
Aplica-se a
Write(String, Object, Object)
Escreve uma cadeia formatada que contém a representação textual de dois objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object, Object) método.
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)
Parâmetros
- format
- String
Uma cadeia que contém zero ou mais itens de formato.
- arg0
- Object
Um objeto a formatar.
- arg1
- Object
Um objeto a formatar.
Exemplos
O exemplo de código seguinte mostra como usar o Write método para renderizar uma cadeia formatada e os valores das CurrentCulture propriedades e.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()
Observações
O Write método gera quaisquer separadores pendentes e depois chama o Write método base.