System.IO.Pipelines.xml 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>System.IO.Pipelines</name>
  5. </assembly>
  6. <members>
  7. <member name="P:System.IO.Pipelines.BufferSegment.Start">
  8. <summary>
  9. The Start represents the offset into AvailableMemory where the range of "active" bytes begins. At the point when the block is leased
  10. the Start is guaranteed to be equal to 0. The value of Start may be assigned anywhere between 0 and
  11. AvailableMemory.Length, and must be equal to or less than End.
  12. </summary>
  13. </member>
  14. <member name="P:System.IO.Pipelines.BufferSegment.End">
  15. <summary>
  16. The End represents the offset into AvailableMemory where the range of "active" bytes ends. At the point when the block is leased
  17. the End is guaranteed to be equal to Start. The value of Start may be assigned anywhere between 0 and
  18. Buffer.Length, and must be equal to or less than End.
  19. </summary>
  20. </member>
  21. <member name="P:System.IO.Pipelines.BufferSegment.NextSegment">
  22. <summary>
  23. Reference to the next block of data when the overall "active" bytes spans multiple blocks. At the point when the block is
  24. leased Next is guaranteed to be null. Start, End, and Next are used together in order to create a linked-list of discontiguous
  25. working memory. The "active" memory is grown when bytes are copied in, End is increased, and Next is assigned. The "active"
  26. memory is shrunk when bytes are consumed, Start is increased, and blocks are returned to the pool.
  27. </summary>
  28. </member>
  29. <member name="P:System.IO.Pipelines.BufferSegment.ReadOnly">
  30. <summary>
  31. If true, data should not be written into the backing block after the End offset. Data between start and end should never be modified
  32. since this would break cloning.
  33. </summary>
  34. </member>
  35. <member name="P:System.IO.Pipelines.BufferSegment.WritableBytes">
  36. <summary>
  37. The amount of writable bytes in this segment. It is the amount of bytes between Length and End
  38. </summary>
  39. </member>
  40. <member name="T:System.IO.Pipelines.FlushResult">
  41. <summary>
  42. Result returned by <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> call
  43. </summary>
  44. </member>
  45. <member name="M:System.IO.Pipelines.FlushResult.#ctor(System.Boolean,System.Boolean)">
  46. <summary>
  47. Creates a new instance of <see cref="T:System.IO.Pipelines.FlushResult"/> setting <see cref="P:System.IO.Pipelines.FlushResult.IsCanceled"/> and <see cref="P:System.IO.Pipelines.FlushResult.IsCompleted"/> flags
  48. </summary>
  49. </member>
  50. <member name="P:System.IO.Pipelines.FlushResult.IsCanceled">
  51. <summary>
  52. True if the current <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> operation was canceled, otherwise false.
  53. </summary>
  54. </member>
  55. <member name="P:System.IO.Pipelines.FlushResult.IsCompleted">
  56. <summary>
  57. True if the <see cref="T:System.IO.Pipelines.PipeWriter"/> is complete otherwise false
  58. </summary>
  59. </member>
  60. <member name="T:System.IO.Pipelines.IDuplexPipe">
  61. <summary>
  62. Defines a class that provides a duplex pipe from which data can be read from and written to.
  63. </summary>
  64. </member>
  65. <member name="P:System.IO.Pipelines.IDuplexPipe.Input">
  66. <summary>
  67. Gets the <see cref="T:System.IO.Pipelines.PipeReader"/> half of the duplex pipe.
  68. </summary>
  69. </member>
  70. <member name="P:System.IO.Pipelines.IDuplexPipe.Output">
  71. <summary>
  72. Gets the <see cref="T:System.IO.Pipelines.PipeWriter"/> half of the duplex pipe.
  73. </summary>
  74. </member>
  75. <member name="T:System.IO.Pipelines.Pipe">
  76. <summary>
  77. Default <see cref="T:System.IO.Pipelines.PipeWriter"/> and <see cref="T:System.IO.Pipelines.PipeReader"/> implementation.
  78. </summary>
  79. <summary>
  80. Default <see cref="T:System.IO.Pipelines.PipeWriter"/> and <see cref="T:System.IO.Pipelines.PipeReader"/> implementation.
  81. </summary>
  82. <summary>
  83. Default <see cref="T:System.IO.Pipelines.PipeWriter"/> and <see cref="T:System.IO.Pipelines.PipeReader"/> implementation.
  84. </summary>
  85. </member>
  86. <member name="M:System.IO.Pipelines.Pipe.#ctor">
  87. <summary>
  88. Initializes the <see cref="T:System.IO.Pipelines.Pipe"/> using <see cref="P:System.IO.Pipelines.PipeOptions.Default"/> as options.
  89. </summary>
  90. </member>
  91. <member name="M:System.IO.Pipelines.Pipe.#ctor(System.IO.Pipelines.PipeOptions)">
  92. <summary>
  93. Initializes the <see cref="T:System.IO.Pipelines.Pipe"/> with the specified <see cref="T:System.IO.Pipelines.PipeOptions"/>.
  94. </summary>
  95. </member>
  96. <member name="P:System.IO.Pipelines.Pipe.Reader">
  97. <summary>
  98. Gets the <see cref="T:System.IO.Pipelines.PipeReader"/> for this pipe.
  99. </summary>
  100. </member>
  101. <member name="P:System.IO.Pipelines.Pipe.Writer">
  102. <summary>
  103. Gets the <see cref="T:System.IO.Pipelines.PipeWriter"/> for this pipe.
  104. </summary>
  105. </member>
  106. <member name="M:System.IO.Pipelines.Pipe.Reset">
  107. <summary>
  108. Resets the pipe
  109. </summary>
  110. </member>
  111. <member name="T:System.IO.Pipelines.PipeOptions">
  112. <summary>
  113. Represents a set of <see cref="T:System.IO.Pipelines.Pipe"/> options
  114. </summary>
  115. </member>
  116. <member name="P:System.IO.Pipelines.PipeOptions.Default">
  117. <summary>
  118. Default instance of <see cref="T:System.IO.Pipelines.PipeOptions"/>
  119. </summary>
  120. </member>
  121. <member name="M:System.IO.Pipelines.PipeOptions.#ctor(System.Buffers.MemoryPool{System.Byte},System.IO.Pipelines.PipeScheduler,System.IO.Pipelines.PipeScheduler,System.Int64,System.Int64,System.Int32,System.Boolean)">
  122. <summary>
  123. Creates a new instance of <see cref="T:System.IO.Pipelines.PipeOptions"/>
  124. </summary>
  125. </member>
  126. <member name="P:System.IO.Pipelines.PipeOptions.UseSynchronizationContext">
  127. <summary>
  128. Gets a value that determines if asynchronous callbacks should be executed on the <see cref="T:System.Threading.SynchronizationContext" /> they were captured on.
  129. This takes precedence over the schedulers specified in <see cref="P:System.IO.Pipelines.PipeOptions.ReaderScheduler"/> and <see cref="P:System.IO.Pipelines.PipeOptions.WriterScheduler"/>.
  130. </summary>
  131. </member>
  132. <member name="P:System.IO.Pipelines.PipeOptions.PauseWriterThreshold">
  133. <summary>
  134. Gets amount of bytes in <see cref="T:System.IO.Pipelines.Pipe"/> when <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> starts blocking
  135. </summary>
  136. </member>
  137. <member name="P:System.IO.Pipelines.PipeOptions.ResumeWriterThreshold">
  138. <summary>
  139. Gets amount of bytes in <see cref="T:System.IO.Pipelines.Pipe"/> when <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> stops blocking
  140. </summary>
  141. </member>
  142. <member name="P:System.IO.Pipelines.PipeOptions.MinimumSegmentSize">
  143. <summary>
  144. Gets minimum size of segment requested from <see cref="P:System.IO.Pipelines.PipeOptions.Pool"/>
  145. </summary>
  146. </member>
  147. <member name="P:System.IO.Pipelines.PipeOptions.WriterScheduler">
  148. <summary>
  149. Gets the <see cref="T:System.IO.Pipelines.PipeScheduler"/> used to execute <see cref="T:System.IO.Pipelines.PipeWriter"/> callbacks
  150. </summary>
  151. </member>
  152. <member name="P:System.IO.Pipelines.PipeOptions.ReaderScheduler">
  153. <summary>
  154. Gets the <see cref="T:System.IO.Pipelines.PipeScheduler"/> used to execute <see cref="T:System.IO.Pipelines.PipeReader"/> callbacks
  155. </summary>
  156. </member>
  157. <member name="P:System.IO.Pipelines.PipeOptions.Pool">
  158. <summary>
  159. Gets the <see cref="T:System.Buffers.MemoryPool`1"/> instances used for buffer management
  160. </summary>
  161. </member>
  162. <member name="T:System.IO.Pipelines.PipeReader">
  163. <summary>
  164. Defines a class that provides access to a read side of pipe.
  165. </summary>
  166. </member>
  167. <member name="M:System.IO.Pipelines.PipeReader.TryRead(System.IO.Pipelines.ReadResult@)">
  168. <summary>
  169. Attempt to synchronously read data the <see cref="T:System.IO.Pipelines.PipeReader"/>.
  170. </summary>
  171. <param name="result">The <see cref="T:System.IO.Pipelines.ReadResult"/></param>
  172. <returns>True if data was available, or if the call was canceled or the writer was completed.</returns>
  173. <remarks>If the pipe returns false, there's no need to call <see cref="M:System.IO.Pipelines.PipeReader.AdvanceTo(System.SequencePosition,System.SequencePosition)"/>.</remarks>
  174. </member>
  175. <member name="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)">
  176. <summary>
  177. Asynchronously reads a sequence of bytes from the current <see cref="T:System.IO.Pipelines.PipeReader"/>.
  178. </summary>
  179. <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1"/> representing the asynchronous read operation.</returns>
  180. </member>
  181. <member name="M:System.IO.Pipelines.PipeReader.AdvanceTo(System.SequencePosition)">
  182. <summary>
  183. Moves forward the pipeline's read cursor to after the consumed data.
  184. </summary>
  185. <param name="consumed">Marks the extent of the data that has been successfully processed.</param>
  186. <remarks>
  187. The memory for the consumed data will be released and no longer available.
  188. The examined data communicates to the pipeline when it should signal more data is available.
  189. </remarks>
  190. </member>
  191. <member name="M:System.IO.Pipelines.PipeReader.AdvanceTo(System.SequencePosition,System.SequencePosition)">
  192. <summary>
  193. Moves forward the pipeline's read cursor to after the consumed data.
  194. </summary>
  195. <param name="consumed">Marks the extent of the data that has been successfully processed.</param>
  196. <param name="examined">Marks the extent of the data that has been read and examined.</param>
  197. <remarks>
  198. The memory for the consumed data will be released and no longer available.
  199. The examined data communicates to the pipeline when it should signal more data is available.
  200. </remarks>
  201. </member>
  202. <member name="M:System.IO.Pipelines.PipeReader.CancelPendingRead">
  203. <summary>
  204. Cancel to currently pending or if none is pending next call to <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/>, without completing the <see cref="T:System.IO.Pipelines.PipeReader"/>.
  205. </summary>
  206. </member>
  207. <member name="M:System.IO.Pipelines.PipeReader.Complete(System.Exception)">
  208. <summary>
  209. Signal to the producer that the consumer is done reading.
  210. </summary>
  211. <param name="exception">Optional <see cref="T:System.Exception"/> indicating a failure that's causing the pipeline to complete.</param>
  212. </member>
  213. <member name="M:System.IO.Pipelines.PipeReader.OnWriterCompleted(System.Action{System.Exception,System.Object},System.Object)">
  214. <summary>
  215. Cancel the pending <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/> operation. If there is none, cancels next <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/> operation, without completing the <see cref="T:System.IO.Pipelines.PipeWriter"/>.
  216. </summary>
  217. </member>
  218. <member name="T:System.IO.Pipelines.PipeScheduler">
  219. <summary>
  220. Abstraction for running <see cref="T:System.IO.Pipelines.PipeReader"/> and <see cref="T:System.IO.Pipelines.PipeWriter"/> callbacks and continuations
  221. </summary>
  222. </member>
  223. <member name="P:System.IO.Pipelines.PipeScheduler.ThreadPool">
  224. <summary>
  225. The <see cref="T:System.IO.Pipelines.PipeScheduler"/> implementation that queues callbacks to thread pool
  226. </summary>
  227. </member>
  228. <member name="P:System.IO.Pipelines.PipeScheduler.Inline">
  229. <summary>
  230. The <see cref="T:System.IO.Pipelines.PipeScheduler"/> implementation that runs callbacks inline
  231. </summary>
  232. </member>
  233. <member name="M:System.IO.Pipelines.PipeScheduler.Schedule(System.Action{System.Object},System.Object)">
  234. <summary>
  235. Requests <paramref name="action"/> to be run on scheduler with <paramref name="state"/> being passed in
  236. </summary>
  237. </member>
  238. <member name="T:System.IO.Pipelines.PipeWriter">
  239. <summary>
  240. Defines a class that provides a pipeline to which data can be written.
  241. </summary>
  242. </member>
  243. <member name="M:System.IO.Pipelines.PipeWriter.Complete(System.Exception)">
  244. <summary>
  245. Marks the <see cref="T:System.IO.Pipelines.PipeWriter"/> as being complete, meaning no more items will be written to it.
  246. </summary>
  247. <param name="exception">Optional <see cref="T:System.Exception"/> indicating a failure that's causing the pipeline to complete.</param>
  248. </member>
  249. <member name="M:System.IO.Pipelines.PipeWriter.CancelPendingFlush">
  250. <summary>
  251. Cancel the pending <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> operation. If there is none, cancels next <see cref="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)"/> operation, without completing the <see cref="T:System.IO.Pipelines.PipeWriter"/>.
  252. </summary>
  253. </member>
  254. <member name="M:System.IO.Pipelines.PipeWriter.OnReaderCompleted(System.Action{System.Exception,System.Object},System.Object)">
  255. <summary>
  256. Registers a callback that gets executed when the <see cref="T:System.IO.Pipelines.PipeReader"/> side of the pipe is completed
  257. </summary>
  258. </member>
  259. <member name="M:System.IO.Pipelines.PipeWriter.FlushAsync(System.Threading.CancellationToken)">
  260. <summary>
  261. Makes bytes written available to <see cref="T:System.IO.Pipelines.PipeReader"/> and runs <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/> continuation.
  262. </summary>
  263. </member>
  264. <member name="M:System.IO.Pipelines.PipeWriter.Advance(System.Int32)">
  265. <inheritdoc />
  266. </member>
  267. <member name="M:System.IO.Pipelines.PipeWriter.GetMemory(System.Int32)">
  268. <inheritdoc />
  269. </member>
  270. <member name="M:System.IO.Pipelines.PipeWriter.GetSpan(System.Int32)">
  271. <inheritdoc />
  272. </member>
  273. <member name="M:System.IO.Pipelines.PipeWriter.WriteAsync(System.ReadOnlyMemory{System.Byte},System.Threading.CancellationToken)">
  274. <summary>
  275. Writes <paramref name="source"/> to the pipe and makes data accessible to <see cref="T:System.IO.Pipelines.PipeReader"/>
  276. </summary>
  277. </member>
  278. <member name="T:System.IO.Pipelines.ReadResult">
  279. <summary>
  280. The result of a <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/> call.
  281. </summary>
  282. </member>
  283. <member name="M:System.IO.Pipelines.ReadResult.#ctor(System.Buffers.ReadOnlySequence{System.Byte},System.Boolean,System.Boolean)">
  284. <summary>
  285. Creates a new instance of <see cref="T:System.IO.Pipelines.ReadResult"/> setting <see cref="P:System.IO.Pipelines.ReadResult.IsCanceled"/> and <see cref="P:System.IO.Pipelines.ReadResult.IsCompleted"/> flags
  286. </summary>
  287. </member>
  288. <member name="P:System.IO.Pipelines.ReadResult.Buffer">
  289. <summary>
  290. The <see cref="T:System.Buffers.ReadOnlySequence`1"/> that was read
  291. </summary>
  292. </member>
  293. <member name="P:System.IO.Pipelines.ReadResult.IsCanceled">
  294. <summary>
  295. True if the current <see cref="M:System.IO.Pipelines.PipeReader.ReadAsync(System.Threading.CancellationToken)"/> operation was canceled, otherwise false.
  296. </summary>
  297. </member>
  298. <member name="P:System.IO.Pipelines.ReadResult.IsCompleted">
  299. <summary>
  300. True if the <see cref="T:System.IO.Pipelines.PipeReader"/> is complete
  301. </summary>
  302. </member>
  303. </members>
  304. </doc>