HttpResponse.IsClientConnected Propriedade

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Recebe um valor que indica se o cliente ainda está ligado ao servidor.

public:
 property bool IsClientConnected { bool get(); };
public bool IsClientConnected { get; }
member this.IsClientConnected : bool
Public ReadOnly Property IsClientConnected As Boolean

Valor de Propriedade

Boolean

true se o cliente estiver atualmente ligado; caso contrário, false.

Exemplos

O exemplo seguinte utiliza a IsClientConnected propriedade para verificar se o cliente que está a pedir a página permanece ligado ao servidor. Se IsClientConnected for verdadeiro, o código chama o Redirect método e o cliente verá outra página. Se IsClientConnected for falso, então o código chama o End método e todo o processamento da página é terminado.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {
        // Check whether the browser remains
        // connected to the server.
        if (Response.IsClientConnected)
        {
            // If still connected, redirect
            // to another page. 
            Response.Redirect("Page2CS.aspx", false);
        }
        else
        {
            // If the browser is not connected
            // stop all response processing.
            Response.End();
        }
    }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Private Sub Page_Load(sender As Object, e As EventArgs)

        ' Check whether the browser remains
        ' connected to the server.
        If (Response.IsClientConnected) Then

            ' If still connected, redirect
            ' to another page.             
            Response.Redirect("Page2VB.aspx", false)
        Else
            ' If the browser is not connected
            ' stop all response processing.
            Response.End()
        End If
    End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    </form>
</body>
</html>

Observações

A IsClientConnected propriedade retorna false quando as seguintes condições são verdadeiras:

  • A ligação ao cliente foi terminada. Isto pode ocorrer se o Close método foi invocado, ou se o cliente parou a execução da página Web ou navegou para outra página.

  • O HttpWorkerRequest objeto que está a tratar o pedido é null ou o HttpWorkerRequest.IsClientConnected método devolve false. Se um objeto personalizado HttpWorkerRequest tratar o pedido, então o HttpWorkerRequest.IsClientConnected método pode ser definido com base em critérios personalizados. Por exemplo, o pedido de trabalhador personalizado pode forçar um tempo de espera após um período de tempo.

Aplica-se a