HtmlTextWriter.WriteLine Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Grava dados em um fluxo de saída HtmlTextWriter, conforme especificado pelos parâmetros sobrecarregados, seguidos por uma cadeia de caracteres de terminador de linha. Todas as versões desse método gravam qualquer espaçamento de guia pendente no fluxo de saída.

Sobrecargas

WriteLine(String, Object, Object)	Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de dois objetos, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Char[], Int32, Int32)	Grava qualquer espaçamento de guia pendente e uma submatriz de caracteres Unicode, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(String, Object[])	Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de uma matriz de objetos, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(String, Object)	Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de um objeto, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(UInt32)	Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro sem sinal de 4 bytes, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(String)	Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres de texto, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Single)	Grava qualquer espaçamento de guia pendente e a representação de texto de um número de ponto flutuante de precisão simples, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Int32)	Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro com sinal de 32 bytes, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Int64)	Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro com sinal de 64 bytes, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Double)	Grava qualquer espaçamento de guia pendente e a representação de texto de um número de ponto flutuante de precisão dupla, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Char[])	Grava qualquer espaçamento de guia pendente e uma matriz de caracteres Unicode, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Char)	Grava qualquer espaçamento de guia pendente e um caractere Unicode, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine(Boolean)	Grava qualquer espaçamento de guia pendente e a representação de texto de um valor booliano, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.
WriteLine()	Grava uma cadeia de caracteres de terminador de linha no fluxo de saída.
WriteLine(Object)	Grava qualquer espaçamento de guia pendente e a representação de texto de um objeto, seguidos por uma cadeia de caracteres de terminador de linha, no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

WriteLine(String, Object, Object)

Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de dois objetos, seguidos por uma cadeia de caracteres 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 de caracteres que contém zero ou mais itens de formato.

arg0: Object

Um objeto a ser formatado.

arg1: Object

Um objeto a ser formatado.

Exemplos

O exemplo de código a seguir demonstra como usar o WriteLine método para renderizar uma cadeia de caracteres formatada e os valores da CurrentCulture propriedade e da Today propriedade .

// 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método usa a mesma semântica que o Format(String, Object, Object) método . O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Char[], Int32, Int32)

Grava qualquer espaçamento de guia pendente e uma submatriz de caracteres Unicode, seguidos por uma cadeia de caracteres de terminador 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[]

A matriz de caracteres da qual gravar texto no fluxo de saída.

index: Int32

A localização na matriz de caracteres em que a gravação começa.

count: Int32

O número de caracteres na matriz a gravar no fluxo de saída.

Exemplos

Esta seção contém dois exemplos de código. O primeiro demonstra como criar uma matriz de caracteres. O segundo demonstra como usar a matriz.

Esses exemplos de código geram a seguinte marcação:

<label>

hello

</label>

O exemplo de código a seguir demonstra como criar uma matriz de caracteres que explicam hello world. Incluído na matriz 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 a seguir usa os index parâmetros e count do WriteLine método para renderizar os cinco primeiros caracteres da matriz criada 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(String, Object[])

Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de uma matriz de objetos, seguidos por uma cadeia de caracteres 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 de caracteres que contém zero ou mais itens de formato.

arg: Object[]

Uma matriz de objeto a ser formatada.

Exemplos

Esta seção contém dois exemplos de código. O primeiro demonstra como renderizar uma cadeia de caracteres e uma matriz para o fluxo de saída. O segundo mostra como declarar a matriz.

O exemplo de código a seguir demonstra como usar o WriteLine método para renderizar uma cadeia de caracteres formatada e o conteúdo de uma matriz de objetos para o 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 a seguir mostra como declarar a matriz de objetos que foi renderizada no exemplo de código anterior.

private object[] curPriceTime = {4.25, DateTime.Now};

Private curPriceTime() As Object = {4.25, DateTime.Now}

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método usa a mesma semântica que o Format(String, Object[]) método . O WriteLine método base é usado para gravar o value método .

Confira também

Aplica-se a

WriteLine(String, Object)

Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres formatada contendo a representação de texto de um objeto, seguidos por uma cadeia de caracteres 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 de caracteres que contém zero ou mais itens de formato.

arg0: Object

Um objeto a ser formatado.

Exemplos

O exemplo de código a seguir mostra como usar o WriteLine método para renderizar uma cadeia de caracteres 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método usa a mesma semântica que o Format(String, Object) método . O WriteLine método base é usado para gravar o value parâmetro .

Confira 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)

Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro sem sinal de 4 bytes, seguidos por uma cadeia de caracteres 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 sem sinal de 4 bytes a gravar no fluxo de saída.

Atributos: CLSCompliantAttribute

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(String)

Grava qualquer espaçamento de guia pendente e uma cadeia de caracteres de texto, seguidos por uma cadeia de caracteres 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 de caracteres a ser gravada no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Single)

Grava qualquer espaçamento de guia pendente e a representação de texto de um número de ponto flutuante de precisão simples, seguidos por uma cadeia de caracteres de terminador 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 para gravar no fluxo de saída.

Exemplos

O exemplo de código a seguir 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Int32)

Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro com sinal de 32 bytes, seguidos por uma cadeia de caracteres 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 com sinal de 32 bytes a gravar no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Int64)

Grava qualquer espaçamento de guia pendente e a representação de texto de um inteiro com sinal de 64 bytes, seguidos por uma cadeia de caracteres 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 com sinal de 64 bytes a gravar no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Double)

Grava qualquer espaçamento de guia pendente e a representação de texto de um número de ponto flutuante de precisão dupla, seguidos por uma cadeia de caracteres 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 precisão dupla para gravar no fluxo de saída.

Exemplos

O exemplo de código a seguir 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Char[])

Grava qualquer espaçamento de guia pendente e uma matriz de caracteres Unicode, seguidos por uma cadeia de caracteres 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[]

A matriz de caracteres a gravar no fluxo de saída.

Exemplos

Esta seção fornece dois exemplos de código. O primeiro demonstra como criar uma matriz. O segundo demonstra como usar essa matriz.

Esses exemplos de código geram a seguinte marcação:

<label>

hello world

</label>

O exemplo de código a seguir mostra como criar uma matriz de caracteres que explicam hello world. Incluído na matriz 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 a seguir renderiza a hello world matriz de caracteres que foi criada 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Char)

Grava qualquer espaçamento de guia pendente e um caractere Unicode, seguidos por uma cadeia de caracteres de terminador 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 caractere a gravar no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine(Boolean)

Grava qualquer espaçamento de guia pendente e a representação de texto de um valor booliano, seguidos por uma cadeia de caracteres 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 booliano para gravar no fluxo de saída.

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a

WriteLine()

Grava uma cadeia de caracteres de terminador 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 a seguir demonstra como usar o WriteLine método para inserir uma linha depois que um <img> elemento é 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). Para obter mais informações, consulte WriteLine.

Confira também

Aplica-se a

WriteLine(Object)

Grava qualquer espaçamento de guia pendente e a representação de texto de um objeto, seguidos por uma cadeia de caracteres de terminador 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 ser gravado no fluxo de saída.

Exemplos

O exemplo de código a seguir mostra como usar o WriteLine método para renderizar o valor da CultureInfo.CurrentCulture propriedade em um controle .

// 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()

Comentários

A cadeia de caracteres do terminador de linha padrão é um retorno de carro seguido por um feed de linha ("\r\n"). O WriteLine método base é usado para gravar o value parâmetro .

Confira também

Aplica-se a