HtmlTextWriter.Write Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Grava o tipo de dados especificado no fluxo de saída, juntamente a qualquer espaçamento de tabulação pendente.

Sobrecargas

Write(Boolean)	Grava a representação de texto de um valor booliano no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Char)	Grava a representação de texto de um caractere Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Char[])	Grava a representação de texto de uma matriz de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Double)	Grava a representação de texto de um número de ponto flutuante de precisão dupla no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Int32)	Grava a representação de texto de um inteiro com sinal de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Int64)	Grava a representação de texto de um inteiro com sinal de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Object)	Grava a representação de texto de um objeto no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(Single)	Grava a representação de texto de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(String)	Grava a cadeia de caracteres especificada no fluxo de saída, juntamente a qualquer espaçamento de tabulação pendente.
Write(String, Object)	Grava uma cadeia de caracteres de guia e uma cadeia de caracteres formatada no fluxo de saída, usando a mesma semântica do método Format(String, Object), juntamente com qualquer espaçamento de guia pendente.
Write(String, Object[])	Grava uma cadeia de caracteres formatada que contém a representação de texto de uma matriz de objeto para o fluxo de saída, juntamente com qualquer espaçamento de guia pendente. Esse método usa a mesma semântica do método Format(String, Object[]).
Write(Char[], Int32, Int32)	Grava a representação de texto de uma submatriz de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.
Write(String, Object, Object)	Grava uma cadeia de caracteres formatada que contém a representação de texto de dois objetos no fluxo de saída, juntamente com qualquer espaçamento de guia pendente. Esse método usa a mesma semântica do método Format(String, Object, Object).

Write(Boolean)

Grava a representação de texto de um valor booliano no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

O Boolean a gravar no fluxo de saída.

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Char)

Grava a representação de texto de um caractere Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

O caractere Unicode a gravar no fluxo de saída.

Exemplos

O exemplo de código a seguir demonstra como usar o Write método para encerrar a marca de abertura de um <img> elemento usando a TagRightChar constante .

Este exemplo de código renderiza a seguinte marcação:

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Char[])

Grava a representação de texto de uma matriz de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

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

Exemplos

Esta seção fornece 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 world

</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 demonstra como usar o Write método para renderizar a hello world matriz de caracteres criada no exemplo de código anterior para uma página, quando o controle que contém esse código de exemplo é incluído em uma 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()

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Double)

Grava a representação de texto de um número de ponto flutuante de precisão dupla no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Int32)

Grava a representação de texto de um inteiro com sinal de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

O inteiro com sinal de 32 bytes a gravar no fluxo de saída.

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Int64)

Grava a representação de texto de um inteiro com sinal de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

O inteiro com sinal de 64 bytes a gravar no fluxo de saída.

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(Object)

Grava a representação de texto de um objeto no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

O objeto a ser gravado no fluxo de saída.

Exemplos

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

Este exemplo de código gera a seguinte marcação:

This is a rendered CultureInfo object.

<bold>

O valor da CurrentCulture propriedade :

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter
• CurrentCulture

Write(Single)

Grava a representação de texto de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

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 demonstra como usar o Write 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 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()

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(String)

Grava a cadeia de caracteres especificada no fluxo de saída, juntamente a qualquer espaçamento de tabulação pendente.

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

A cadeia de caracteres a ser gravada no fluxo de saída.

Exemplos

O exemplo de código a seguir demonstra como usar o Write método para renderizar uma cadeia de caracteres entre as marcas de abertura e fechamento de um elemento de marcação personalizado.

Este exemplo de código gera a seguinte marcação:

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(String, Object)

Grava uma cadeia de caracteres de guia e uma cadeia de caracteres formatada no fluxo de saída, usando a mesma semântica do método Format(String, Object), juntamente com qualquer espaçamento de guia pendente.

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

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 Write método para renderizar uma cadeia de caracteres formatada com o valor da CurrentCulture propriedade .

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter
• Format(String, Object)
• CurrentCulture

Write(String, Object[])

Grava uma cadeia de caracteres formatada que contém a representação de texto de uma matriz de objeto para o fluxo de saída, juntamente com qualquer espaçamento de guia pendente. Esse método usa a mesma semântica do 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

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 formatada e o conteúdo de uma matriz. O segundo demonstra como declarar a matriz.

O exemplo de código a seguir mostra como usar o Write método para renderizar uma cadeia de caracteres formatada e o conteúdo de uma matriz de objetos, chamada curPriceTime. A chamada de método renderiza o segundo membro da matriz antes de renderizar o primeiro membro.

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

O exemplo de código a seguir demonstra a declaração da matriz de curPriceTime objetos.

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

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

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter
• Format(String, Object[])

Write(Char[], Int32, Int32)

Grava a representação de texto de uma submatriz de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento de guia pendente.

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

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

index

Int32

O local do índice na matriz no qual a leitura começa.

count

Int32

O número 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 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 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}

A parte a seguir do exemplo de código usa os index parâmetros e count do Write método para renderizar os cinco primeiros caracteres da matriz criada no exemplo 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()

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter

Write(String, Object, Object)

Grava uma cadeia de caracteres formatada que contém a representação de texto de dois objetos no fluxo de saída, juntamente com qualquer espaçamento de guia pendente. Esse método usa a mesma semântica do 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

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 mostra como usar o Write método para renderizar uma cadeia de caracteres formatada e os valores das CurrentCulture propriedades e 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()

Comentários

O Write método gera todas as guias pendentes e, em seguida, chama o Write método base.

Confira também

• TextWriter
• Format(String, Object, Object)
• CurrentCulture