/
HttpCapabilitiesSectionHandler.xml
109 lines (101 loc) · 7.88 KB
/
HttpCapabilitiesSectionHandler.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<Type Name="HttpCapabilitiesSectionHandler" FullName="System.Web.Configuration.HttpCapabilitiesSectionHandler">
<TypeSignature Language="C#" Value="public class HttpCapabilitiesSectionHandler : System.Configuration.IConfigurationSectionHandler" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit HttpCapabilitiesSectionHandler extends System.Object implements class System.Configuration.IConfigurationSectionHandler" />
<TypeSignature Language="DocId" Value="T:System.Web.Configuration.HttpCapabilitiesSectionHandler" />
<TypeSignature Language="VB.NET" Value="Public Class HttpCapabilitiesSectionHandler
Implements IConfigurationSectionHandler" />
<TypeSignature Language="F#" Value="type HttpCapabilitiesSectionHandler = class
 interface IConfigurationSectionHandler" />
<TypeSignature Language="C++ CLI" Value="public ref class HttpCapabilitiesSectionHandler : System::Configuration::IConfigurationSectionHandler" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces>
<Interface>
<InterfaceName>System.Configuration.IConfigurationSectionHandler</InterfaceName>
</Interface>
</Interfaces>
<Docs>
<summary>Assists in reading in the <see langword="<browserCaps>" /> section of a configuration file and creating an instance of the <see cref="T:System.Web.HttpBrowserCapabilities" /> class that contains the capabilities information for the client browser.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The <xref:System.Web.Configuration.HttpCapabilitiesSectionHandler> class and the corresponding `<browserCaps>` configuration section have been deprecated in the .NET Framework version 2.0. The preferred method for managing browser capabilities is through browser definition files that are compiled for use by the <xref:System.Web.Configuration.BrowserCapabilitiesFactory> class. The goal of both configuration methodologies is to generate an instance of the <xref:System.Web.HttpBrowserCapabilities> class that can be accessed from the <xref:System.Web.HttpRequest.Browser%2A> property of the <xref:System.Web.HttpRequest> class.
Using the browser definition files to store browser capabilities affords advantages over the alternative. It offers improved performance because the browser definition information is parsed from the XML configuration file and compiled into a class ahead of time. The browser definition files are also easier to maintain:
- The definitions are hierarchical, and thus rely less on regular expressions to determine the browser capabilities.
- The definitions can be organized in multiple files, making them easier to manage.
- The definitions can be defined at any level, either at the Machine.config level or a specific application level. This eliminates the need to copy the entire set of definitions for the purpose of overriding the capabilities for a specific browser.
]]></format>
</remarks>
<related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/x3k2ssx2(v=vs.100)">ASP.NET Web Server Controls and Browser Capabilities</related>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public HttpCapabilitiesSectionHandler ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.Configuration.HttpCapabilitiesSectionHandler.#ctor" />
<MemberSignature Language="VB.NET" Value="Public Sub New ()" />
<MemberSignature Language="C++ CLI" Value="public:
 HttpCapabilitiesSectionHandler();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute FrameworkAlternate="netframework-4.0">
<AttributeName Language="C#">[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]</AttributeName>
<AttributeName Language="F#">[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]</AttributeName>
</Attribute>
</Attributes>
<Parameters />
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Web.Configuration.HttpCapabilitiesSectionHandler" /> class.</summary>
<remarks>To be added.</remarks>
<related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/x3k2ssx2(v=vs.100)">ASP.NET Web Server Controls and Browser Capabilities</related>
</Docs>
</Member>
<Member MemberName="Create">
<MemberSignature Language="C#" Value="public object Create (object parent, object configurationContext, System.Xml.XmlNode section);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance object Create(object parent, object configurationContext, class System.Xml.XmlNode section) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Web.Configuration.HttpCapabilitiesSectionHandler.Create(System.Object,System.Object,System.Xml.XmlNode)" />
<MemberSignature Language="VB.NET" Value="Public Function Create (parent As Object, configurationContext As Object, section As XmlNode) As Object" />
<MemberSignature Language="F#" Value="abstract member Create : obj * obj * System.Xml.XmlNode -> obj
override this.Create : obj * obj * System.Xml.XmlNode -> obj" Usage="httpCapabilitiesSectionHandler.Create (parent, configurationContext, section)" />
<MemberSignature Language="C++ CLI" Value="public:
 virtual System::Object ^ Create(System::Object ^ parent, System::Object ^ configurationContext, System::Xml::XmlNode ^ section);" />
<MemberType>Method</MemberType>
<Implements>
<InterfaceMember>M:System.Configuration.IConfigurationSectionHandler.Create(System.Object,System.Object,System.Xml.XmlNode)</InterfaceMember>
</Implements>
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="parent" Type="System.Object" />
<Parameter Name="configurationContext" Type="System.Object" />
<Parameter Name="section" Type="System.Xml.XmlNode" />
</Parameters>
<Docs>
<param name="parent">The parent configuration node.</param>
<param name="configurationContext">The configuration context of the current configuration file.</param>
<param name="section">The section of the configuration file that contains the information.</param>
<summary>Creates an instance of the <see cref="T:System.Web.HttpBrowserCapabilities" /> class that contains the capabilities information for the client browser.</summary>
<returns>An instance of <see cref="T:System.Web.HttpBrowserCapabilities" /> that contains the capabilities information for the client browser.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
This class derives its browser definition data from the `<browserCaps>` configuration section. This section is deprecated in the .NET Framework version 2.0.
]]></format>
</remarks>
<related type="Article" href="https://docs.microsoft.com/previous-versions/aspnet/x3k2ssx2(v=vs.100)">ASP.NET Web Server Controls and Browser Capabilities</related>
</Docs>
</Member>
</Members>
</Type>