HtmlTextWriter.Write Método

Definição

Escreve o tipo de dado especificado no fluxo de saída, juntamente com qualquer espaçamento de tabulação pendente.

Sobrecargas

Name Description
Write(Boolean)

Escreve a representação textual de um valor booleano no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Char)

Escreve a representação textual de um carácter Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Char[])

Escreve a representação textual de um array de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre separadores.

Write(Double)

Escreve a representação textual de um número de ponto flutuante de dupla precisão no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Int32)

Escreve a representação em texto de um inteiro assinado de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Int64)

Escreve a representação em texto de um inteiro assinado de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Object)

Escreve a representação textual de um objeto no stream de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(Single)

Escreve a representação textual de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(String)

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

Write(String, Object)

Escreve uma string de tabulação e uma string formatada no fluxo de saída, usando a mesma semântica do Format(String, Object) método, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(String, Object[])

Escreve uma cadeia formatada que contém a representação de texto de um array de objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object[]) método.

Write(Char[], Int32, Int32)

Escreve a representação de texto de um subarray de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

Write(String, Object, Object)

Escreve uma cadeia formatada que contém a representação textual de dois objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object, Object) método.

Write(Boolean)

Escreve a representação textual de um valor booleano no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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

A Boolean para escrever no fluxo de saída.

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Char)

Escreve a representação textual de um carácter Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 carácter Unicode para escrever no fluxo de saída.

Exemplos

O exemplo de código seguinte demonstra o uso do Write método para terminar a etiqueta de abertura de um <img> elemento usando a TagRightChar constante.

Este exemplo de código gera 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")

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Char[])

Escreve a representação textual de um array de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre separadores.

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

O array de caracteres Unicode a escrever no fluxo de saída.

Exemplos

Esta secção fornece dois exemplos de código. A primeira mostra como criar uma variedade de personagens. O segundo mostra como usar o array.

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

<label>

hello world

</label>

O seguinte exemplo de código demonstra como criar um array de caracteres que formam hello world. Incluído no array 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 seguinte demonstra como usar o Write método para renderizar o hello world array de caracteres criado no exemplo de código anterior para uma página, quando o controlo que contém esse código de exemplo está incluído numa 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()

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Double)

Escreve a representação textual de um número de ponto flutuante de dupla precisão no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 dupla precisão para escrever no fluxo de saída.

Exemplos

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

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Int32)

Escreve a representação em texto de um inteiro assinado de 32 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 assinado de 32 bytes para escrever no fluxo de saída.

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Int64)

Escreve a representação em texto de um inteiro assinado de 64 bytes no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 assinado de 64 bytes para escrever no fluxo de saída.

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Object)

Escreve a representação textual de um objeto no stream de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 escrever no fluxo de saída.

Exemplos

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

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Single)

Escreve a representação textual de um número de ponto flutuante de precisão simples no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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 escrever no fluxo de saída.

Exemplos

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

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(String)

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

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 a escrever no fluxo de saída.

Exemplos

O exemplo de código seguinte demonstra como usar o Write método para renderizar uma cadeia entre as etiquetas de abertura e fecho 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()

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(String, Object)

Escreve uma string de tabulação e uma string formatada no fluxo de saída, usando a mesma semântica do Format(String, Object) método, juntamente com qualquer espaçamento pendente entre tabuladores.

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 que contém zero ou mais itens de formato.

arg0
Object

Um objeto a formatar.

Exemplos

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

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(String, Object[])

Escreve uma cadeia formatada que contém a representação de texto de um array de objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object[]) método.

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 que contém zero ou mais itens de formato.

arg
Object[]

Um array de objetos para formatar.

Exemplos

Esta seção contém dois exemplos de código. O primeiro demonstra como renderizar uma string formatada e o conteúdo de um array. O segundo mostra como declarar o array.

O seguinte exemplo de código mostra como usar o Write método para renderizar uma string formatada e o conteúdo de um array de objetos, chamado curPriceTime. A chamada ao método renderiza o segundo membro do array 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 seguinte demonstra como declarar o curPriceTime array de objetos.

private object[] curPriceTime = {4.25, DateTime.Now};
Private curPriceTime() As Object = {4.25, DateTime.Now}

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(Char[], Int32, Int32)

Escreve a representação de texto de um subarray de caracteres Unicode no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores.

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

O array de caracteres a partir do qual escrever texto para o fluxo de saída.

index
Int32

A localização do índice no array onde a escrita começa.

count
Int32

O número de caracteres a escrever no fluxo de saída.

Exemplos

Esta secção fornece dois exemplos de código. O primeiro mostra como criar um array de caracteres. O segundo mostra como usar o array.

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

<label>

hello

</label>

O seguinte exemplo de código mostra como criar um array de caracteres que formam hello world. Incluído no array 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 seguinte do exemplo de código usa os index parâmetros e count do Write método para renderizar os primeiros cinco caracteres do array criados 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()

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a

Write(String, Object, Object)

Escreve uma cadeia formatada que contém a representação textual de dois objetos no fluxo de saída, juntamente com qualquer espaçamento pendente entre tabuladores. Este método utiliza a mesma semântica que o Format(String, Object, Object) método.

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 que contém zero ou mais itens de formato.

arg0
Object

Um objeto a formatar.

arg1
Object

Um objeto a formatar.

Exemplos

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

Observações

O Write método gera quaisquer separadores pendentes e depois chama o Write método base.

Ver também

Aplica-se a