HtmlTextWriter.WriteLine Método

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe datos en un flujo de salida de HtmlTextWriter, que especifican los parámetros sobrecargados, seguidos de una cadena de terminador de línea. Todas las versiones de este método escriben el espaciado de tabulación pendiente en el flujo de salida.

Sobrecargas

WriteLine(String, Object, Object)	Escribe el espaciado de tabulación pendiente y una cadena con formato que contiene la representación de texto de dos objetos seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(Char[], Int32, Int32)	Escribe el espaciado de tabulación pendiente y una submatriz de caracteres Unicode, seguido de una cadena de terminador de línea en el flujo de salida.
WriteLine(String, Object[])	Escribe el espaciado de tabulación pendiente y una cadena con formato que representa el texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(String, Object)	Escribe el espaciado de tabulación pendiente y una cadena con formato que representa el texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(UInt32)	Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 4 bytes sin signo seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(String)	Escribe el espaciado de tabulación pendiente y una cadena de texto, seguido de una cadena de terminador de línea en el flujo de salida.
WriteLine(Single)	Escribe el espaciado de tabulación pendiente y la representación de texto de un número de punto flotante de precisión sencilla seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(Int32)	Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 32 bytes con signo, seguida de una cadena de terminador de línea, en el flujo de salida.
WriteLine(Int64)	Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 64 bytes con signo, seguida de una cadena de terminador de línea, en el flujo de salida.
WriteLine(Double)	Escribe el espaciado de tabulación pendiente y la representación de texto de un número de punto flotante de precisión doble seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine(Char[])	Escribe el espaciado de tabulación pendiente y una matriz de caracteres Unicode, seguido de una cadena de terminador de línea en el flujo de salida.
WriteLine(Char)	Escribe el espaciado de tabulación pendiente y un carácter Unicode, seguido de una cadena de terminador de línea en el flujo de salida.
WriteLine(Boolean)	Escribe el espaciado de tabulación pendiente y la representación de texto de un valor booleano seguida de una cadena de terminador de línea en el flujo de salida.
WriteLine()	Escribe una cadena de terminador de línea en el flujo de salida.
WriteLine(Object)	Escribe el espaciado de tabulación pendiente y la representación de texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

WriteLine(String, Object, Object)

Escribe el espaciado de tabulación pendiente y una cadena con formato que contiene la representación de texto de dos objetos seguida de una cadena de terminador de línea en el flujo de salida.

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

Cadena que contiene cero o más elementos de formato.

arg0: Object

Objeto al que se va a aplicar el formato.

arg1: Object

Objeto al que se va a aplicar el formato.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar una cadena con formato y los valores de la CurrentCulture propiedad y la Today propiedad .

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método usa la misma semántica que el Format(String, Object, Object) método . El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Char[], Int32, Int32)

Escribe el espaciado de tabulación pendiente y una submatriz de caracteres Unicode, seguido de una cadena de terminador de línea en el flujo de salida.

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[]

Matriz de caracteres con que se va a escribir texto en el flujo de salida.

index: Int32

Posición de la matriz de caracteres donde se inicia la operación de escritura.

count: Int32

Número de caracteres de la matriz que se van a escribir en el flujo de salida.

Ejemplos

Esta sección contiene dos ejemplos de código. La primera muestra cómo crear una matriz de caracteres. En el segundo se muestra cómo usar la matriz.

Estos ejemplos de código generan el marcado siguiente:

<label>

hello

</label>

En el ejemplo de código siguiente se muestra cómo crear una matriz de caracteres que deletree hello world. Incluido en la matriz es el SpaceChar campo , que crea un espacio entre las dos palabras.

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}

En el ejemplo de código siguiente se usan los index parámetros y count del WriteLine método para representar los cinco primeros caracteres de la matriz creada en el ejemplo 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()

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(String, Object[])

Escribe el espaciado de tabulación pendiente y una cadena con formato que representa el texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.

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

Cadena que contiene cero o más elementos de formato.

arg: Object[]

Matriz de objetos a la que se va a aplicar el formato.

Ejemplos

Esta sección contiene dos ejemplos de código. La primera muestra cómo representar una cadena y una matriz en el flujo de salida. En el segundo se muestra cómo declarar la matriz.

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar una cadena con formato y el contenido de una matriz de objetos en el flujo de salida.

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

En el ejemplo de código siguiente se muestra cómo declarar la matriz de objetos representada en el ejemplo de código anterior.

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

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método usa la misma semántica que el Format(String, Object[]) método . El WriteLine método base se usa para escribir el value método .

Consulte también

Se aplica a

WriteLine(String, Object)

Escribe el espaciado de tabulación pendiente y una cadena con formato que representa el texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.

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

Cadena que contiene cero o más elementos de formato.

arg0: Object

Objeto al que se va a aplicar el formato.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar una cadena con formato con el valor de la CurrentCulture propiedad .

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método usa la misma semántica que el Format(String, Object) método . El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(UInt32)

Importante

Esta API no es conforme a CLS.

Alternativa conforme a CLS: System.Web.UI.HtmlTextWriter.WriteLine(Int64)

Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 4 bytes sin signo seguida de una cadena de terminador de línea en el flujo de salida.

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

Entero de 4 bytes sin signo que se va a escribir en el flujo de salida.

Atributos: CLSCompliantAttribute

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(String)

Escribe el espaciado de tabulación pendiente y una cadena de texto, seguido de una cadena de terminador de línea en el flujo de salida.

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

Cadena que se va a escribir en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Single)

Escribe el espaciado de tabulación pendiente y la representación de texto de un número de punto flotante de precisión sencilla seguida de una cadena de terminador de línea en el flujo de salida.

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

Número de punto flotante de precisión sencilla que se va a escribir en el flujo de salida.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar el valor del Single.Epsilon campo, que es el valor más pequeño posible de la Single estructura.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Int32)

Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 32 bytes con signo, seguida de una cadena de terminador de línea, en el flujo de salida.

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

Entero de 32 bytes con signo que se va a escribir en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Int64)

Escribe el espaciado de tabulación pendiente y la representación de texto de un entero de 64 bytes con signo, seguida de una cadena de terminador de línea, en el flujo de salida.

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

Entero de 64 bytes con signo que se va a escribir en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Double)

Escribe el espaciado de tabulación pendiente y la representación de texto de un número de punto flotante de precisión doble seguida de una cadena de terminador de línea en el flujo de salida.

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

Número de punto flotante de precisión doble que se va a escribir en el flujo de salida.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar el valor del Double.MaxValue campo.

Este ejemplo de código genera el marcado siguiente:

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Char[])

Escribe el espaciado de tabulación pendiente y una matriz de caracteres Unicode, seguido de una cadena de terminador de línea en el flujo de salida.

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[]

Matriz de caracteres que se va a escribir en el flujo de salida.

Ejemplos

En esta sección se proporcionan dos ejemplos de código. La primera muestra cómo crear una matriz. En el segundo se muestra cómo usar esa matriz.

Estos ejemplos de código generan el marcado siguiente:

<label>

hello world

</label>

En el ejemplo de código siguiente se muestra cómo crear una matriz de caracteres que describen hello world. Incluido en la matriz es el SpaceChar campo , que crea un espacio entre las dos palabras.

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}

En el ejemplo de código siguiente se representa la hello world matriz de caracteres que se creó en el ejemplo anterior mediante el 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()

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Char)

Escribe el espaciado de tabulación pendiente y un carácter Unicode, seguido de una cadena de terminador de línea en el flujo de salida.

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

Carácter que se va a escribir en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine(Boolean)

Escribe el espaciado de tabulación pendiente y la representación de texto de un valor booleano seguida de una cadena de terminador de línea en el flujo de salida.

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

Objeto booleano que se va a escribir en el flujo de salida.

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

WriteLine()

Escribe una cadena de terminador de línea en el flujo de salida.

public:
 override void WriteLine();

public override void WriteLine ();

override this.WriteLine : unit -> unit

Public Overrides Sub WriteLine ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para insertar una línea después de representar un <img> elemento.

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). Para obtener más información, vea WriteLine.

Consulte también

Se aplica a

WriteLine(Object)

Escribe el espaciado de tabulación pendiente y la representación de texto de un objeto seguida de una cadena de terminador de línea en el flujo de salida.

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

Objeto que se va a escribir en el flujo de salida.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el WriteLine método para representar el valor de la CultureInfo.CurrentCulture propiedad en un control .

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

Comentarios

La cadena de terminador de línea predeterminada es un retorno de carro seguido de una fuente de línea ("\r\n"). El WriteLine método base se usa para escribir el value parámetro .

Consulte también

Se aplica a

Comparteix a través de

HtmlTextWriter.WriteLine Método

Definición

Sobrecargas

Comentarios

WriteLine(String, Object, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(Char[], Int32, Int32)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(String, Object[])

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(String, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(UInt32)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine(String)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine(Single)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(Int32)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine(Int64)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine(Double)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(Char[])

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

WriteLine(Char)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine(Boolean)

Parámetros

Comentarios

Consulte también

Se aplica a

WriteLine()

Ejemplos

Comentarios