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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="UriTemplateTable" FullName="System.UriTemplateTable">
<TypeSignature Language="C#" Value="public class UriTemplateTable" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit UriTemplateTable extends System.Object" />
<AssemblyInfo>
<AssemblyName>System.ServiceModel</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.UriTemplateTable" /> is an associative set of <see cref="T:System.UriTemplate" /> objects bound to an object of the developer's choosing. It allows you to match candidate Uniform Resource Identifiers (URIs) against the templates in the set and retrieve the data associated with the matching templates. The contents of <see cref="T:System.UriTemplateTable" /> can be changed until the <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> method is called, at which time one of following types of validation occurs:</para>
<list type="bullet">
<item>
<para>When <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> is called passing in false, the <see cref="T:System.UriTemplateTable" /> checks to make sure the table contains no multiple structurally-equivalent templates. If it finds such templates, it throws an exception. This type of validation is used in conjunction with <see cref="M:System.UriTemplateTable.MatchSingle(System.Uri)" /> when you want to ensure only one template matches an incoming URI.</para>
</item>
<item>
<para>When <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> is called passing in true, multiple structurally-equivalent templates can be contained within a <see cref="T:System.UriTemplateTable" />. However, any query strings in the templates must not be ambiguous; identical query strings are allowed. crabout ambiguous query strings, see <format type="text/html"><a href="5cbbe03f-4a9e-4d44-9e02-c5773239cf52">UriTemplate and UriTemplateTable</a></format>.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A class that represents an associative set of <see cref="T:System.UriTemplate" /> objects.</para>
</summary>
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public UriTemplateTable ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters />
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.UriTemplateTable" /> class.</para>
</summary>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public UriTemplateTable (System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<UriTemplate,object>> keyValuePairs);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Collections.Generic.IEnumerable`1<valuetype System.Collections.Generic.KeyValuePair`2<class System.UriTemplate, object>> keyValuePairs) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="keyValuePairs" Type="System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.UriTemplate,System.Object>>" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.UriTemplateTable" /> class with the specified collection of key/value pairs.</para>
</summary>
<param name="keyValuePairs">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of key/value pairs that consist of URI templates and associated data.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public UriTemplateTable (Uri baseAddress);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Uri baseAddress) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="baseAddress" Type="System.Uri" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.UriTemplateTable" /> class with the specified base address.</para>
</summary>
<param name="baseAddress">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> instance that contains the base address.</param>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public UriTemplateTable (Uri baseAddress, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<UriTemplate,object>> keyValuePairs);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(class System.Uri baseAddress, class System.Collections.Generic.IEnumerable`1<valuetype System.Collections.Generic.KeyValuePair`2<class System.UriTemplate, object>> keyValuePairs) cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="baseAddress" Type="System.Uri" />
<Parameter Name="keyValuePairs" Type="System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<System.UriTemplate,System.Object>>" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Initializes a new instance of the <see cref="T:System.UriTemplateTable" /> class with the specified base address and collection of key/value pairs.</para>
</summary>
<param name="baseAddress">
<attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> instance that contains the base address.</param>
<param name="keyValuePairs">
<attribution license="cc4" from="Microsoft" modified="false" />A collection of key/value pairs that consist of URI templates and associated data.</param>
</Docs>
</Member>
<Member MemberName="BaseAddress">
<MemberSignature Language="C#" Value="public Uri BaseAddress { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Uri BaseAddress" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Uri</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="P:System.UriTemplateTable.BaseAddress" /> property can only be set prior to calling <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> or <see cref="M:System.UriTemplateTable.Match(System.Uri)" /> or <see cref="M:System.UriTemplateTable.MatchSingle(System.Uri)" /> otherwise an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets and sets the base address for the <see cref="T:System.UriTemplateTable" /> instance.</para>
</summary>
</Docs>
</Member>
<Member MemberName="IsReadOnly">
<MemberSignature Language="C#" Value="public bool IsReadOnly { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsReadOnly" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.UriTemplateTable" /> is read only after the <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> method is called.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a value that specifies whether the <see cref="T:System.UriTemplateTable" /> is read only.</para>
</summary>
</Docs>
</Member>
<Member MemberName="KeyValuePairs">
<MemberSignature Language="C#" Value="public System.Collections.Generic.IList<System.Collections.Generic.KeyValuePair<UriTemplate,object>> KeyValuePairs { get; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Collections.Generic.IList`1<valuetype System.Collections.Generic.KeyValuePair`2<class System.UriTemplate, object>> KeyValuePairs" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.Generic.IList<System.Collections.Generic.KeyValuePair<System.UriTemplate,System.Object>></ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Each <see cref="T:System.UriTemplate" /> instance in the table has data associated with it. The <see cref="P:System.UriTemplateTable.KeyValuePairs" /> property contains a collection of key value pairs where the key is a <see cref="T:System.UriTemplate" /> instance and the value is the data associated with the <see cref="T:System.UriTemplate" />. Values can only be added to <see cref="P:System.UriTemplateTable.KeyValuePairs" /> property prior to calling <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> or <see cref="M:System.UriTemplateTable.Match(System.Uri)" /> or <see cref="M:System.UriTemplateTable.MatchSingle(System.Uri)" /> otherwise a <see cref="T:System.NotSupportedException" /> is thrown.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets a collection of key/value pairs that consist of <see cref="T:System.UriTemplate" /> objects and their associated data.</para>
</summary>
</Docs>
</Member>
<Member MemberName="MakeReadOnly">
<MemberSignature Language="C#" Value="public void MakeReadOnly (bool allowDuplicateEquivalentUriTemplates);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance void MakeReadOnly(bool allowDuplicateEquivalentUriTemplates) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="allowDuplicateEquivalentUriTemplates" Type="System.Boolean" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>When the <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> method is called, one of the following types of validation occurs: </para>
<list type="bullet">
<item>
<para>When <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> is called passing in false, the <see cref="T:System.UriTemplateTable" /> checks to make sure the table contains no multiple structurally-equivalent templates. If it finds such templates, an exception is thrown. This type of validation is used in conjunction with <see cref="M:System.UriTemplateTable.MatchSingle(System.Uri)" /> when you want to ensure only one template matches an incoming URI.</para>
</item>
<item>
<para>When <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> is called passing in true, multiple structurally-equivalent templates can be contained within a <see cref="T:System.UriTemplateTable" />. However, any query strings in the templates must not be ambiguous; identical query strings are allowed. This type of validation is used in conjunction with <see cref="M:System.UriTemplateTable.Match(System.Uri)" /> when multiple template matches are allowed on the candidate URI.</para>
</item>
</list>
<para>Only the first call to <see cref="M:System.UriTemplateTable.MakeReadOnly(System.Boolean)" /> is honored, subsequent calls are ignored without any exception being thrown.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Makes the <see cref="T:System.UriTemplateTable" /> read only.</para>
</summary>
<param name="allowDuplicateEquivalentUriTemplates">
<attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to allow duplicate equivalent <see cref="T:System.UriTemplate" /> instances in the <see cref="T:System.UriTemplateTable" />.</param>
</Docs>
</Member>
<Member MemberName="Match">
<MemberSignature Language="C#" Value="public System.Collections.ObjectModel.Collection<UriTemplateMatch> Match (Uri uri);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Collections.ObjectModel.Collection`1<class System.UriTemplateMatch> Match(class System.Uri uri) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Collections.ObjectModel.Collection<System.UriTemplateMatch></ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uri" Type="System.Uri" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method may return multiple matches.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Attempts to match a candidate <see cref="T:System.Uri" /> to the <see cref="T:System.UriTemplateTable" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A collection of <see cref="T:System.UriTemplateMatch" /> instances.</para>
</returns>
<param name="uri">
<attribution license="cc4" from="Microsoft" modified="false" />The candidate URI.</param>
</Docs>
</Member>
<Member MemberName="MatchSingle">
<MemberSignature Language="C#" Value="public UriTemplateMatch MatchSingle (Uri uri);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.UriTemplateMatch MatchSingle(class System.Uri uri) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.UriTemplateMatch</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="uri" Type="System.Uri" />
</Parameters>
<Docs>
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method returns, at most, one match. If more than one match is found, a <see cref="T:System.UriTemplateMatchException" /> is thrown.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Attempts to match a candidate <see cref="T:System.Uri" /> to the <see cref="T:System.UriTemplateTable" />.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A single <see cref="T:System.UriTemplateMatch" /> instance.</para>
</returns>
<param name="uri">
<attribution license="cc4" from="Microsoft" modified="false" />The candidate URI.</param>
</Docs>
</Member>
</Members>
</Type>
|
