HtmlTextWriter.WriteLine Método

Definição

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.

Ver também

Aplica-se a