HttpWebRequest.AllowAutoRedirect 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示请求是否应遵循重定向响应。
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
属性值
true
请求是否应自动遵循来自 Internet 资源的重定向响应;否则,false
。 默认值为 true
。
示例
下面的代码示例使用 AllowAutoRedirect 属性允许请求遵循重定向响应。
// 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)
注解
谨慎
WebRequest
、HttpWebRequest
、ServicePoint
和 WebClient
已过时,不应将其用于新开发。 请改用 HttpClient。
如果希望请求自动遵循 HTTP 重定向标头到资源的新位置,请将 AllowAutoRedirect 设置为 true
。 要遵循的最大重定向数由 MaximumAutomaticRedirections 属性设置。
如果 AllowAutoRedirect 设置为 false
,则 HTTP 状态代码为 300 到 399 的所有响应将返回到应用程序。
在自动重定向上清除授权标头,HttpWebRequest 自动尝试重新对重定向位置进行身份验证。 实际上,这意味着如果可能遇到重定向,应用程序将无法将自定义身份验证信息放入授权标头中。 相反,应用程序必须实现并注册自定义身份验证模块。 System.Net.AuthenticationManager 和相关类用于实现自定义身份验证模块。 AuthenticationManager.Register 方法注册自定义身份验证模块。