HttpHeaders.xml 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <Type Name="HttpHeaders" FullName="System.Net.Http.Headers.HttpHeaders">
  3. <TypeSignature Language="C#" Value="public abstract class HttpHeaders : System.Collections.Generic.IEnumerable&lt;System.Collections.Generic.KeyValuePair&lt;string,System.Collections.Generic.IEnumerable&lt;string&gt;&gt;&gt;" />
  4. <TypeSignature Language="ILAsm" Value=".class public auto ansi abstract HttpHeaders extends System.Object implements class System.Collections.Generic.IEnumerable`1&lt;valuetype System.Collections.Generic.KeyValuePair`2&lt;string, class System.Collections.Generic.IEnumerable`1&lt;string&gt;&gt;&gt;, class System.Collections.IEnumerable" />
  5. <AssemblyInfo>
  6. <AssemblyName>System.Net.Http</AssemblyName>
  7. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  8. </AssemblyInfo>
  9. <Base>
  10. <BaseTypeName>System.Object</BaseTypeName>
  11. </Base>
  12. <Interfaces>
  13. <Interface>
  14. <InterfaceName>System.Collections.Generic.IEnumerable&lt;System.Collections.Generic.KeyValuePair&lt;System.String,System.Collections.Generic.IEnumerable&lt;System.String&gt;&gt;&gt;</InterfaceName>
  15. </Interface>
  16. </Interfaces>
  17. <Docs>
  18. <remarks>To be added.</remarks>
  19. <summary>
  20. <attribution license="cc4" from="Microsoft" modified="false" />
  21. <para>A collection of headers and their values as defined in RFC 2616.</para>
  22. </summary>
  23. </Docs>
  24. <Members>
  25. <Member MemberName=".ctor">
  26. <MemberSignature Language="C#" Value="protected HttpHeaders ();" />
  27. <MemberSignature Language="ILAsm" Value=".method familyhidebysig specialname rtspecialname instance void .ctor() cil managed" />
  28. <MemberType>Constructor</MemberType>
  29. <AssemblyInfo>
  30. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  31. </AssemblyInfo>
  32. <Parameters />
  33. <Docs>
  34. <remarks>To be added.</remarks>
  35. <summary>
  36. <attribution license="cc4" from="Microsoft" modified="false" />
  37. <para>Initializes a new instance of the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> class.</para>
  38. </summary>
  39. </Docs>
  40. </Member>
  41. <Member MemberName="Add">
  42. <MemberSignature Language="C#" Value="public void Add (string name, System.Collections.Generic.IEnumerable&lt;string&gt; values);" />
  43. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(string name, class System.Collections.Generic.IEnumerable`1&lt;string&gt; values) cil managed" />
  44. <MemberType>Method</MemberType>
  45. <AssemblyInfo>
  46. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  47. </AssemblyInfo>
  48. <ReturnValue>
  49. <ReturnType>System.Void</ReturnType>
  50. </ReturnValue>
  51. <Parameters>
  52. <Parameter Name="name" Type="System.String" />
  53. <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
  54. </Parameters>
  55. <Docs>
  56. <remarks>
  57. <attribution license="cc4" from="Microsoft" modified="false" />
  58. <para>The header <paramref name="values" /> will be parsed and validated.</para>
  59. <para>If the specified header does not exist, the <see cref="M:System.Net.Http.Headers.HttpHeaders.Add(System.String,System.Collections.Generic.IEnumerable{System.String})" /> method inserts a new header into the list of header name/value pairs.</para>
  60. <para>If the specified header is already present, <paramref name="values" /> are added to the comma-separated list of values associated with the header.</para>
  61. </remarks>
  62. <summary>
  63. <attribution license="cc4" from="Microsoft" modified="false" />
  64. <para>Adds the specified header and its values into the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  65. </summary>
  66. <param name="name">
  67. <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
  68. <param name="values">
  69. <attribution license="cc4" from="Microsoft" modified="false" />A list of header values to add to the collection.</param>
  70. </Docs>
  71. </Member>
  72. <Member MemberName="Add">
  73. <MemberSignature Language="C#" Value="public void Add (string name, string value);" />
  74. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Add(string name, string value) cil managed" />
  75. <MemberType>Method</MemberType>
  76. <AssemblyInfo>
  77. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  78. </AssemblyInfo>
  79. <ReturnValue>
  80. <ReturnType>System.Void</ReturnType>
  81. </ReturnValue>
  82. <Parameters>
  83. <Parameter Name="name" Type="System.String" />
  84. <Parameter Name="value" Type="System.String" />
  85. </Parameters>
  86. <Docs>
  87. <remarks>
  88. <attribution license="cc4" from="Microsoft" modified="false" />
  89. <para>The header <paramref name="value" /> will be parsed and validated.</para>
  90. <para>If the specified header does not exist, the <see cref="M:System.Net.Http.Headers.HttpHeaders.Add(System.String,System.String)" /> method inserts a new header into the list of header name/value pairs.</para>
  91. <para>If the specified header is already present, <paramref name="value" /> is added to the comma-separated list of values associated with the header.</para>
  92. </remarks>
  93. <summary>
  94. <attribution license="cc4" from="Microsoft" modified="false" />
  95. <para>Adds the specified header and its value into the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  96. </summary>
  97. <param name="name">
  98. <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
  99. <param name="value">
  100. <attribution license="cc4" from="Microsoft" modified="false" />The content of the header.</param>
  101. </Docs>
  102. </Member>
  103. <Member MemberName="Clear">
  104. <MemberSignature Language="C#" Value="public void Clear ();" />
  105. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Clear() cil managed" />
  106. <MemberType>Method</MemberType>
  107. <AssemblyInfo>
  108. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  109. </AssemblyInfo>
  110. <ReturnValue>
  111. <ReturnType>System.Void</ReturnType>
  112. </ReturnValue>
  113. <Parameters />
  114. <Docs>
  115. <remarks>To be added.</remarks>
  116. <summary>
  117. <attribution license="cc4" from="Microsoft" modified="false" />
  118. <para>Removes all headers from the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  119. </summary>
  120. </Docs>
  121. </Member>
  122. <Member MemberName="Contains">
  123. <MemberSignature Language="C#" Value="public bool Contains (string name);" />
  124. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool Contains(string name) cil managed" />
  125. <MemberType>Method</MemberType>
  126. <AssemblyInfo>
  127. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  128. </AssemblyInfo>
  129. <ReturnValue>
  130. <ReturnType>System.Boolean</ReturnType>
  131. </ReturnValue>
  132. <Parameters>
  133. <Parameter Name="name" Type="System.String" />
  134. </Parameters>
  135. <Docs>
  136. <remarks>To be added.</remarks>
  137. <summary>
  138. <attribution license="cc4" from="Microsoft" modified="false" />
  139. <para>Returns if a specific header exists in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  140. </summary>
  141. <returns>
  142. <attribution license="cc4" from="Microsoft" modified="false" />
  143. <para>Returns <see cref="T:System.Boolean" />.</para>
  144. <para>true is the specified header exists in the collection; otherwise false.</para>
  145. </returns>
  146. <param name="name">
  147. <attribution license="cc4" from="Microsoft" modified="false" />The specific header.</param>
  148. </Docs>
  149. </Member>
  150. <Member MemberName="GetEnumerator">
  151. <MemberSignature Language="C#" Value="public System.Collections.Generic.IEnumerator&lt;System.Collections.Generic.KeyValuePair&lt;string,System.Collections.Generic.IEnumerable&lt;string&gt;&gt;&gt; GetEnumerator ();" />
  152. <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance class System.Collections.Generic.IEnumerator`1&lt;valuetype System.Collections.Generic.KeyValuePair`2&lt;string, class System.Collections.Generic.IEnumerable`1&lt;string&gt;&gt;&gt; GetEnumerator() cil managed" />
  153. <MemberType>Method</MemberType>
  154. <AssemblyInfo>
  155. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  156. </AssemblyInfo>
  157. <ReturnValue>
  158. <ReturnType>System.Collections.Generic.IEnumerator&lt;System.Collections.Generic.KeyValuePair&lt;System.String,System.Collections.Generic.IEnumerable&lt;System.String&gt;&gt;&gt;</ReturnType>
  159. </ReturnValue>
  160. <Parameters />
  161. <Docs>
  162. <remarks>To be added.</remarks>
  163. <summary>
  164. <attribution license="cc4" from="Microsoft" modified="false" />
  165. <para>Returns an enumerator that can iterate through the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> instance.</para>
  166. </summary>
  167. <returns>
  168. <attribution license="cc4" from="Microsoft" modified="false" />
  169. <para>Returns <see cref="T:System.Collections.Generic.IEnumerator`1" />.</para>
  170. <para>An enumerator for the <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
  171. </returns>
  172. </Docs>
  173. </Member>
  174. <Member MemberName="GetValues">
  175. <MemberSignature Language="C#" Value="public System.Collections.Generic.IEnumerable&lt;string&gt; GetValues (string name);" />
  176. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Collections.Generic.IEnumerable`1&lt;string&gt; GetValues(string name) cil managed" />
  177. <MemberType>Method</MemberType>
  178. <AssemblyInfo>
  179. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  180. </AssemblyInfo>
  181. <ReturnValue>
  182. <ReturnType>System.Collections.Generic.IEnumerable&lt;System.String&gt;</ReturnType>
  183. </ReturnValue>
  184. <Parameters>
  185. <Parameter Name="name" Type="System.String" />
  186. </Parameters>
  187. <Docs>
  188. <remarks>To be added.</remarks>
  189. <summary>
  190. <attribution license="cc4" from="Microsoft" modified="false" />
  191. <para>Returns all header values for a specified header stored in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  192. </summary>
  193. <returns>
  194. <attribution license="cc4" from="Microsoft" modified="false" />
  195. <para>Returns <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
  196. <para>An array of header strings.</para>
  197. </returns>
  198. <param name="name">
  199. <attribution license="cc4" from="Microsoft" modified="false" />The specified header to return values for.</param>
  200. </Docs>
  201. </Member>
  202. <Member MemberName="Remove">
  203. <MemberSignature Language="C#" Value="public bool Remove (string name);" />
  204. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool Remove(string name) cil managed" />
  205. <MemberType>Method</MemberType>
  206. <AssemblyInfo>
  207. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  208. </AssemblyInfo>
  209. <ReturnValue>
  210. <ReturnType>System.Boolean</ReturnType>
  211. </ReturnValue>
  212. <Parameters>
  213. <Parameter Name="name" Type="System.String" />
  214. </Parameters>
  215. <Docs>
  216. <remarks>To be added.</remarks>
  217. <summary>
  218. <attribution license="cc4" from="Microsoft" modified="false" />
  219. <para>Removes the specified header from the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
  220. </summary>
  221. <returns>
  222. <attribution license="cc4" from="Microsoft" modified="false" />
  223. <para>Returns <see cref="T:System.Boolean" />.</para>
  224. </returns>
  225. <param name="name">
  226. <attribution license="cc4" from="Microsoft" modified="false" />The name of the header to remove from the collection. </param>
  227. </Docs>
  228. </Member>
  229. <Member MemberName="System.Collections.IEnumerable.GetEnumerator">
  230. <MemberSignature Language="C#" Value="System.Collections.IEnumerator IEnumerable.GetEnumerator ();" />
  231. <MemberSignature Language="ILAsm" Value=".method hidebysig newslot virtual instance class System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator() cil managed" />
  232. <MemberType>Method</MemberType>
  233. <AssemblyInfo>
  234. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  235. </AssemblyInfo>
  236. <ReturnValue>
  237. <ReturnType>System.Collections.IEnumerator</ReturnType>
  238. </ReturnValue>
  239. <Parameters />
  240. <Docs>
  241. <remarks>To be added.</remarks>
  242. <summary>
  243. <attribution license="cc4" from="Microsoft" modified="false" />
  244. <para>Gets an enumerator that can iterate through a <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
  245. </summary>
  246. <returns>
  247. <attribution license="cc4" from="Microsoft" modified="false" />
  248. <para>Returns <see cref="T:System.Collections.IEnumerator" />.</para>
  249. <para>An instance of an implementation of an <see cref="T:System.Collections.IEnumerator" /> that can iterate through a <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
  250. </returns>
  251. </Docs>
  252. </Member>
  253. <Member MemberName="ToString">
  254. <MemberSignature Language="C#" Value="public override string ToString ();" />
  255. <MemberSignature Language="ILAsm" Value=".method public hidebysig virtual instance string ToString() cil managed" />
  256. <MemberType>Method</MemberType>
  257. <AssemblyInfo>
  258. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  259. </AssemblyInfo>
  260. <ReturnValue>
  261. <ReturnType>System.String</ReturnType>
  262. </ReturnValue>
  263. <Parameters />
  264. <Docs>
  265. <remarks>To be added.</remarks>
  266. <summary>
  267. <attribution license="cc4" from="Microsoft" modified="false" />
  268. <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.HttpHeaders" /> object.</para>
  269. </summary>
  270. <returns>
  271. <attribution license="cc4" from="Microsoft" modified="false" />
  272. <para>Returns <see cref="T:System.String" />.</para>
  273. <para>A string that represents the current object.</para>
  274. </returns>
  275. </Docs>
  276. </Member>
  277. <Member MemberName="TryAddWithoutValidation">
  278. <MemberSignature Language="C#" Value="public bool TryAddWithoutValidation (string name, System.Collections.Generic.IEnumerable&lt;string&gt; values);" />
  279. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool TryAddWithoutValidation(string name, class System.Collections.Generic.IEnumerable`1&lt;string&gt; values) cil managed" />
  280. <MemberType>Method</MemberType>
  281. <AssemblyInfo>
  282. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  283. </AssemblyInfo>
  284. <ReturnValue>
  285. <ReturnType>System.Boolean</ReturnType>
  286. </ReturnValue>
  287. <Parameters>
  288. <Parameter Name="name" Type="System.String" />
  289. <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
  290. </Parameters>
  291. <Docs>
  292. <remarks>To be added.</remarks>
  293. <summary>
  294. <attribution license="cc4" from="Microsoft" modified="false" />
  295. <para>Returns a value that indicates whether the specified header and its values were added to the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection without validating the provided information.</para>
  296. </summary>
  297. <returns>
  298. <attribution license="cc4" from="Microsoft" modified="false" />
  299. <para>Returns <see cref="T:System.Boolean" />.</para>
  300. <para>true if the specified header <paramref name="name" /> and <paramref name="values" /> could be added to the collection; otherwise false.</para>
  301. </returns>
  302. <param name="name">
  303. <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
  304. <param name="values">
  305. <attribution license="cc4" from="Microsoft" modified="false" />The values of the header.</param>
  306. </Docs>
  307. </Member>
  308. <Member MemberName="TryAddWithoutValidation">
  309. <MemberSignature Language="C#" Value="public bool TryAddWithoutValidation (string name, string value);" />
  310. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool TryAddWithoutValidation(string name, string value) cil managed" />
  311. <MemberType>Method</MemberType>
  312. <AssemblyInfo>
  313. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  314. </AssemblyInfo>
  315. <ReturnValue>
  316. <ReturnType>System.Boolean</ReturnType>
  317. </ReturnValue>
  318. <Parameters>
  319. <Parameter Name="name" Type="System.String" />
  320. <Parameter Name="value" Type="System.String" />
  321. </Parameters>
  322. <Docs>
  323. <remarks>To be added.</remarks>
  324. <summary>
  325. <attribution license="cc4" from="Microsoft" modified="false" />
  326. <para>Returns a value that indicates whether the specified header and its value were added to the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection without validating the provided information.</para>
  327. </summary>
  328. <returns>
  329. <attribution license="cc4" from="Microsoft" modified="false" />
  330. <para>Returns <see cref="T:System.Boolean" />.</para>
  331. <para>true if the specified header <paramref name="name" /> and <paramref name="value" /> could be added to the collection; otherwise false.</para>
  332. </returns>
  333. <param name="name">
  334. <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
  335. <param name="value">
  336. <attribution license="cc4" from="Microsoft" modified="false" />The content of the header.</param>
  337. </Docs>
  338. </Member>
  339. <Member MemberName="TryGetValues">
  340. <MemberSignature Language="C#" Value="public bool TryGetValues (string name, out System.Collections.Generic.IEnumerable&lt;string&gt; values);" />
  341. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance bool TryGetValues(string name, class System.Collections.Generic.IEnumerable`1&lt;string&gt; values) cil managed" />
  342. <MemberType>Method</MemberType>
  343. <AssemblyInfo>
  344. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  345. </AssemblyInfo>
  346. <ReturnValue>
  347. <ReturnType>System.Boolean</ReturnType>
  348. </ReturnValue>
  349. <Parameters>
  350. <Parameter Name="name" Type="System.String" />
  351. <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;&amp;" RefType="out" />
  352. </Parameters>
  353. <Docs>
  354. <param name="name">To be added.</param>
  355. <param name="values">To be added.</param>
  356. <summary>To be added.</summary>
  357. <returns>To be added.</returns>
  358. <remarks>To be added.</remarks>
  359. </Docs>
  360. </Member>
  361. </Members>
  362. </Type>