.NETFramework：HttpContext

#region 程序集 System.Web, Version&＃61;4.0.0.0, Culture&＃61;neutral, PublicKeyToken&＃61;b03f5f7f11d50a3a
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\System.Web.dll
#endregionusing System.Collections;
using System.Collections.Generic;
using System.ComponentModel;
using System.Globalization;
using System.Security.Principal;
using System.Threading.Tasks;
using System.Web.Caching;
using System.Web.Configuration;
using System.Web.Instrumentation;
using System.Web.Profile;
using System.Web.SessionState;
using System.Web.WebSockets;namespace System.Web
{//// 摘要:// 封装有关个别 HTTP 请求的所有 HTTP 特定的信息。public sealed class HttpContext : IServiceProvider, IPrincipalContainer{//// 摘要:// 使用指定的辅助请求对象初始化 System.Web.HttpContext 类的新实例。//// 参数:// wr:// 当前 HTTP 请求的 System.Web.HttpWorkerRequest 对象。public HttpContext(HttpWorkerRequest wr);//// 摘要:// 使用指定的请求和响应对象初始化 System.Web.HttpContext 类的新实例。//// 参数:// request:// 当前 HTTP 请求的 System.Web.HttpRequest 对象。//// response:// 当前 HTTP 请求的 System.Web.HttpResponse 对象。public HttpContext(HttpRequest request, HttpResponse response);//// 摘要:// 为当前 HTTP 请求获取或设置 System.Web.HttpContext 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.HttpContext 实例。public static HttpContext Current { get; set; }//// 摘要:// 为当前 HTTP 请求获取 System.Web.HttpApplicationState 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.HttpApplicationState。若要获取当前 HTTP 请求的 System.Web.HttpApplication// 对象&＃xff0c;请使用 System.Web.HttpContext.ApplicationInstance。 &＃xff08;ASP.NET 使用 ApplicationInstance// 代替 Application 作为属性名来引用当前的 System.Web.HttpApplication 实例&＃xff0c;以避免 ASP.NET 与经典 ASP// 之间产生混淆。 在经典 ASP 中&＃xff0c;Application 引用全局应用程序状态字典。&＃xff09;public HttpApplicationState Application { get; }//// 摘要:// 获取或设置负责处理 HTTP 请求的 System.Web.IHttpHandler 对象。//// 返回结果:// 负责处理 HTTP 请求的 System.Web.IHttpHandler。public IHttpHandler Handler { get; set; }//// 摘要:// 获取父处理程序的 System.Web.IHttpHandler 对象。//// 返回结果:// System.Web.IHttpHandler 实例&＃xff0c;如果未找到上一个处理程序&＃xff0c;则为 null。public IHttpHandler PreviousHandler { get; }//// 摘要:// 获取表示当前正在执行的处理程序的 System.Web.IHttpHandler 对象。//// 返回结果:// 一个 System.Web.IHttpHandler&＃xff0c;表示当前正在执行的处理程序。public IHttpHandler CurrentHandler { get; }//// 摘要:// 为当前 HTTP 请求获取 System.Web.HttpRequest 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.HttpRequest。//// 异常:// T:System.Web.HttpException:// 在集成模式下在 IIS 7 下运行 Web 应用程序。public HttpRequest Request { get; }//// 摘要:// 获取当前 HTTP 响应的 System.Web.HttpResponse 对象。//// 返回结果:// 当前 HTTP 响应的 System.Web.HttpResponse。//// 异常:// T:System.Web.HttpException:// 在集成模式下在 IIS 7 下运行 Web 应用程序。public HttpResponse Response { get; }//// 摘要:// 获取当前 HTTP 响应的 System.Web.TraceContext 对象。//// 返回结果:// 当前 HTTP 响应的 System.Web.TraceContext。public TraceContext Trace { get; }//// 摘要:// 获取可用于在 HTTP 请求过程中在 System.Web.IHttpModule 接口和 System.Web.IHttpHandler 接口之间组织和共享数据的键/值集合。//// 返回结果:// System.Collections.IDictionary 键/值集合&＃xff0c;按指定的键提供对集合中个别值的访问。public IDictionary Items { get; }//// 摘要:// 为当前 HTTP 请求获取 System.Web.SessionState.HttpSessionState 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.SessionState.HttpSessionState 对象。public HttpSessionState Session { get; }//// 摘要:// 获取提供用于处理 Web 请求的方法的 System.Web.HttpServerUtility 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.HttpServerUtility。public HttpServerUtility Server { get; }//// 摘要:// 获取在处理 HTTP 请求的过程中累积的错误数组。//// 返回结果:// 当前 HTTP 请求的 System.Exception 对象数组。public Exception[] AllErrors { get; }//// 摘要:// 为当前 HTTP 请求获取或设置 System.Web.HttpApplication 对象。//// 返回结果:// 当前 HTTP 请求的 System.Web.HttpApplication。ASP.NET 使用 ApplicationInstance 代替 Application// 作为属性名来引用当前的 System.Web.HttpApplication 实例&＃xff0c;以避免 ASP.NET 与经典 ASP 之间产生混淆。 在经典 ASP// 中&＃xff0c;Application 引用全局应用程序状态字典。//// 异常:// T:System.InvalidOperationException:// 在集成模式下&＃xff0c;在 IIS 7.0 下运行 Web 应用程序并尝试将属性值从非 null 值赋予更改 null。public HttpApplication ApplicationInstance { get; set; }//// 摘要:// 获取或设置当前 HTTP 请求的安全信息。//// 返回结果:// 当前 HTTP 请求的安全信息。public IPrincipal User { get; set; }//// 摘要:// 获取当前用户配置文件的 System.Web.Profile.ProfileBase 对象。//// 返回结果:// 如果应用程序配置文件包含配置文件的属性的定义&＃xff0c;则为 System.Web.Profile.ProfileBase&＃xff1b;否则为 null。public ProfileBase Profile { get; }//// 摘要:// 获取或设置一个值&＃xff0c;该值指定 System.Web.Security.UrlAuthorizationModule 对象是否应跳过对当前请求的授权检查。//// 返回结果:// 如果 System.Web.Security.UrlAuthorizationModule 应跳过授权检查&＃xff0c;则为 true&＃xff1b;否则为 false。 默认值为// false。public bool SkipAuthorization { get; set; }//// 摘要:// 获取一个值&＃xff0c;该值指示当前 HTTP 请求是否处于调试模式。//// 返回结果:// 如果请求处于调试模式&＃xff0c;则为 true&＃xff1b;否则&＃xff0c;为 false。public bool IsDebuggingEnabled { get; }//// 摘要:// 获取一个值&＃xff0c;该值指示是否已为当前 HTTP 请求启用自定义错误。//// 返回结果:// 如果启用了自定义错误&＃xff0c;则为 true&＃xff1b;否则&＃xff0c;为 false。public bool IsCustomErrorEnabled { get; }//// 摘要:// 获取当前 HTTP 请求的初始时间戳。//// 返回结果:// 当前 HTTP 请求的时间戳。public DateTime Timestamp { get; }//// 摘要:// 获取当前应用程序域的 System.Web.Caching.Cache 对象。//// 返回结果:// 当前应用程序域的 System.Web.Caching.Cache。public Cache Cache { get; }//// 摘要:// 获取此要求的页检测服务实例的引用。//// 返回结果:// 此请求的页检测服务实例。public PageInstrumentationService PageInstrumentation { get; }//// 摘要:// 获取或设置一个值&＃xff0c;此值指示 ASP.NET 运行时是否应在请求超时时&＃xff0c;调用为该请求提供服务的线程上的 System.Threading.Thread.Abort。//// 返回结果:// 如果在线程超时时调用 System.Threading.Thread.Abort&＃xff0c;则为 true&＃xff1b;否则为 false。 默认值为 true。public bool ThreadAbortOnTimeout { get; set; }//// 摘要:// 获取在处理 HTTP 请求的过程中累积的第一个错误&＃xff08;如果有&＃xff09;。//// 返回结果:// 当前 HTTP 请求/响应过程的第一个 System.Exception&＃xff1b;如果在处理 HTTP 请求期间没有发生任何错误&＃xff0c;则为 null。 默认值为 null。public Exception Error { get; }//// 摘要:// 获取或设置一个值&＃xff0c;此值指示 ASP.NET 请求处理过程中是否允许非预期的异步操作。//// 返回结果:// 当异步 API 在不是预期的时间使用时 ASP.NET 将引发异常&＃xff0c;则为 false&＃xff0c;否则为 true。 默认值为 false。
[EditorBrowsable(EditorBrowsableState.Advanced)]public bool AllowAsyncDuringSyncStages { get; set; }//// 摘要:// 在 System.Web.HttpApplication 事件完成处理之后获取 ASP.NET 管道的当前进程点的值。//// 返回结果:// 如果启用了自定义错误&＃xff0c;则为 true&＃xff1b;否则&＃xff0c;为 false。//// 异常:// T:System.PlatformNotSupportedException:// 该操作所需要的集成的管道模式 IIS 7.0 并且至少.NET Framework 3.0。public bool IsPostNotification { get; }//// 摘要:// 获取一个 System.Web.RequestNotification 值&＃xff0c;该值指示当前正在处理的 System.Web.HttpApplication// 事件。//// 返回结果:// System.Web.RequestNotification 值之一。//// 异常:// T:System.PlatformNotSupportedException:// 该操作需要在集成的管道模式下 IIS 7.0 并且至少.NET Framework 版本 3.0。public RequestNotification CurrentNotification { get; }//// 摘要:// 获取用于 System.Web.WebSockets.AspNetWebSocket 连接而从服务器发送到客户端的协商协议。//// 返回结果:// 协商协议。public string WebSocketNegotiatedProtocol { get; }//// 摘要:// 获取客户要求的子协议列表的有序列表。//// 返回结果:// 请求的协议&＃xff0c;如果不是 System.Web.WebSockets.AspNetWebSocket 请求&＃xff0c;或者列表不存在则为 null。public IList<string> WebSocketRequestedProtocols { get; }//// 摘要:// 获取指示连接是否从 HTTP 连接升级到 System.Web.WebSockets.AspNetWebSocket 连接的值。//// 返回结果:// 如果连接正在升级&＃xff0c;则为 true&＃xff1b;否则为 false。public bool IsWebSocketRequestUpgrading { get; }//// 摘要:// 获取一个值&＃xff0c;该值指示此请求是否是一个 System.Web.WebSockets.AspNetWebSocket 请求。//// 返回结果:// 如果该请求是一个 System.Web.WebSockets.AspNetWebSocket 请求&＃xff0c;则为 true&＃xff0c;否则为 false。public bool IsWebSocketRequest { get; }//// 摘要:// 获取或设置包含适用于异步预加载模式的标志的对象。//// 返回结果:// 包含适用于异步预加载模式的标志的对象。public AsyncPreloadModeFlags AsyncPreloadMode { get; set; }//// 摘要:// 为当前应用程序返回请求的配置信息。//// 参数:// name:// 为其请求信息的应用程序配置标记。//// 返回结果:// 包含配置信息的对象。 &＃xff08;在使用之前&＃xff0c;将返回的配置节强制转换为适当的配置类型。&＃xff09;[Obsolete("The recommended alternative is System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection in System.Web.dll. http://go.microsoft.com/fwlink/?linkid&＃61;14202")]public static object GetAppConfig(string name);//// 摘要:// 根据指定的 System.Web.Compilation.ResourceExpressionFields.ClassKey 和 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性以及 System.Globalization.CultureInfo 对象&＃xff0c;获取一个应用程序级别资源对象。//// 参数:// classKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ClassKey 属性。//// resourceKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性。//// culture:// 一个字符串&＃xff0c;表示所请求资源的 System.Globalization.CultureInfo 对象。//// 返回结果:// 一个 System.Object&＃xff0c;表示请求的应用程序级别资源对象&＃xff08;对指定区域性对其进行了本地化&＃xff09;&＃xff1b;否则&＃xff0c;如果未找到资源对象&＃xff0c;或找到了资源对象但其没有请求的属性&＃xff0c;则为// null。//// 异常:// T:System.Resources.MissingManifestResourceException:// 资源对象为其指定 classKey 找不到参数。- 或 -主程序集不包含非特定区域性的资源&＃xff0c;这些资源是必需的由于缺少适当的附属程序集。public static object GetGlobalResourceObject(string classKey, string resourceKey, CultureInfo culture);//// 摘要:// 根据指定的 System.Web.Compilation.ResourceExpressionFields.ClassKey 和 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性&＃xff0c;获取应用程序级别资源对象。//// 参数:// classKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ClassKey 属性。//// resourceKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性。//// 返回结果:// 一个 System.Object&＃xff0c;表示请求的应用程序级别资源对象&＃xff1b;否则&＃xff0c;如果未找到资源对象&＃xff0c;或找到了资源对象但其没有请求的属性&＃xff0c;则为 null。//// 异常:// T:System.Resources.MissingManifestResourceException:// 具有指定的资源对象 classKey 找不到参数。- 或 -主程序集不包含非特定区域性的资源&＃xff0c;这些资源是必需的由于缺少适当的附属程序集。public static object GetGlobalResourceObject(string classKey, string resourceKey);//// 摘要:// 根据指定的 System.Web.Compilation.ExpressionBuilderContext.VirtualPath 和 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性以及 System.Globalization.CultureInfo 对象&＃xff0c;获取一个页级别资源对象。//// 参数:// virtualPath:// 本地资源对象的 System.Web.Compilation.ExpressionBuilderContext.VirtualPath 属性。//// resourceKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性。//// culture:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Globalization.CultureInfo 对象。//// 返回结果:// System.Object&＃xff0c;表示请求的本地资源对象&＃xff08;针对指定区域性进行了本地化的对象&＃xff09;&＃xff1b;否则&＃xff0c;如果找到了匹配的资源对象但不是 null 参数&＃xff0c;则为 resourceKey。//// 异常:// T:System.Resources.MissingManifestResourceException:// 未找到资源对象为指定 virtualPath 参数。//// T:System.ArgumentException:// 指定 virtualPath 参数不是当前应用程序的根目录中。//// T:System.InvalidOperationException:// 找不到页上的资源类。public static object GetLocalResourceObject(string virtualPath, string resourceKey, CultureInfo culture);//// 摘要:// 根据指定的 System.Web.Compilation.ExpressionBuilderContext.VirtualPath 和 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性&＃xff0c;获取页级别资源对象。//// 参数:// virtualPath:// 本地资源对象的 System.Web.Compilation.ExpressionBuilderContext.VirtualPath 属性。//// resourceKey:// 一个字符串&＃xff0c;表示所请求资源对象的 System.Web.Compilation.ResourceExpressionFields.ResourceKey// 属性。//// 返回结果:// System.Object&＃xff0c;表示请求的页级别资源对象&＃xff1b;否则&＃xff0c;如果找到了匹配的资源对象但不是 resourceKey 参数&＃xff0c;则为 null。//// 异常:// T:System.Resources.MissingManifestResourceException:// 未找到资源对象为指定 virtualPath 参数。//// T:System.ArgumentException:// 指定 virtualPath 参数不是当前应用程序的根目录中。//// T:System.InvalidOperationException:// 找不到页上的资源类。public static object GetLocalResourceObject(string virtualPath, string resourceKey);//// 摘要:// 接受一个使用指定用户函数和选项对象 System.Web.WebSockets.AspNetWebSocket 请求。//// 参数:// userFunc:// 用户函数。//// options:// 选项对象。//// 异常:// T:System.ArgumentNullException:// userFunc 参数为 null。//// T:System.NotSupportedException:// 此请求不是 System.Web.WebSockets.AspNetWebSocket 请求。public void AcceptWebSocketRequest(Func userFunc, AspNetWebSocketOptions options);//// 摘要:// 接受一个使用指定用户函数的 System.Web.WebSockets.AspNetWebSocket 请求。//// 参数:// userFunc:// 用户函数。//// 异常:// T:System.ArgumentNullException:// userFunc 参数为 null。//// T:System.NotSupportedException:// 此请求不是 System.Web.WebSockets.AspNetWebSocket 请求。public void AcceptWebSocketRequest(Func userFunc);//// 摘要:// 将异常添加到当前 HTTP 请求的异常集合中。//// 参数:// errorInfo:// 要添加到异常集合中的 System.Exception。public void AddError(Exception errorInfo);//// 摘要:// 引发在请求的 HTTP 部分结束时发生的虚拟事件。//// 参数:// callback:// HTTP 上下文对象。//// 返回结果:// 订阅标记。//// 异常:// T:System.ArgumentNullException:// callback 参数为 null。public ISubscriptionToken AddOnRequestCompleted(Action callback);//// 摘要:// 清除当前 HTTP 请求的所有错误。public void ClearError();//// 摘要:// 使对象的 System.IDisposable.Dispose 方法可以在此请求的 System.Web.WebSockets.AspNetWebSocket// 连接部分完成时进行调用。//// 参数:// target:// 在请求的 System.IDisposable.Dispose 连接部分完成时必须调动用其 System.Web.WebSockets.AspNetWebSocket// 方法的对象。//// 返回结果:// 订阅标记。public ISubscriptionToken DisposeOnPipelineCompleted(IDisposable target);//// 摘要:// 为当前 HTTP 请求返回所请求的配置信息。//// 参数:// name:// 为其请求信息的配置标记。//// 返回结果:// 指定的 System.Configuration.ConfigurationSection&＃xff0c;如果该节不存在&＃xff0c;则为 null&＃xff0c;或是如果该节不能在运行时访问&＃xff0c;则为一个内部对象。// &＃xff08;在使用之前&＃xff0c;将返回的对象强制转换为适当的配置类型。&＃xff09;[Obsolete("The recommended alternative is System.Web.HttpContext.GetSection in System.Web.dll. http://go.microsoft.com/fwlink/?linkid&＃61;14202")]public object GetConfig(string name);//// 摘要:// 获取当前应用程序的默认配置的指定配置节。//// 参数:// sectionName:// 配置节路径&＃xff08;使用 XPath 格式&＃xff09;和配置元素名称。//// 返回结果:// 指定的 System.Configuration.ConfigurationSection&＃xff0c;如果该节不存在&＃xff0c;则为 null&＃xff0c;或是如果该节不能在运行时访问&＃xff0c;则为一个内部对象。public object GetSection(string sectionName);//// 摘要:// 用于为请求指定处理程序。//// 参数:// handler:// 应处理请求的对象。//// 异常:// T:System.InvalidOperationException:// System.Web.HttpContext.RemapHandler(System.Web.IHttpHandler) 方法之后调用 System.Web.HttpApplication.MapRequestHandler// 事件发生。public void RemapHandler(IHttpHandler handler);//// 摘要:// 使用给定的路径、路径信息和查询字符串信息重写 URL。//// 参数:// filePath:// 内部重写路径。//// pathInfo:// 资源的附加路径信息。 有关详细信息&＃xff0c;请参阅System.Web.HttpRequest.PathInfo。//// queryString:// 请求查询字符串。//// 异常:// T:System.ArgumentNullException:// path 参数不是当前应用程序的根目录中。//// T:System.Web.HttpException:// filePath 参数不在当前应用程序的根目录下。public void RewritePath(string filePath, string pathInfo, string queryString);//// 摘要:// 使用给定虚拟路径、路径信息、查询字符串信息和一个布尔值重写 URL&＃xff0c;该布尔值用于指定是否将客户端文件路径设置为重写路径。//// 参数:// filePath:// 服务请求的资源的虚拟路径。//// pathInfo:// 用于 URL 重定向的附加路径信息。 有关详细信息&＃xff0c;请参阅System.Web.HttpRequest.PathInfo。//// queryString:// 用于 URL 重定向的请求查询字符串。//// setClientFilePath:// 若要将用于客户端资源的文件路径设置为 filePath 参数的值&＃xff0c;则为 true&＃xff1b;否则为 false。//// 异常:// T:System.ArgumentNullException:// path 参数不是当前应用程序的根目录中。//// T:System.Web.HttpException:// filePath 参数不在当前应用程序的根目录下。public void RewritePath(string filePath, string pathInfo, string queryString, bool setClientFilePath);//// 摘要:// 使用给定路径和一个布尔值重写 URL&＃xff0c;该布尔值用于指定是否修改服务器资源的虚拟路径。//// 参数:// path:// 内部重写路径。//// rebaseClientPath:// 如果重置虚拟路径&＃xff0c;则为 true&＃xff1b;如果保持虚拟路径不变&＃xff0c;则为 false。//// 异常:// T:System.ArgumentNullException:// path 参数为 null。//// T:System.Web.HttpException:// path 参数不是当前应用程序的根目录中。public void RewritePath(string path, bool rebaseClientPath);//// 摘要:// 使用给定路径重写 URL。//// 参数:// path:// 内部重写路径。//// 异常:// T:System.ArgumentNullException:// path 参数为 null。//// T:System.Web.HttpException:// path 参数不是当前应用程序的根目录中。public void RewritePath(string path);//// 摘要:// 设置支持 HTTP 请求所需的会话状态行为的类型。//// 参数:// sessionStateBehavior:// 枚举值之一&＃xff0c;该值指定需要什么类型的会话状态行为。//// 异常:// T:System.InvalidOperationException:// 该方法调用之后 System.Web.HttpApplication.AcquireRequestState 引发事件。public void SetSessionStateBehavior(SessionStateBehavior sessionStateBehavior);}
}