-
Notifications
You must be signed in to change notification settings - Fork 1.6k
/
Copy pathGenericUriParser.xml
130 lines (113 loc) · 8.98 KB
/
GenericUriParser.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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<Type Name="GenericUriParser" FullName="System.GenericUriParser">
<TypeSignature Language="C#" Value="public class GenericUriParser : UriParser" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit GenericUriParser extends System.UriParser" />
<TypeSignature Language="DocId" Value="T:System.GenericUriParser" />
<TypeSignature Language="VB.NET" Value="Public Class GenericUriParser
Inherits UriParser" />
<TypeSignature Language="F#" Value="type GenericUriParser = class
 inherit UriParser" />
<TypeSignature Language="C++ CLI" Value="public ref class GenericUriParser : UriParser" />
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>2.0.5.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<AssemblyInfo>
<AssemblyName>netstandard</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
</AssemblyInfo>
<AssemblyInfo>
<AssemblyName>System.Runtime</AssemblyName>
<AssemblyVersion>4.2.0.0</AssemblyVersion>
<AssemblyVersion>4.2.1.0</AssemblyVersion>
<AssemblyVersion>4.2.2.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<TypeForwardingChain>
<TypeForwarding From="netstandard" FromVersion="2.1.0.0" To="System.Runtime" ToVersion="5.0.0.0" FrameworkAlternate="net-5.0" />
<TypeForwarding From="netstandard" FromVersion="2.1.0.0" To="System.Runtime" ToVersion="6.0.0.0" FrameworkAlternate="net-6.0" />
<TypeForwarding From="netstandard" FromVersion="2.1.0.0" To="System.Runtime" ToVersion="7.0.0.0" FrameworkAlternate="net-7.0" />
<TypeForwarding From="netstandard" FromVersion="2.1.0.0" To="System.Runtime" ToVersion="8.0.0.0" FrameworkAlternate="net-8.0" />
<TypeForwarding From="netstandard" FromVersion="2.1.0.0" To="System.Runtime" ToVersion="9.0.0.0" FrameworkAlternate="net-9.0" />
</TypeForwardingChain>
<Base>
<BaseTypeName>System.UriParser</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>A customizable parser for a hierarchical URI.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If you want to create a parser based on a well-known scheme, use <xref:System.HttpStyleUriParser>, <xref:System.FtpStyleUriParser>, <xref:System.GopherStyleUriParser>, <xref:System.LdapStyleUriParser>, or <xref:System.NewsStyleUriParser>.
When creating a customizable parser, the behavior of the parser is specified by passing a bitwise combination of the values available in the <xref:System.GenericUriParserOptions?displayProperty=nameWithType> enumeration to the <xref:System.GenericUriParser> constructor.
The existing <xref:System.Uri?displayProperty=nameWithType> class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names (IDN). Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. This ensures application compatibility with prior versions of the .NET Framework.
All parsers derived from <xref:System.GenericUriParser> will not gain IRI and IDN support by default. The <xref:System.GenericUriParserOptions.Default> option does not include IRI and IDN support. Two new values are added to the <xref:System.GenericUriParserOptions?displayProperty=nameWithType> enumeration to indicate if a custom parser supports IRI and IDN.
For more information on IRI and IDN support, see the Remarks section for the <xref:System.Uri?displayProperty=nameWithType> class.
]]></format>
</remarks>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public GenericUriParser (GenericUriParserOptions options);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.GenericUriParserOptions options) cil managed" />
<MemberSignature Language="DocId" Value="M:System.GenericUriParser.#ctor(System.GenericUriParserOptions)" />
<MemberSignature Language="VB.NET" Value="Public Sub New (options As GenericUriParserOptions)" />
<MemberSignature Language="F#" Value="new GenericUriParser : GenericUriParserOptions -> GenericUriParser" Usage="new System.GenericUriParser options" />
<MemberSignature Language="C++ CLI" Value="public:
 GenericUriParser(GenericUriParserOptions options);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>System</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>2.0.5.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<AssemblyInfo>
<AssemblyName>netstandard</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
</AssemblyInfo>
<AssemblyInfo>
<AssemblyName>System.Runtime</AssemblyName>
<AssemblyVersion>4.2.0.0</AssemblyVersion>
<AssemblyVersion>4.2.1.0</AssemblyVersion>
<AssemblyVersion>4.2.2.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="options" Type="System.GenericUriParserOptions" />
</Parameters>
<Docs>
<param name="options">Specify the options for this <see cref="T:System.GenericUriParser" />.</param>
<summary>Create a customizable parser for a hierarchical URI.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Use this constructor as an argument to <xref:System.UriParser.Register%28System.UriParser%2CSystem.String%2CSystem.Int32%29?displayProperty=nameWithType>
If you want to create a parser based on a well-known scheme, use <xref:System.HttpStyleUriParser>, <xref:System.FtpStyleUriParser>, <xref:System.GopherStyleUriParser>, <xref:System.LdapStyleUriParser>, or <xref:System.NewsStyleUriParser>.
When creating a customizable parser, the behavior of the parser is specified by passing a bitwise combination of the values available in the <xref:System.GenericUriParserOptions?displayProperty=nameWithType> enumeration to the <xref:System.GenericUriParser> constructor.
The existing <xref:System.Uri?displayProperty=nameWithType> class has been extended to provide support for International Resource Identifiers (IRI) and Internationalized Domain Names (IDN). Current users will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. This ensures application compatibility with prior versions of the .NET Framework.
All parsers derived from <xref:System.GenericUriParser> will not gain IRI and IDN support by default. The <xref:System.GenericUriParserOptions.Default> option does not include IRI and IDN support. Two new values are added to the <xref:System.GenericUriParserOptions?displayProperty=nameWithType> enumeration to indicate if a custom parser supports IRI and IDN.
The <xref:System.GenericUriParserOptions.IriParsing> type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Whether IRI is used is dictated by configuration values.
The <xref:System.GenericUriParserOptions.Idn> type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Whether IDN is used is dictated by configuration values.
The configuration setting for the <xref:System.Configuration.IdnElement?displayProperty=nameWithType> is indirectly controlled by the <xref:System.Configuration.IriParsingElement?displayProperty=nameWithType> configuration setting that controls IRI processing in the <xref:System.Uri?displayProperty=nameWithType> class. IRI processing must be enabled for IDN processing to be possible. If IRI processing is disabled, then IDN processing will be set to the default setting where the .NET Framework 2.0 behavior is used for compatibility and IDN names are not used.
The Internationalized Domain Name (IDN) attribute only controls IDN processing. All other IRI processing (character normalization, for example) is performed by default.
For more information on IRI and IDN support, see the Remarks section for the <xref:System.Uri?displayProperty=nameWithType> class.
]]></format>
</remarks>
<altmember cref="T:System.Configuration.IdnElement" />
<altmember cref="T:System.Configuration.IriParsingElement" />
<altmember cref="T:System.GenericUriParserOptions" />
<altmember cref="T:System.Uri" />
</Docs>
</Member>
</Members>
</Type>