HttpResponse.Write Método

Definição

Escreve informação para um fluxo de resposta HTTP de saída.

Sobrecargas

Name Description
Write(Char)

Escreve um carácter num fluxo de saída de resposta HTTP.

Write(Object)

Escreve num Object fluxo de resposta HTTP.

Write(String)

Escreve uma string num fluxo de resposta HTTP de saída.

Write(Char[], Int32, Int32)

Escreve um array de caracteres num fluxo de resposta HTTP de saída.

Write(Char)

Escreve um carácter num fluxo de saída de resposta HTTP.

public:
 void Write(char ch);
public void Write(char ch);
member this.Write : char -> unit
Public Sub Write (ch As Char)

Parâmetros

ch
Char

O carácter a escrever no fluxo de saída HTTP.

Exemplos

O exemplo seguinte cria uma série de constantes que são escritas numa página ASP.NET usando o método Write. O código chama esta versão do método Write para escrever constantes individuais de carácter na página.

    <%

        // Create a character array.
    char[] charArray = {'H', 'e', 'l', 'l', 'o', ',', ' ', 
                           'w', 'o', 'r', 'l', 'd'};

        // Write a character array to the client.
        Response.Write(charArray, 0, charArray.Length);

        // Write a single characher.
        Response.Write(';');

        // Write a sub-section of a character array to the client.
        Response.Write(charArray, 0, 5);
// <snippet6>
        // Write an object to the client.
        object obj = (object)13;
        Response.Write(obj);
// </snippet6>

    %>
      <%
         Dim charArray As Char() = {"H"c, "e"c, "l"c, "l"c, "o"c, ","c, " "c, _
                                 "w"c, "o"c, "r"c, "l"c, "d"c}
         ' Write a character array to the client.
         Response.Write(charArray, 0, charArray.Length)

         ' Write a single character.
         Response.Write(";"c)

         ' Write a sub-section of a character array to the client.
         Response.Write(charArray, 0, 5)
' <snippet6>
         ' Write an object to the client.
         Dim obj As Object
         obj = CType(13, Object)
         Response.Write(obj)
' </snippet6>
      %>

Aplica-se a

Write(Object)

Escreve num Object fluxo de resposta HTTP.

public:
 void Write(System::Object ^ obj);
public void Write(object obj);
member this.Write : obj -> unit
Public Sub Write (obj As Object)

Parâmetros

obj
Object

O Object to para escrever no fluxo de saída HTTP.

Aplica-se a

Write(String)

Escreve uma string num fluxo de resposta HTTP de saída.

public:
 void Write(System::String ^ s);
public void Write(string s);
member this.Write : string -> unit
Public Sub Write (s As String)

Parâmetros

s
String

A cadeia a escrever no fluxo de saída HTTP.

Exemplos

O exemplo seguinte ecoa o nome do cliente de volta ao navegador do cliente. O HtmlEncode método remove qualquer script malicioso e caracteres inválidos que possam ter sido submetidos no UserName campo de entrada.

Response.Write("Hello " + Server.HtmlEncode(Request.QueryString["UserName"]) + "<br>");
    
Response.Write("Hello " & Server.HtmlEncode(Request.QueryString("UserName")) & "<br>")

Observações

As páginas HTML geradas dinamicamente podem apresentar riscos de segurança se a entrada recebida de clientes Web não for validada, seja quando recebida de um cliente ou quando é transmitida de volta para um cliente. Um script malicioso que está embutido numa entrada submetida a um site Web e depois reescrito para um cliente pode parecer estar a originar-se de uma fonte confiável. Este risco de segurança é referido como ataque cross-site scripting. Deve sempre validar os dados recebidos de um cliente quando serão transmitidos do seu site para os navegadores do cliente.

Além disso, sempre que escrever em HTML qualquer dado recebido como entrada, deve codificar usando uma técnica como HtmlEncode ou UrlEncode para impedir a execução de scripts maliciosos. Esta técnica é útil para dados que não foram validados quando foram recebidos.

Ao codificar ou filtrar dados, deve especificar um conjunto de caracteres para as suas páginas Web para que o filtro possa identificar e remover quaisquer sequências de bytes que não pertençam a esse conjunto (como sequências não alfanuméricas) e que possam potencialmente ter scripts maliciosos incorporados.

Aplica-se a

Write(Char[], Int32, Int32)

Escreve um array de caracteres num fluxo de resposta HTTP de saída.

public:
 void Write(cli::array <char> ^ buffer, int index, int count);
public void Write(char[] buffer, int index, int count);
member this.Write : char[] * int * int -> unit
Public Sub Write (buffer As Char(), index As Integer, count As Integer)

Parâmetros

buffer
Char[]

O array de caracteres para escrever.

index
Int32

A posição no array de caracteres onde começa a escrita.

count
Int32

O número de caracteres a escrever, começando em index.

Exemplos

O exemplo seguinte cria uma série de constantes que são escritas numa página ASP.NET usando o método Write. O código chama esta versão do método Write para escrever constantes individuais de carácter na página.

    <%

        // Create a character array.
    char[] charArray = {'H', 'e', 'l', 'l', 'o', ',', ' ', 
                           'w', 'o', 'r', 'l', 'd'};

        // Write a character array to the client.
        Response.Write(charArray, 0, charArray.Length);

        // Write a single characher.
        Response.Write(';');

        // Write a sub-section of a character array to the client.
        Response.Write(charArray, 0, 5);
// <snippet6>
        // Write an object to the client.
        object obj = (object)13;
        Response.Write(obj);
// </snippet6>

    %>
      <%
         Dim charArray As Char() = {"H"c, "e"c, "l"c, "l"c, "o"c, ","c, " "c, _
                                 "w"c, "o"c, "r"c, "l"c, "d"c}
         ' Write a character array to the client.
         Response.Write(charArray, 0, charArray.Length)

         ' Write a single character.
         Response.Write(";"c)

         ' Write a sub-section of a character array to the client.
         Response.Write(charArray, 0, 5)
' <snippet6>
         ' Write an object to the client.
         Dim obj As Object
         obj = CType(13, Object)
         Response.Write(obj)
' </snippet6>
      %>

Aplica-se a