HttpResponse.IsClientConnected Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um valor que indica se o cliente ainda está conectado ao servidor.
public:
property bool IsClientConnected { bool get(); };
public bool IsClientConnected { get; }
member this.IsClientConnected : bool
Public ReadOnly Property IsClientConnected As Boolean
Valor da propriedade
true
se o cliente está conectado no momento; caso contrário, false
.
Exemplos
O exemplo a seguir usa a IsClientConnected propriedade para verificar se o cliente que está solicitando a página permanece conectado ao servidor. Se IsClientConnected for true, o código chamará o Redirect método e o cliente exibirá outra página. Se IsClientConnected for false, o código chamará o End método e todo o processamento de página será encerrado.
<%@ 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>
Comentários
A IsClientConnected propriedade retorna false
quando as seguintes condições são verdadeiras:
A conexão com o cliente foi encerrada. Isso pode ocorrer se o Close método foi invocado ou se o cliente interrompeu a execução da página da Web ou navegou até outra página.
O HttpWorkerRequest objeto que está tratando a solicitação é
null
ou o HttpWorkerRequest.IsClientConnected método retornafalse
. Se um objeto personalizado HttpWorkerRequest manipular a solicitação, o HttpWorkerRequest.IsClientConnected método poderá ser definido com base em critérios personalizados. Por exemplo, a solicitação de trabalho personalizada pode forçar um tempo limite após um período de tempo.