HttpResponse.Write Método

Definição

Grava informações no fluxo de saída de uma resposta HTTP.

Sobrecargas

Write(Char)

Grava um caractere em um fluxo de saída de resposta HTTP.

Write(Object)

Grava um Object em um fluxo de resposta HTTP.

Write(String)

Grava uma cadeia de caracteres em um fluxo de saída de resposta HTTP.

Write(Char[], Int32, Int32)

Grava uma matriz de caracteres em um fluxo de saída de resposta HTTP.

Write(Char)

Grava um caractere em um 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 caractere a ser gravado no fluxo de saída HTTP.

Exemplos

O exemplo a seguir cria uma série de constantes que são gravadas em uma página ASP.NET usando o método Write. O código chama essa versão do método Write para gravar constantes de caractere individuais 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)

Grava um Object em um 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 a ser gravado no fluxo de saída HTTP.

Aplica-se a

Write(String)

Grava uma cadeia de caracteres em um fluxo de saída de resposta HTTP.

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 de caracteres a ser gravada no fluxo de saída HTTP.

Exemplos

O exemplo a seguir ecoa o nome do cliente de volta ao navegador do cliente. O HtmlEncode método remove qualquer script mal-intencionado e caracteres inválidos que possam ter sido enviados no UserName campo de entrada.

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

Comentários

Páginas HTML geradas dinamicamente podem introduzir riscos de segurança se a entrada recebida de clientes Web não for validada quando for recebida de um cliente ou quando ela for transmitida de volta para um cliente. O script mal-intencionado inserido na entrada enviada a um site da Web e posteriormente gravado novamente em um cliente pode parecer ser proveniente de uma fonte confiável. Esse risco de segurança é chamado de ataque de script entre sites. Você sempre deve validar os dados recebidos de um cliente quando eles serão transmitidos do seu site para navegadores cliente.

Além disso, sempre que você escrever como HTML todos os dados recebidos como entrada, você deverá codificá-los usando uma técnica como HtmlEncode ou UrlEncode para impedir a execução de scripts mal-intencionados. Essa técnica é útil para dados que não foram validados quando foram recebidos.

Ao codificar ou filtrar dados, você deve especificar um conjunto de caracteres para suas páginas da 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 numéricas) e potencialmente ter script mal-intencionado inserido neles.

Aplica-se a

Write(Char[], Int32, Int32)

Grava uma matriz de caracteres em um fluxo de saída de resposta HTTP.

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

A matriz de caracteres a ser gravada.

index
Int32

A posição na matriz de caracteres em que a gravação começa.

count
Int32

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

Exemplos

O exemplo a seguir cria uma série de constantes que são gravadas em uma página ASP.NET usando o método Write. O código chama essa versão do método Write para gravar constantes de caractere individuais 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