Nito.Disposables.xml 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Nito.Disposables</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Nito.Disposables.AnonymousDisposable">
  8. <summary>
  9. A disposable that executes a delegate when disposed.
  10. </summary>
  11. </member>
  12. <member name="M:Nito.Disposables.AnonymousDisposable.#ctor(System.Action)">
  13. <summary>
  14. Creates a new disposable that executes <paramref name="dispose"/> when disposed.
  15. </summary>
  16. <param name="dispose">The delegate to execute when disposed. If this is <c>null</c>, then this instance does nothing when it is disposed.</param>
  17. </member>
  18. <member name="M:Nito.Disposables.AnonymousDisposable.Dispose(System.Action)">
  19. <inheritdoc />
  20. </member>
  21. <member name="M:Nito.Disposables.AnonymousDisposable.Add(System.Action)">
  22. <summary>
  23. Adds a delegate to be executed when this instance is disposed. If this instance is already disposed or disposing, then <paramref name="dispose"/> is executed immediately.
  24. </summary>
  25. <param name="dispose">The delegate to add. May be <c>null</c> to indicate no additional action.</param>
  26. </member>
  27. <member name="M:Nito.Disposables.AnonymousDisposable.Create(System.Action)">
  28. <summary>
  29. Creates a new disposable that executes <paramref name="dispose"/> when disposed.
  30. </summary>
  31. <param name="dispose">The delegate to execute when disposed. May not be <c>null</c>.</param>
  32. </member>
  33. <member name="T:Nito.Disposables.CollectionDisposable">
  34. <summary>
  35. Disposes a collection of disposables.
  36. </summary>
  37. </member>
  38. <member name="M:Nito.Disposables.CollectionDisposable.#ctor(System.IDisposable[])">
  39. <summary>
  40. Creates a disposable that disposes a collection of disposables.
  41. </summary>
  42. <param name="disposables">The disposables to dispose.</param>
  43. </member>
  44. <member name="M:Nito.Disposables.CollectionDisposable.#ctor(System.Collections.Generic.IEnumerable{System.IDisposable})">
  45. <summary>
  46. Creates a disposable that disposes a collection of disposables.
  47. </summary>
  48. <param name="disposables">The disposables to dispose.</param>
  49. </member>
  50. <member name="M:Nito.Disposables.CollectionDisposable.Dispose(System.Collections.Immutable.ImmutableQueue{System.IDisposable})">
  51. <inheritdoc />
  52. </member>
  53. <member name="M:Nito.Disposables.CollectionDisposable.Add(System.IDisposable)">
  54. <summary>
  55. Adds a disposable to the collection of disposables. If this instance is already disposed or disposing, then <paramref name="disposable"/> is disposed immediately.
  56. </summary>
  57. <param name="disposable">The disposable to add to our collection.</param>
  58. </member>
  59. <member name="M:Nito.Disposables.CollectionDisposable.Create(System.IDisposable[])">
  60. <summary>
  61. Creates a disposable that disposes a collection of disposables.
  62. </summary>
  63. <param name="disposables">The disposables to dispose.</param>
  64. </member>
  65. <member name="M:Nito.Disposables.CollectionDisposable.Create(System.Collections.Generic.IEnumerable{System.IDisposable})">
  66. <summary>
  67. Creates a disposable that disposes a collection of disposables.
  68. </summary>
  69. <param name="disposables">The disposables to dispose.</param>
  70. </member>
  71. <member name="T:Nito.Disposables.Internals.BoundActionField`1">
  72. <summary>
  73. A field containing a bound action.
  74. </summary>
  75. <typeparam name="T">The type of context for the action.</typeparam>
  76. </member>
  77. <member name="M:Nito.Disposables.Internals.BoundActionField`1.#ctor(System.Action{`0},`0)">
  78. <summary>
  79. Initializes the field with the specified action and context.
  80. </summary>
  81. <param name="action">The action delegate.</param>
  82. <param name="context">The context.</param>
  83. </member>
  84. <member name="P:Nito.Disposables.Internals.BoundActionField`1.IsEmpty">
  85. <summary>
  86. Whether the field is empty.
  87. </summary>
  88. </member>
  89. <member name="M:Nito.Disposables.Internals.BoundActionField`1.TryGetAndUnset">
  90. <summary>
  91. Atomically retrieves the bound action from the field and sets the field to <c>null</c>. May return <c>null</c>.
  92. </summary>
  93. </member>
  94. <member name="M:Nito.Disposables.Internals.BoundActionField`1.TryUpdateContext(System.Func{`0,`0})">
  95. <summary>
  96. Attempts to update the context of the bound action stored in the field. Returns <c>false</c> if the field is <c>null</c>.
  97. </summary>
  98. <param name="contextUpdater">The function used to update an existing context. This may be called more than once if more than one thread attempts to simultanously update the context.</param>
  99. </member>
  100. <member name="T:Nito.Disposables.Internals.BoundActionField`1.IBoundAction">
  101. <summary>
  102. An action delegate bound with its context.
  103. </summary>
  104. </member>
  105. <member name="M:Nito.Disposables.Internals.BoundActionField`1.IBoundAction.Invoke">
  106. <summary>
  107. Executes the action. This should only be done after the bound action is retrieved from a field by <see cref="M:Nito.Disposables.Internals.BoundActionField`1.TryGetAndUnset"/>.
  108. </summary>
  109. </member>
  110. <member name="T:Nito.Disposables.NoopDisposable">
  111. <summary>
  112. A singleton disposable that does nothing when disposed.
  113. </summary>
  114. </member>
  115. <member name="M:Nito.Disposables.NoopDisposable.Dispose">
  116. <summary>
  117. Does nothing.
  118. </summary>
  119. </member>
  120. <member name="P:Nito.Disposables.NoopDisposable.Instance">
  121. <summary>
  122. Gets the instance of <see cref="T:Nito.Disposables.NoopDisposable"/>.
  123. </summary>
  124. </member>
  125. <member name="T:Nito.Disposables.SingleDisposable`1">
  126. <summary>
  127. A base class for disposables that need exactly-once semantics in a threadsafe way. All disposals of this instance block until the disposal is complete.
  128. </summary>
  129. <typeparam name="T">The type of "context" for the derived disposable. Since the context should not be modified, strongly consider making this an immutable type.</typeparam>
  130. <remarks>
  131. <para>If <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose"/> is called multiple times, only the first call will execute the disposal code. Other calls to <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose"/> will wait for the disposal to complete.</para>
  132. </remarks>
  133. </member>
  134. <member name="F:Nito.Disposables.SingleDisposable`1._context">
  135. <summary>
  136. The context. This is never <c>null</c>. This is empty if this instance has already been disposed (or is being disposed).
  137. </summary>
  138. </member>
  139. <member name="M:Nito.Disposables.SingleDisposable`1.#ctor(`0)">
  140. <summary>
  141. Creates a disposable for the specified context.
  142. </summary>
  143. <param name="context">The context passed to <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose(`0)"/>.</param>
  144. </member>
  145. <member name="P:Nito.Disposables.SingleDisposable`1.IsDisposeStarted">
  146. <summary>
  147. Whether this instance is currently disposing or has been disposed.
  148. </summary>
  149. </member>
  150. <member name="P:Nito.Disposables.SingleDisposable`1.IsDisposed">
  151. <summary>
  152. Whether this instance is disposed (finished disposing).
  153. </summary>
  154. </member>
  155. <member name="P:Nito.Disposables.SingleDisposable`1.IsDisposing">
  156. <summary>
  157. Whether this instance is currently disposing, but not finished yet.
  158. </summary>
  159. </member>
  160. <member name="M:Nito.Disposables.SingleDisposable`1.Dispose(`0)">
  161. <summary>
  162. The actul disposal method, called only once from <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose"/>.
  163. </summary>
  164. <param name="context">The context for the disposal operation.</param>
  165. </member>
  166. <member name="M:Nito.Disposables.SingleDisposable`1.Dispose">
  167. <summary>
  168. Disposes this instance.
  169. </summary>
  170. <remarks>
  171. <para>If <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose"/> is called multiple times, only the first call will execute the disposal code. Other calls to <see cref="M:Nito.Disposables.SingleDisposable`1.Dispose"/> will wait for the disposal to complete.</para>
  172. </remarks>
  173. </member>
  174. <member name="M:Nito.Disposables.SingleDisposable`1.TryUpdateContext(System.Func{`0,`0})">
  175. <summary>
  176. Attempts to update the stored context. This method returns <c>false</c> if this instance has already been disposed (or is being disposed).
  177. </summary>
  178. <param name="contextUpdater">The function used to update an existing context. This may be called more than once if more than one thread attempts to simultanously update the context.</param>
  179. </member>
  180. <member name="T:Nito.Disposables.SingleNonblockingDisposable`1">
  181. <summary>
  182. A base class for disposables that need exactly-once semantics in a threadsafe way.
  183. </summary>
  184. <typeparam name="T">The type of "context" for the derived disposable. Since the context should not be modified, strongly consider making this an immutable type.</typeparam>
  185. <remarks>
  186. <para>If <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose"/> is called multiple times, only the first call will execute the disposal code. Other calls to <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose"/> will not wait for the disposal to complete.</para>
  187. </remarks>
  188. </member>
  189. <member name="F:Nito.Disposables.SingleNonblockingDisposable`1._context">
  190. <summary>
  191. The context. This is never <c>null</c>. This is empty if this instance has already been disposed (or is being disposed).
  192. </summary>
  193. </member>
  194. <member name="M:Nito.Disposables.SingleNonblockingDisposable`1.#ctor(`0)">
  195. <summary>
  196. Creates a disposable for the specified context.
  197. </summary>
  198. <param name="context">The context passed to <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose(`0)"/>.</param>
  199. </member>
  200. <member name="P:Nito.Disposables.SingleNonblockingDisposable`1.IsDisposed">
  201. <summary>
  202. Whether this instance has been disposed (or is being disposed).
  203. </summary>
  204. </member>
  205. <member name="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose(`0)">
  206. <summary>
  207. The actul disposal method, called only once from <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose"/>.
  208. </summary>
  209. <param name="context">The context for the disposal operation.</param>
  210. </member>
  211. <member name="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose">
  212. <summary>
  213. Disposes this instance.
  214. </summary>
  215. <remarks>
  216. <para>If <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose"/> is called multiple times, only the first call will execute the disposal code. Other calls to <see cref="M:Nito.Disposables.SingleNonblockingDisposable`1.Dispose"/> will not wait for the disposal to complete.</para>
  217. </remarks>
  218. </member>
  219. <member name="M:Nito.Disposables.SingleNonblockingDisposable`1.TryUpdateContext(System.Func{`0,`0})">
  220. <summary>
  221. Attempts to update the stored context. This method returns <c>false</c> if this instance has already been disposed (or is being disposed).
  222. </summary>
  223. <param name="contextUpdater">The function used to update an existing context. This may be called more than once if more than one thread attempts to simultanously update the context.</param>
  224. </member>
  225. </members>
  226. </doc>