HttpWebRequest.AllowAutoRedirect Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy żądanie powinno być zgodne z odpowiedziami przekierowania.Gets or sets a value that indicates whether the request should follow redirection responses.

public:
 virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };
public:
 property bool AllowAutoRedirect { bool get(); void set(bool value); };
public virtual bool AllowAutoRedirect { get; set; }
public bool AllowAutoRedirect { get; set; }
member this.AllowAutoRedirect : bool with get, set
Public Overridable Property AllowAutoRedirect As Boolean
Public Property AllowAutoRedirect As Boolean

Wartość właściwości

Boolean

true, jeśli żądanie powinno być automatycznie zgodne z odpowiedziami przekierowania z zasobu internetowego; w przeciwnym razie false.true if the request should automatically follow redirection responses from the Internet resource; otherwise, false. Wartością domyślną jest true.The default value is true.

Przykłady

Poniższy przykład kodu używa właściwości AllowAutoRedirect, aby umożliwić żądanie podążania za odpowiedziami przekierowania.The following code example uses the AllowAutoRedirect property to allow the request to follow redirection responses.

// 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)

Uwagi

Ustaw AllowAutoRedirect na true, jeśli chcesz, aby żądanie automatycznie podążać za nagłówkami przekierowań HTTP do nowej lokalizacji zasobu.Set AllowAutoRedirect to true if you want the request to automatically follow HTTP redirection headers to the new location of the resource. Maksymalna liczba przekierowań do wykonania jest ustawiana przez właściwość MaximumAutomaticRedirections.The maximum number of redirections to follow is set by the MaximumAutomaticRedirections property.

Jeśli AllowAutoRedirect jest ustawiona na false, wszystkie odpowiedzi z kodem stanu HTTP od 300 do 399 są zwracane do aplikacji.If AllowAutoRedirect is set to false, all responses with an HTTP status code from 300 to 399 is returned to the application.

Nagłówek autoryzacji jest wyczyszczony w obszarze Automatyczne przekierowania, a HttpWebRequest automatycznie próbuje ponownie uwierzytelnić się w przekierowanej lokalizacji.The Authorization header is cleared on auto-redirects and HttpWebRequest automatically tries to re-authenticate to the redirected location. W rzeczywistości oznacza to, że aplikacja nie może umieścić niestandardowych informacji o uwierzytelnianiu w nagłówku autoryzacji, jeśli jest możliwe przeprowadzenie przekierowania.In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Zamiast tego aplikacja musi zaimplementować i zarejestrować niestandardowy moduł uwierzytelniania.Instead, the application must implement and register a custom authentication module. System.Net.AuthenticationManager i powiązanej klasy są używane do implementowania niestandardowego modułu uwierzytelniania.The System.Net.AuthenticationManager and related class are used to implement a custom authentication module. Metoda AuthenticationManager.Register rejestruje niestandardowy moduł uwierzytelniania.The AuthenticationManager.Register method registers a custom authentication module.

Dotyczy