Microsoft.Extensions.Caching.Abstractions.xml 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Microsoft.Extensions.Caching.Abstractions</name>
  5. </assembly>
  6. <members>
  7. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetPriority(Microsoft.Extensions.Caching.Memory.ICacheEntry,Microsoft.Extensions.Caching.Memory.CacheItemPriority)">
  8. <summary>
  9. Sets the priority for keeping the cache entry in the cache during a memory pressure tokened cleanup.
  10. </summary>
  11. <param name="entry"></param>
  12. <param name="priority"></param>
  13. </member>
  14. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.AddExpirationToken(Microsoft.Extensions.Caching.Memory.ICacheEntry,Microsoft.Extensions.Primitives.IChangeToken)">
  15. <summary>
  16. Expire the cache entry if the given <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> expires.
  17. </summary>
  18. <param name="entry">The <see cref="T:Microsoft.Extensions.Caching.Memory.ICacheEntry"/>.</param>
  19. <param name="expirationToken">The <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> that causes the cache entry to expire.</param>
  20. </member>
  21. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Memory.ICacheEntry,System.TimeSpan)">
  22. <summary>
  23. Sets an absolute expiration time, relative to now.
  24. </summary>
  25. <param name="entry"></param>
  26. <param name="relative"></param>
  27. </member>
  28. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Memory.ICacheEntry,System.DateTimeOffset)">
  29. <summary>
  30. Sets an absolute expiration date for the cache entry.
  31. </summary>
  32. <param name="entry"></param>
  33. <param name="absolute"></param>
  34. </member>
  35. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetSlidingExpiration(Microsoft.Extensions.Caching.Memory.ICacheEntry,System.TimeSpan)">
  36. <summary>
  37. Sets how long the cache entry can be inactive (e.g. not accessed) before it will be removed.
  38. This will not extend the entry lifetime beyond the absolute expiration (if set).
  39. </summary>
  40. <param name="entry"></param>
  41. <param name="offset"></param>
  42. </member>
  43. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.RegisterPostEvictionCallback(Microsoft.Extensions.Caching.Memory.ICacheEntry,Microsoft.Extensions.Caching.Memory.PostEvictionDelegate)">
  44. <summary>
  45. The given callback will be fired after the cache entry is evicted from the cache.
  46. </summary>
  47. <param name="entry"></param>
  48. <param name="callback"></param>
  49. </member>
  50. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.RegisterPostEvictionCallback(Microsoft.Extensions.Caching.Memory.ICacheEntry,Microsoft.Extensions.Caching.Memory.PostEvictionDelegate,System.Object)">
  51. <summary>
  52. The given callback will be fired after the cache entry is evicted from the cache.
  53. </summary>
  54. <param name="entry"></param>
  55. <param name="callback"></param>
  56. <param name="state"></param>
  57. </member>
  58. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetValue(Microsoft.Extensions.Caching.Memory.ICacheEntry,System.Object)">
  59. <summary>
  60. Sets the value of the cache entry.
  61. </summary>
  62. <param name="entry"></param>
  63. <param name="value"></param>
  64. </member>
  65. <member name="M:Microsoft.Extensions.Caching.Memory.CacheEntryExtensions.SetOptions(Microsoft.Extensions.Caching.Memory.ICacheEntry,Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions)">
  66. <summary>
  67. Applies the values of an existing <see cref="T:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions"/> to the entry.
  68. </summary>
  69. <param name="entry"></param>
  70. <param name="options"></param>
  71. </member>
  72. <member name="T:Microsoft.Extensions.Caching.Memory.CacheItemPriority">
  73. <summary>
  74. Specifies how items are prioritized for preservation during a memory pressure triggered cleanup.
  75. </summary>
  76. </member>
  77. <member name="F:Microsoft.Extensions.Caching.Memory.EvictionReason.Removed">
  78. <summary>
  79. Manually
  80. </summary>
  81. </member>
  82. <member name="F:Microsoft.Extensions.Caching.Memory.EvictionReason.Replaced">
  83. <summary>
  84. Overwritten
  85. </summary>
  86. </member>
  87. <member name="F:Microsoft.Extensions.Caching.Memory.EvictionReason.Expired">
  88. <summary>
  89. Timed out
  90. </summary>
  91. </member>
  92. <member name="F:Microsoft.Extensions.Caching.Memory.EvictionReason.TokenExpired">
  93. <summary>
  94. Event
  95. </summary>
  96. </member>
  97. <member name="F:Microsoft.Extensions.Caching.Memory.EvictionReason.Capacity">
  98. <summary>
  99. GC, overflow
  100. </summary>
  101. </member>
  102. <member name="T:Microsoft.Extensions.Caching.Memory.ICacheEntry">
  103. <summary>
  104. Represents an entry in the <see cref="T:Microsoft.Extensions.Caching.Memory.IMemoryCache"/> implementation.
  105. </summary>
  106. </member>
  107. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.Key">
  108. <summary>
  109. Gets the key of the cache entry.
  110. </summary>
  111. </member>
  112. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.Value">
  113. <summary>
  114. Gets or set the value of the cache entry.
  115. </summary>
  116. </member>
  117. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.AbsoluteExpiration">
  118. <summary>
  119. Gets or sets an absolute expiration date for the cache entry.
  120. </summary>
  121. </member>
  122. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.AbsoluteExpirationRelativeToNow">
  123. <summary>
  124. Gets or sets an absolute expiration time, relative to now.
  125. </summary>
  126. </member>
  127. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.SlidingExpiration">
  128. <summary>
  129. Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
  130. This will not extend the entry lifetime beyond the absolute expiration (if set).
  131. </summary>
  132. </member>
  133. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.ExpirationTokens">
  134. <summary>
  135. Gets the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> instances which cause the cache entry to expire.
  136. </summary>
  137. </member>
  138. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.PostEvictionCallbacks">
  139. <summary>
  140. Gets or sets the callbacks will be fired after the cache entry is evicted from the cache.
  141. </summary>
  142. </member>
  143. <member name="P:Microsoft.Extensions.Caching.Memory.ICacheEntry.Priority">
  144. <summary>
  145. Gets or sets the priority for keeping the cache entry in the cache during a
  146. memory pressure triggered cleanup. The default is <see cref="F:Microsoft.Extensions.Caching.Memory.CacheItemPriority.Normal"/>.
  147. </summary>
  148. </member>
  149. <member name="T:Microsoft.Extensions.Caching.Memory.IMemoryCache">
  150. <summary>
  151. Represents a local in-memory cache whose values are not serialized.
  152. </summary>
  153. </member>
  154. <member name="M:Microsoft.Extensions.Caching.Memory.IMemoryCache.TryGetValue(System.Object,System.Object@)">
  155. <summary>
  156. Gets the item associated with this key if present.
  157. </summary>
  158. <param name="key">An object identifying the requested entry.</param>
  159. <param name="value">The located value or null.</param>
  160. <returns>True if the key was found.</returns>
  161. </member>
  162. <member name="M:Microsoft.Extensions.Caching.Memory.IMemoryCache.CreateEntry(System.Object)">
  163. <summary>
  164. Create or overwrite an entry in the cache.
  165. </summary>
  166. <param name="key">An object identifying the entry.</param>
  167. <returns>The newly created <see cref="T:Microsoft.Extensions.Caching.Memory.ICacheEntry"/> instance.</returns>
  168. </member>
  169. <member name="M:Microsoft.Extensions.Caching.Memory.IMemoryCache.Remove(System.Object)">
  170. <summary>
  171. Removes the object associated with the given key.
  172. </summary>
  173. <param name="key">An object identifying the entry.</param>
  174. </member>
  175. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.SetPriority(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,Microsoft.Extensions.Caching.Memory.CacheItemPriority)">
  176. <summary>
  177. Sets the priority for keeping the cache entry in the cache during a memory pressure tokened cleanup.
  178. </summary>
  179. <param name="options"></param>
  180. <param name="priority"></param>
  181. </member>
  182. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.AddExpirationToken(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,Microsoft.Extensions.Primitives.IChangeToken)">
  183. <summary>
  184. Expire the cache entry if the given <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> expires.
  185. </summary>
  186. <param name="options">The <see cref="T:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions"/>.</param>
  187. <param name="expirationToken">The <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> that causes the cache entry to expire.</param>
  188. </member>
  189. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,System.TimeSpan)">
  190. <summary>
  191. Sets an absolute expiration time, relative to now.
  192. </summary>
  193. <param name="options"></param>
  194. <param name="relative"></param>
  195. </member>
  196. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,System.DateTimeOffset)">
  197. <summary>
  198. Sets an absolute expiration date for the cache entry.
  199. </summary>
  200. <param name="options"></param>
  201. <param name="absolute"></param>
  202. </member>
  203. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.SetSlidingExpiration(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,System.TimeSpan)">
  204. <summary>
  205. Sets how long the cache entry can be inactive (e.g. not accessed) before it will be removed.
  206. This will not extend the entry lifetime beyond the absolute expiration (if set).
  207. </summary>
  208. <param name="options"></param>
  209. <param name="offset"></param>
  210. </member>
  211. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.RegisterPostEvictionCallback(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,Microsoft.Extensions.Caching.Memory.PostEvictionDelegate)">
  212. <summary>
  213. The given callback will be fired after the cache entry is evicted from the cache.
  214. </summary>
  215. <param name="options"></param>
  216. <param name="callback"></param>
  217. </member>
  218. <member name="M:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryExtensions.RegisterPostEvictionCallback(Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions,Microsoft.Extensions.Caching.Memory.PostEvictionDelegate,System.Object)">
  219. <summary>
  220. The given callback will be fired after the cache entry is evicted from the cache.
  221. </summary>
  222. <param name="options"></param>
  223. <param name="callback"></param>
  224. <param name="state"></param>
  225. </member>
  226. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.AbsoluteExpiration">
  227. <summary>
  228. Gets or sets an absolute expiration date for the cache entry.
  229. </summary>
  230. </member>
  231. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.AbsoluteExpirationRelativeToNow">
  232. <summary>
  233. Gets or sets an absolute expiration time, relative to now.
  234. </summary>
  235. </member>
  236. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.SlidingExpiration">
  237. <summary>
  238. Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
  239. This will not extend the entry lifetime beyond the absolute expiration (if set).
  240. </summary>
  241. </member>
  242. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.ExpirationTokens">
  243. <summary>
  244. Gets the <see cref="T:Microsoft.Extensions.Primitives.IChangeToken"/> instances which cause the cache entry to expire.
  245. </summary>
  246. </member>
  247. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.PostEvictionCallbacks">
  248. <summary>
  249. Gets or sets the callbacks will be fired after the cache entry is evicted from the cache.
  250. </summary>
  251. </member>
  252. <member name="P:Microsoft.Extensions.Caching.Memory.MemoryCacheEntryOptions.Priority">
  253. <summary>
  254. Gets or sets the priority for keeping the cache entry in the cache during a
  255. memory pressure triggered cleanup. The default is <see cref="F:Microsoft.Extensions.Caching.Memory.CacheItemPriority.Normal"/>.
  256. </summary>
  257. </member>
  258. <member name="T:Microsoft.Extensions.Caching.Memory.PostEvictionDelegate">
  259. <summary>
  260. Signature of the callback which gets called when a cache entry expires.
  261. </summary>
  262. <param name="key"></param>
  263. <param name="value"></param>
  264. <param name="reason">The <see cref="T:Microsoft.Extensions.Caching.Memory.EvictionReason"/>.</param>
  265. <param name="state">The information that was passed when registering the callback.</param>
  266. </member>
  267. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.TimeSpan)">
  268. <summary>
  269. Sets an absolute expiration time, relative to now.
  270. </summary>
  271. <param name="options"></param>
  272. <param name="relative"></param>
  273. </member>
  274. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryExtensions.SetAbsoluteExpiration(Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.DateTimeOffset)">
  275. <summary>
  276. Sets an absolute expiration date for the cache entry.
  277. </summary>
  278. <param name="options"></param>
  279. <param name="absolute"></param>
  280. </member>
  281. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryExtensions.SetSlidingExpiration(Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions,System.TimeSpan)">
  282. <summary>
  283. Sets how long the cache entry can be inactive (e.g. not accessed) before it will be removed.
  284. This will not extend the entry lifetime beyond the absolute expiration (if set).
  285. </summary>
  286. <param name="options"></param>
  287. <param name="offset"></param>
  288. </member>
  289. <member name="P:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions.AbsoluteExpiration">
  290. <summary>
  291. Gets or sets an absolute expiration date for the cache entry.
  292. </summary>
  293. </member>
  294. <member name="P:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions.AbsoluteExpirationRelativeToNow">
  295. <summary>
  296. Gets or sets an absolute expiration time, relative to now.
  297. </summary>
  298. </member>
  299. <member name="P:Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions.SlidingExpiration">
  300. <summary>
  301. Gets or sets how long a cache entry can be inactive (e.g. not accessed) before it will be removed.
  302. This will not extend the entry lifetime beyond the absolute expiration (if set).
  303. </summary>
  304. </member>
  305. <member name="T:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions">
  306. <summary>
  307. Extension methods for setting data in an <see cref="T:Microsoft.Extensions.Caching.Distributed.IDistributedCache" />.
  308. </summary>
  309. </member>
  310. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.Set(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.Byte[])">
  311. <summary>
  312. Sets a sequence of bytes in the specified cache with the specified key.
  313. </summary>
  314. <param name="cache">The cache in which to store the data.</param>
  315. <param name="key">The key to store the data in.</param>
  316. <param name="value">The data to store in the cache.</param>
  317. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  318. </member>
  319. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetAsync(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.Byte[])">
  320. <summary>
  321. Asynchronously sets a sequence of bytes in the specified cache with the specified key.
  322. </summary>
  323. <param name="cache">The cache in which to store the data.</param>
  324. <param name="key">The key to store the data in.</param>
  325. <param name="value">The data to store in the cache.</param>
  326. <returns>A task that represents the asynchronous set operation.</returns>
  327. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  328. </member>
  329. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String)">
  330. <summary>
  331. Sets a string in the specified cache with the specified key.
  332. </summary>
  333. <param name="cache">The cache in which to store the data.</param>
  334. <param name="key">The key to store the data in.</param>
  335. <param name="value">The data to store in the cache.</param>
  336. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  337. </member>
  338. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String,Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)">
  339. <summary>
  340. Sets a string in the specified cache with the specified key.
  341. </summary>
  342. <param name="cache">The cache in which to store the data.</param>
  343. <param name="key">The key to store the data in.</param>
  344. <param name="value">The data to store in the cache.</param>
  345. <param name="options">The cache options for the entry.</param>
  346. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  347. </member>
  348. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetStringAsync(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String)">
  349. <summary>
  350. Asynchronously sets a string in the specified cache with the specified key.
  351. </summary>
  352. <param name="cache">The cache in which to store the data.</param>
  353. <param name="key">The key to store the data in.</param>
  354. <param name="value">The data to store in the cache.</param>
  355. <returns>A task that represents the asynchronous set operation.</returns>
  356. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  357. </member>
  358. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.SetStringAsync(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String,System.String,Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions)">
  359. <summary>
  360. Asynchronously sets a string in the specified cache with the specified key.
  361. </summary>
  362. <param name="cache">The cache in which to store the data.</param>
  363. <param name="key">The key to store the data in.</param>
  364. <param name="value">The data to store in the cache.</param>
  365. <param name="options">The cache options for the entry.</param>
  366. <returns>A task that represents the asynchronous set operation.</returns>
  367. <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="key"/> or <paramref name="value"/> is null.</exception>
  368. </member>
  369. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.GetString(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String)">
  370. <summary>
  371. Gets a string from the specified cache with the specified key.
  372. </summary>
  373. <param name="cache">The cache in which to store the data.</param>
  374. <param name="key">The key to get the stored data for.</param>
  375. <returns>The string value from the stored cache key.</returns>
  376. </member>
  377. <member name="M:Microsoft.Extensions.Caching.Distributed.DistributedCacheExtensions.GetStringAsync(Microsoft.Extensions.Caching.Distributed.IDistributedCache,System.String)">
  378. <summary>
  379. Asynchronously gets a string from the specified cache with the specified key.
  380. </summary>
  381. <param name="cache">The cache in which to store the data.</param>
  382. <param name="key">The key to get the stored data for.</param>
  383. <returns>A task that gets the string value from the stored cache key.</returns>
  384. </member>
  385. <member name="T:Microsoft.Extensions.Internal.ISystemClock">
  386. <summary>
  387. Abstracts the system clock to facilitate testing.
  388. </summary>
  389. </member>
  390. <member name="P:Microsoft.Extensions.Internal.ISystemClock.UtcNow">
  391. <summary>
  392. Retrieves the current system time in UTC.
  393. </summary>
  394. </member>
  395. <member name="T:Microsoft.Extensions.Internal.SystemClock">
  396. <summary>
  397. Provides access to the normal system clock.
  398. </summary>
  399. </member>
  400. <member name="P:Microsoft.Extensions.Internal.SystemClock.UtcNow">
  401. <summary>
  402. Retrieves the current system time in UTC.
  403. </summary>
  404. </member>
  405. </members>
  406. </doc>