HtmlTextWriter.WriteLine 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 dados num HtmlTextWriter fluxo de saída, conforme especificado pelos parâmetros sobrecarregados, seguido de uma cadeia de terminadores de linha. Todas as versões deste método escrevem qualquer espaçamento de tabulação pendente no fluxo de saída.
Sobrecargas
| Name | Description |
|---|---|
| WriteLine(String, Object, Object) |
Escreve qualquer espaçamento de tabulação pendente e uma cadeia formatada que contenha a representação textual de dois objetos, seguida de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Char[], Int32, Int32) |
Escreve qualquer espaçamento de tabulação pendente e um subarray de caracteres Unicode, seguido de uma cadeia de terminadores de linha, no fluxo de saída. |
| WriteLine(String, Object[]) |
Escreve qualquer espaçamento de tabulação pendente e uma cadeia formatada que contenha a representação textual de um array de objetos, seguida de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(String, Object) |
Escreve qualquer espaçamento de tabulação pendente e uma string formatada contendo a representação textual de um objeto, seguida de uma string de terminador de linha, no fluxo de saída. |
| WriteLine(UInt32) |
Escreve qualquer espaçamento de tabulação pendente e a representação de texto de um inteiro sem sinal de 4 bytes, seguido de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(String) |
Escreve qualquer espaçamento de tabulação pendente e uma cadeia de texto, seguida de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Single) |
Escreve qualquer espaçamento pendente de tabulação e a representação textual de um número de ponto flutuante de precisão simples, seguido de uma cadeia de terminadores de linha, no fluxo de saída. |
| WriteLine(Int32) |
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um inteiro assinado de 32 bytes, seguido de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Int64) |
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um inteiro assinado de 64 bytes, seguida de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Double) |
Escreve qualquer espaçamento de tabulação pendente e a representação em texto de um número de ponto flutuante de dupla precisão, seguido de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Char[]) |
Escreve qualquer espaçamento de tabulação pendente e um array de caracteres Unicode, seguido de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine(Char) |
Escreve qualquer espaçamento de tabulação pendente e um carácter Unicode, seguido de uma cadeia de terminadores de linha, no fluxo de saída. |
| WriteLine(Boolean) |
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um valor booleano, seguida de uma cadeia de terminador de linha, no fluxo de saída. |
| WriteLine() |
Escreve uma cadeia de terminadores de linha no fluxo de saída. |
| WriteLine(Object) |
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um objeto, seguida de uma cadeia de terminadores de linha, no fluxo de saída. |
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
WriteLine(String, Object, Object)
Escreve qualquer espaçamento de tabulação pendente e uma cadeia formatada que contenha a representação textual de dois objetos, seguida de uma cadeia de terminador de linha, no fluxo de saída.
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)
Parâmetros
- format
- String
Uma cadeia contendo 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 demonstra como usar o WriteLine método para renderizar uma cadeia formatada e os valores da CurrentCulture propriedade e da propriedade Today .
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método utiliza a mesma semântica que o Format(String, Object, Object) método. O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Char[], Int32, Int32)
Escreve qualquer espaçamento de tabulação pendente e um subarray de caracteres Unicode, seguido de uma cadeia de terminadores de linha, no fluxo de saída.
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)
Parâmetros
- buffer
- Char[]
O array de caracteres a partir do qual escrever texto para o fluxo de saída.
- index
- Int32
O local no array de caracteres onde a escrita começa.
- count
- Int32
O número de caracteres no array a escrever no stream de saída.
Exemplos
Esta seção contém 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 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 utiliza os index parâmetros e count do WriteLine método para renderizar os primeiros cinco caracteres do array criados no exemplo de código anterior.
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(String, Object[])
Escreve qualquer espaçamento de tabulação pendente e uma cadeia formatada que contenha a representação textual de um array de objetos, seguida de uma cadeia de terminador de linha, no fluxo de saída.
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())
Parâmetros
- format
- String
Uma cadeia contendo 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 e um array para o fluxo de saída. O segundo mostra como declarar o array.
O exemplo de código seguinte demonstra como usar o WriteLine método para renderizar uma string formatada e o conteúdo de um array de objetos no fluxo de saída.
// 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()
O exemplo de código seguinte mostra como declarar o array de objetos que foi renderizado no exemplo de código anterior.
private object[] curPriceTime = {4.25, DateTime.Now};
Private curPriceTime() As Object = {4.25, DateTime.Now}
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método utiliza a mesma semântica que o Format(String, Object[]) método. O WriteLine método base é usado para escrever o value método.
Ver também
Aplica-se a
WriteLine(String, Object)
Escreve qualquer espaçamento de tabulação pendente e uma string formatada contendo a representação textual de um objeto, seguida de uma string de terminador de linha, no fluxo de saída.
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)
Parâmetros
- format
- String
Uma cadeia contendo zero ou mais itens de formato.
- arg0
- Object
Um objeto a formatar.
Exemplos
O seguinte exemplo de código mostra como usar o WriteLine método para renderizar uma cadeia formatada com o valor da CurrentCulture propriedade.
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método utiliza a mesma semântica que o Format(String, Object) método. O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(UInt32)
Importante
Esta API não está em conformidade com CLS.
- Alternativa em conformidade com CLS
- System.Web.UI.HtmlTextWriter.WriteLine(Int64)
Escreve qualquer espaçamento de tabulação pendente e a representação de texto de um inteiro sem sinal de 4 bytes, seguido de uma cadeia de terminador de linha, no fluxo de saída.
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)
Parâmetros
- value
- UInt32
O inteiro não assinado de 4 bytes para escrever no fluxo de saída.
- Atributos
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(String)
Escreve qualquer espaçamento de tabulação pendente e uma cadeia de texto, seguida de uma cadeia de terminador de linha, no fluxo de saída.
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)
Parâmetros
- s
- String
A cadeia a escrever no fluxo de saída.
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Single)
Escreve qualquer espaçamento pendente de tabulação e a representação textual de um número de ponto flutuante de precisão simples, seguido de uma cadeia de terminadores de linha, no fluxo de saída.
public:
override void WriteLine(float value);
public override void WriteLine(float value);
override this.WriteLine : single -> unit
Public Overrides Sub WriteLine (value As Single)
Parâmetros
- value
- Single
O número de ponto flutuante de precisão simples a escrever no fluxo de saída.
Exemplos
O exemplo de código seguinte mostra como usar o WriteLine 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 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Int32)
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um inteiro assinado de 32 bytes, seguido de uma cadeia de terminador de linha, no fluxo de saída.
public:
override void WriteLine(int value);
public override void WriteLine(int value);
override this.WriteLine : int -> unit
Public Overrides Sub WriteLine (value As Integer)
Parâmetros
- value
- Int32
O inteiro assinado de 32 bytes para escrever no fluxo de saída.
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Int64)
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um inteiro assinado de 64 bytes, seguida de uma cadeia de terminador de linha, no fluxo de saída.
public:
override void WriteLine(long value);
public override void WriteLine(long value);
override this.WriteLine : int64 -> unit
Public Overrides Sub WriteLine (value As Long)
Parâmetros
- value
- Int64
O inteiro assinado de 64 bytes para escrever no fluxo de saída.
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Double)
Escreve qualquer espaçamento de tabulação pendente e a representação em texto de um número de ponto flutuante de dupla precisão, seguido de uma cadeia de terminador de linha, no fluxo de saída.
public:
override void WriteLine(double value);
public override void WriteLine(double value);
override this.WriteLine : double -> unit
Public Overrides Sub WriteLine (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 WriteLine 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 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Char[])
Escreve qualquer espaçamento de tabulação pendente e um array de caracteres Unicode, seguido de uma cadeia de terminador de linha, no fluxo de saída.
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())
Parâmetros
- buffer
- Char[]
O array de caracteres para escrever no fluxo de saída.
Exemplos
Esta secção fornece dois exemplos de código. O primeiro mostra como criar um array. O segundo mostra como usar esse array.
Estes exemplos de código geram a seguinte marcação:
<label>
hello world
</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}
O exemplo de código seguinte renderiza o hello world array de caracteres criado no exemplo anterior usando o WriteLine método.
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Char)
Escreve qualquer espaçamento de tabulação pendente e um carácter Unicode, seguido de uma cadeia de terminadores de linha, no fluxo de saída.
public:
override void WriteLine(char value);
public override void WriteLine(char value);
override this.WriteLine : char -> unit
Public Overrides Sub WriteLine (value As Char)
Parâmetros
- value
- Char
O carácter a escrever no fluxo de saída.
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine(Boolean)
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um valor booleano, seguida de uma cadeia de terminador de linha, no fluxo de saída.
public:
override void WriteLine(bool value);
public override void WriteLine(bool value);
override this.WriteLine : bool -> unit
Public Overrides Sub WriteLine (value As Boolean)
Parâmetros
- value
- Boolean
O Booleano para escrever no fluxo de saída.
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.
Ver também
Aplica-se a
WriteLine()
Escreve uma cadeia de terminadores de linha no fluxo de saída.
public:
override void WriteLine();
public override void WriteLine();
override this.WriteLine : unit -> unit
Public Overrides Sub WriteLine ()
Exemplos
O exemplo de código seguinte demonstra como usar o WriteLine método para inserir uma linha depois de um <img> elemento ser renderizado.
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). Para obter mais informações, veja WriteLine.
Ver também
Aplica-se a
WriteLine(Object)
Escreve qualquer espaçamento de tabulação pendente e a representação textual de um objeto, seguida de uma cadeia de terminadores de linha, no fluxo de saída.
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)
Parâmetros
- value
- Object
O objeto a escrever no fluxo de saída.
Exemplos
O seguinte exemplo de código mostra como usar o WriteLine método para renderizar o valor da CultureInfo.CurrentCulture propriedade a um controlo.
// 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()
Observações
A sequência padrão do terminador de linha é um retorno de carro seguido de um avanço de linha ("\r\n"). O WriteLine método base é usado para escrever o value parâmetro.