HtmlTextWriter.Write 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 el tipo de datos especificado en el flujo de salida, junto con el espaciado de tabulación pendiente.

Sobrecargas

Write(Boolean)	Escribe la representación de texto de un valor booleano en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.
Write(Char)	Escribe la representación de texto de un carácter Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.
Write(Char[])	Escribe la representación de texto de una matriz de caracteres Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.
Write(Double)	Escribe la representación de texto de un número de punto flotante de precisión doble en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(Int32)	Escribe la representación de texto de un entero de 32 bytes con signo en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(Int64)	Escribe la representación de texto de un entero de 64 bytes con signo en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(Object)	Escribe la representación de texto de un objeto en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(Single)	Escribe la representación de texto de un número de punto flotante de precisión sencilla en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(String)	Escribe la cadena especificada en el flujo de salida, junto con el espaciado de tabulación pendiente.
Write(String, Object)	Se escriben una cadena de tabulación y una cadena con formato en el flujo de salida, utilizando la misma semántica que el método Format(String, Object), junto con el espaciado de tabulación pendiente.
Write(String, Object[])	Escribe una cadena con formato que contiene la representación de texto de una matriz de objetos en el flujo de salida, junto con el espaciado de tabulación que quede pendiente. Este método utiliza la misma semántica que el método Format(String, Object[]).
Write(Char[], Int32, Int32)	Escribe la representación de texto de una submatriz de caracteres Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.
Write(String, Object, Object)	Escribe una cadena con formato que contiene la representación de texto de dos objetos en el flujo de salida, junto con el espaciado de tabulación que quede pendiente. Este método utiliza la misma semántica que el método Format(String, Object, Object).

Write(Boolean)

Escribe la representación de texto de un valor booleano en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.

public:
 override void Write(bool value);

public override void Write (bool value);

override this.Write : bool -> unit

Public Overrides Sub Write (value As Boolean)

Parámetros

value: Boolean

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

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Char)

Escribe la representación de texto de un carácter Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

Parámetros

value: Char

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

Ejemplos

En el ejemplo de código siguiente se muestra el uso del Write método para finalizar la etiqueta de apertura de un <img> elemento mediante la TagRightChar constante .

En este ejemplo de código se representa el marcado siguiente:

<img alt="A custom image">

</img>

// Create a manually rendered <img> element
// that contains an alt attribute.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "A custom image.");
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered <img> element
' that contains an alt attribute.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "A custom image.")
writer.Write(HtmlTextWriter.TagRightChar)
writer.WriteEndTag("img")

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Char[])

Escribe la representación de texto de una matriz de caracteres Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.

public:
 override void Write(cli::array <char> ^ buffer);

public override void Write (char[] buffer);

override this.Write : char[] -> unit

Public Overrides Sub Write (buffer As Char())

Parámetros

buffer: Char[]

Matriz de caracteres Unicode 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 de caracteres. En el segundo se muestra cómo usar la 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 muestra cómo usar el método para representar la Writehello world matriz de caracteres creada en el ejemplo de código anterior en una página, cuando el control que contiene este código de ejemplo se incluye en una página.

// Render a character array as the 
// contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(testChars);
writer.RenderEndTag();

' Render a character array as the 
' contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.Write(testChars)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Double)

Escribe la representación de texto de un número de punto flotante de precisión doble en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(double value);

public override void Write (double value);

override this.Write : double -> unit

Public Overrides Sub Write (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 Write 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 Write(Double) method to render
// the MaxValue field of the Double structure. 
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(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

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Int32)

Escribe la representación de texto de un entero de 32 bytes con signo en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(int value);

public override void Write (int value);

override this.Write : int -> unit

Public Overrides Sub Write (value As Integer)

Parámetros

value: Int32

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

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Int64)

Escribe la representación de texto de un entero de 64 bytes con signo en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(long value);

public override void Write (long value);

override this.Write : int64 -> unit

Public Overrides Sub Write (value As Long)

Parámetros

value: Int64

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

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(Object)

Escribe la representación de texto de un objeto en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(System::Object ^ value);

public override void Write (object value);

override this.Write : obj -> unit

Public Overrides Sub Write (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 Write método para representar el valor de la CultureInfo.CurrentCulture propiedad .

Este ejemplo de código genera el marcado siguiente:

This is a rendered CultureInfo object.

<bold>

Valor de la CurrentCulture propiedad :

</bold>

// Use the Write method to render an arbitrary
// object, in this case a CultureInfo object. 
writer.Write("This is a rendered CultureInfo Object.");
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the Write method to render an arbitrary
' object, in this case a CultureInfo object.
writer.Write("This is a rendered CultureInfo Object.")
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(CultureInfo.CurrentCulture)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

Se aplica a

Write(Single)

Escribe la representación de texto de un número de punto flotante de precisión sencilla en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(float value);

public override void Write (float value);

override this.Write : single -> unit

Public Overrides Sub Write (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 Write 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 Write(Single) method to render the
// Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B);
writer.Write(Single.Epsilon);
writer.RenderEndTag();

' Use the Write(Single) method to render the
' Epsilon field of the Single structure. 
writer.RenderBeginTag(HtmlTextWriterTag.B)
writer.Write(Single.Epsilon)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(String)

Escribe la cadena especificada en el flujo de salida, junto con el espaciado de tabulación pendiente.

public:
 override void Write(System::String ^ s);

public override void Write (string s);

override this.Write : string -> unit

Public Overrides Sub Write (s As String)

Parámetros

s: String

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Write método para representar una cadena entre las etiquetas de apertura y cierre de un elemento de marcado personalizado.

Este ejemplo de código genera el marcado siguiente:

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();

// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();

' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(String, Object)

Se escriben una cadena de tabulación y una cadena con formato en el flujo de salida, utilizando la misma semántica que el método Format(String, Object), junto con el espaciado de tabulación pendiente.

public:
 override void Write(System::String ^ format, System::Object ^ arg0);

public override void Write (string format, object arg0);

override this.Write : string * obj -> unit

Public Overrides Sub Write (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 Write método para representar una cadena con formato con el valor de la CurrentCulture propiedad .

// Use the Write(string, object) method to
// render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write("The current cultural settings are {0}",
    CultureInfo.CurrentCulture);
writer.RenderEndTag();

' Use the Write(string, object) method to
' render a formatted string and an object in it.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.Write("The current cultural settings are {0}.", _
    CultureInfo.CurrentCulture)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

Se aplica a

Write(String, Object[])

Escribe una cadena con formato que contiene la representación de texto de una matriz de objetos en el flujo de salida, junto con el espaciado de tabulación que quede pendiente. Este método utiliza la misma semántica que el método Format(String, Object[]).

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void Write (string format, params object[] arg);

override this.Write : string * obj[] -> unit

Public Overrides Sub Write (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 con formato y el contenido de una matriz. La segunda muestra cómo declarar la matriz.

En el ejemplo de código siguiente se muestra cómo usar el Write método para representar una cadena con formato y el contenido de una matriz de objetos, denominada curPriceTime. La llamada al método representa el segundo miembro de la matriz antes de representar el primer miembro.

// 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.Write("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.Write("The trade value at {1} is ${0}.", curPriceTime)
writer.RenderEndTag()

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

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

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

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

Se aplica a

Write(Char[], Int32, Int32)

Escribe la representación de texto de una submatriz de caracteres Unicode en el flujo de salida, junto con el espaciado de tabulación que quede pendiente.

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);

public override void Write (char[] buffer, int index, int count);

override this.Write : char[] * int * int -> unit

Public Overrides Sub Write (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 índice de la matriz donde se inicia la operación de escritura.

count: Int32

Número 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 de caracteres. En el segundo se muestra cómo usar la matriz.

Estos ejemplos de código generan el marcado siguiente:

<label>

hello

</label>

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

// Render a subarray of a character array
// as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write(testChars, 0, 5);
writer.RenderEndTag();

' Render a subarray of a character array
' as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.Write(testChars, 0, 5)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

TextWriter

Se aplica a

Write(String, Object, Object)

Escribe una cadena con formato que contiene la representación de texto de dos objetos en el flujo de salida, junto con el espaciado de tabulación que quede pendiente. Este método utiliza la misma semántica que el método Format(String, Object, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void Write (string format, object arg0, object arg1);

override this.Write : string * obj * obj -> unit

Public Overrides Sub Write (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 Write método para representar una cadena con formato y los valores de las CurrentCulture propiedades y Today .

// Use the Write(string,object,object) method to
// render a formatted string and two objects 
// in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label);
writer.Write("The current cultural settings are {0}. Today's date is {1}.",
    CultureInfo.CurrentCulture, DateTime.Today);
writer.RenderEndTag();

' Use the Write(string,object,object) method to
' render a formatted string and two objects 
' in the string.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.Write("The current cultural settings are {0}. Today's date is {1}.", _
    CultureInfo.CurrentCulture, DateTime.Today)
writer.RenderEndTag()

Comentarios

El Write método genera las pestañas pendientes y, a continuación, llama al Write método base.

Consulte también

Se aplica a

Compartir vía

HtmlTextWriter.Write Método

Definición

Sobrecargas

Write(Boolean)

Parámetros

Comentarios

Consulte también

Se aplica a

Write(Char)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(Char[])

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(Double)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(Int32)

Parámetros

Comentarios

Consulte también

Se aplica a

Write(Int64)

Parámetros

Comentarios

Consulte también

Se aplica a

Write(Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(Single)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String, Object[])

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(Char[], Int32, Int32)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Write(String, Object, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales