Comparteix a través de


HtmlTextWriter.WriteLine Método

Definición

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

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