HttpWebRequest.AllowAutoRedirect Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define um valor que indica se a solicitação deve seguir respostas de redirecionamento.

public:
 virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };

public virtual bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Overridable Property AllowAutoRedirect As Boolean

Valor da propriedade

Boolean

true se a solicitação deve seguir automaticamente as respostas de redirecionamento do recurso da Internet; caso contrário, false. O valor padrão é true.

Exemplos

O exemplo de código a seguir usa a propriedade AllowAutoRedirect para permitir que a solicitação siga as respostas de redirecionamento.

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->MaximumAutomaticRedirections = 1;
myHttpWebRequest->AllowAutoRedirect = true;
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );

// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");	
myHttpWebRequest.MaximumAutomaticRedirections=1;
myHttpWebRequest.AllowAutoRedirect=true;
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();

     'This method creates a new HttpWebRequest Object to the mentioned URL.
         Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
         myHttpWebRequest.MaximumAutomaticRedirections = 1
         myHttpWebRequest.AllowAutoRedirect = True
         Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

Defina AllowAutoRedirect para true se quiser que a solicitação siga automaticamente os cabeçalhos de redirecionamento HTTP para o novo local do recurso. O número máximo de redirecionamentos a seguir é definido pela propriedade MaximumAutomaticRedirections.

Se AllowAutoRedirect estiver definido como false, todas as respostas com um código de status HTTP de 300 a 399 serão retornadas ao aplicativo.

O cabeçalho autorização é limpo em redirecionamentos automáticos e HttpWebRequest tenta automaticamente se autenticar novamente no local redirecionado. Na prática, isso significa que um aplicativo não poderá colocar informações de autenticação personalizadas no cabeçalho autorização se for possível encontrar o redirecionamento. Em vez disso, o aplicativo deve implementar e registrar um módulo de autenticação personalizado. O System.Net.AuthenticationManager e a classe relacionada são usados para implementar um módulo de autenticação personalizado. O método AuthenticationManager.Register registra um módulo de autenticação personalizado.