Без опису
Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.

System.Diagnostics.DiagnosticSource.xml 72KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Diagnostics.DiagnosticSource</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Diagnostics.Activity">
  8. <summary>Represents an operation with context to be used for logging.</summary>
  9. </member>
  10. <member name="M:System.Diagnostics.Activity.#ctor(System.String)">
  11. <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.Activity" /> class.</summary>
  12. <param name="operationName">The name of the operation.</param>
  13. </member>
  14. <member name="M:System.Diagnostics.Activity.AddBaggage(System.String,System.String)">
  15. <summary>Updates the <see cref="T:System.Diagnostics.Activity" /> to have a new baggage item with the specified key and value.</summary>
  16. <param name="key">The baggage key.</param>
  17. <param name="value">The baggage value.</param>
  18. <returns>
  19. <see langword="this" /> for convenient chaining.</returns>
  20. </member>
  21. <member name="M:System.Diagnostics.Activity.AddEvent(System.Diagnostics.ActivityEvent)">
  22. <summary>Adds the specified activity event to the events list.</summary>
  23. <param name="e">The activity event to add.</param>
  24. <returns>
  25. <see langword="this" /> for convenient chaining.</returns>
  26. </member>
  27. <member name="M:System.Diagnostics.Activity.AddTag(System.String,System.Object)">
  28. <summary>Updates the activity to have a tag with an additional <paramref name="key" /> and <paramref name="value" />.</summary>
  29. <param name="key">The tag key name.</param>
  30. <param name="value">The tag value mapped to the input key.</param>
  31. <returns>
  32. <see langword="this" /> for convenient chaining.</returns>
  33. </member>
  34. <member name="M:System.Diagnostics.Activity.AddTag(System.String,System.String)">
  35. <summary>Updates the <see cref="T:System.Diagnostics.Activity" /> to have a new tag with the provided <paramref name="key" /> and <paramref name="value" />.</summary>
  36. <param name="key">The tag key.</param>
  37. <param name="value">The tag value.</param>
  38. <returns>
  39. <see langword="this" /> for convenient chaining.</returns>
  40. </member>
  41. <member name="M:System.Diagnostics.Activity.Dispose">
  42. <summary>Stops the activity if it is already started and notifies any event listeners. Nothing will happen otherwise.</summary>
  43. </member>
  44. <member name="M:System.Diagnostics.Activity.Dispose(System.Boolean)">
  45. <summary>When overriden by a derived type, this method releases any allocated resources.</summary>
  46. <param name="disposing">
  47. <see langword="false" /> if the method is being called from the finalizer; <see langword="true" /> if calling from user code.</param>
  48. </member>
  49. <member name="M:System.Diagnostics.Activity.GetBaggageItem(System.String)">
  50. <summary>Returns the value of a key-value pair added to the activity with <see cref="M:System.Diagnostics.Activity.AddBaggage(System.String,System.String)" />.</summary>
  51. <param name="key">The baggage key.</param>
  52. <returns>The value of the key-value-pair item if it exists, or <see langword="null" /> if it does not exist.</returns>
  53. </member>
  54. <member name="M:System.Diagnostics.Activity.GetCustomProperty(System.String)">
  55. <summary>Returns the object mapped to the specified property name.</summary>
  56. <param name="propertyName">The name associated to the object.</param>
  57. <returns>The object mapped to the property name, if one is found; otherwise, <see langword="null" />.</returns>
  58. </member>
  59. <member name="M:System.Diagnostics.Activity.SetCustomProperty(System.String,System.Object)">
  60. <summary>Attaches any custom object to this activity. If the specified <paramref name="propertyName" /> was previously associated with another object, the property will be updated to be associated with the new <paramref name="propertyValue" /> instead. It is recommended to use a unique property name to avoid conflicts with anyone using the same value.</summary>
  61. <param name="propertyName">The name to associate the value with.</param>
  62. <param name="propertyValue">The object to attach and map to the property name.</param>
  63. </member>
  64. <member name="M:System.Diagnostics.Activity.SetEndTime(System.DateTime)">
  65. <summary>Updates the <see cref="T:System.Diagnostics.Activity" /> to set its <see cref="P:System.Diagnostics.Activity.Duration" /> as the difference between <see cref="P:System.Diagnostics.Activity.StartTimeUtc" /> and the specified stop time.</summary>
  66. <param name="endTimeUtc">The UTC stop time.</param>
  67. <returns>
  68. <see langword="this" /> for convenient chaining.</returns>
  69. </member>
  70. <member name="M:System.Diagnostics.Activity.SetIdFormat(System.Diagnostics.ActivityIdFormat)">
  71. <summary>Sets the ID format on this <see cref="T:System.Diagnostics.Activity" /> before it is started.</summary>
  72. <param name="format">One of the enumeration values that specifies the format of the <see cref="P:System.Diagnostics.Activity.Id" /> property.</param>
  73. <returns>
  74. <see langword="this" /> for convenient chaining.</returns>
  75. </member>
  76. <member name="M:System.Diagnostics.Activity.SetParentId(System.Diagnostics.ActivityTraceId,System.Diagnostics.ActivitySpanId,System.Diagnostics.ActivityTraceFlags)">
  77. <summary>Sets the parent ID using the W3C convention of a TraceId and a SpanId.</summary>
  78. <param name="traceId">The parent activity's TraceId.</param>
  79. <param name="spanId">The parent activity's SpanId.</param>
  80. <param name="activityTraceFlags">One of the enumeration values that specifies flags defined by the W3C standard that are associated with an activity.</param>
  81. <returns>
  82. <see langword="this" /> for convenient chaining.</returns>
  83. </member>
  84. <member name="M:System.Diagnostics.Activity.SetParentId(System.String)">
  85. <summary>Updates this <see cref="T:System.Diagnostics.Activity" /> to indicate that the <see cref="T:System.Diagnostics.Activity" /> with an ID of <paramref name="parentId" /> caused this <see cref="T:System.Diagnostics.Activity" />.</summary>
  86. <param name="parentId">The ID of the parent operation.</param>
  87. <returns>
  88. <see langword="this" /> for convenient chaining.</returns>
  89. </member>
  90. <member name="M:System.Diagnostics.Activity.SetStartTime(System.DateTime)">
  91. <summary>Sets the start time of this <see cref="T:System.Diagnostics.Activity" />.</summary>
  92. <param name="startTimeUtc">The <see cref="T:System.Diagnostics.Activity" /> start time in UTC.</param>
  93. <returns>
  94. <see langword="this" /> for convenient chaining.</returns>
  95. </member>
  96. <member name="M:System.Diagnostics.Activity.SetTag(System.String,System.Object)">
  97. <summary>Adds or update the activity tag with the input key and value.</summary>
  98. <param name="key">The tag key name.</param>
  99. <param name="value">The tag value mapped to the input key.</param>
  100. <returns>
  101. <see langword="this" /> for convenient chaining.</returns>
  102. </member>
  103. <member name="M:System.Diagnostics.Activity.Start">
  104. <summary>Starts the activity.</summary>
  105. <returns>
  106. <see langword="this" /> for convenient chaining.</returns>
  107. </member>
  108. <member name="M:System.Diagnostics.Activity.Stop">
  109. <summary>Stops the activity.</summary>
  110. </member>
  111. <member name="P:System.Diagnostics.Activity.ActivityTraceFlags">
  112. <summary>Gets the flags (defined by the W3C ID specification) associated with the activity.</summary>
  113. <returns>the flags associated with the activity.</returns>
  114. </member>
  115. <member name="P:System.Diagnostics.Activity.Baggage">
  116. <summary>Gets a collection of key/value pairs that represents information that is passed to children of this <see cref="T:System.Diagnostics.Activity" />.</summary>
  117. <returns>An enumeration of string-string key-value pairs.</returns>
  118. </member>
  119. <member name="P:System.Diagnostics.Activity.Context">
  120. <summary>Gets the context of the activity. Context becomes valid only if the activity has been started.</summary>
  121. <returns>The context of the activity, if the activity has been started; otherwise, returns the default context.</returns>
  122. </member>
  123. <member name="P:System.Diagnostics.Activity.Current">
  124. <summary>Gets or sets the current operation (<see cref="T:System.Diagnostics.Activity" />) for the current thread. This flows across async calls.</summary>
  125. <returns>The current operation for the current thread.</returns>
  126. </member>
  127. <member name="P:System.Diagnostics.Activity.DefaultIdFormat">
  128. <summary>Gets or sets the default ID format for the <see cref="T:System.Diagnostics.Activity" />.</summary>
  129. </member>
  130. <member name="P:System.Diagnostics.Activity.DisplayName">
  131. <summary>Gets or sets the display name of the activity.</summary>
  132. <returns>A string that represents the activity display name.</returns>
  133. </member>
  134. <member name="P:System.Diagnostics.Activity.Duration">
  135. <summary>Gets the duration of the operation.</summary>
  136. <returns>The delta between <see cref="P:System.Diagnostics.Activity.StartTimeUtc" /> and the end time if the <see cref="T:System.Diagnostics.Activity" /> has ended (<see cref="M:System.Diagnostics.Activity.Stop" /> or <see cref="M:System.Diagnostics.Activity.SetEndTime(System.DateTime)" /> was called), or <see cref="F:System.TimeSpan.Zero" /> if the <see cref="T:System.Diagnostics.Activity" /> has not ended and <see cref="M:System.Diagnostics.Activity.SetEndTime(System.DateTime)" /> was not called.</returns>
  137. </member>
  138. <member name="P:System.Diagnostics.Activity.Events">
  139. <summary>Gets the list of all the activity events attached to this activity.</summary>
  140. <returns>An enumeration of activity events attached to this activity. If the activity has no events, returns an empty enumeration.</returns>
  141. </member>
  142. <member name="P:System.Diagnostics.Activity.ForceDefaultIdFormat">
  143. <summary>Gets or sets a valud that detrmines if the <see cref="P:System.Diagnostics.Activity.DefaultIdFormat" /> is always used to define the default ID format.</summary>
  144. <returns>
  145. <see langword="true" /> to always use the <see cref="P:System.Diagnostics.Activity.DefaultIdFormat" />; otherwise, <see langword="false" />.</returns>
  146. </member>
  147. <member name="P:System.Diagnostics.Activity.Id">
  148. <summary>Gets an identifier that is specific to a particular request.</summary>
  149. <returns>The activity ID.</returns>
  150. </member>
  151. <member name="P:System.Diagnostics.Activity.IdFormat">
  152. <summary>Gets the format for the <see cref="P:System.Diagnostics.Activity.Id" />.</summary>
  153. <returns>The format for the <see cref="P:System.Diagnostics.Activity.Id" />.</returns>
  154. </member>
  155. <member name="P:System.Diagnostics.Activity.IsAllDataRequested">
  156. <summary>Indicates if the this activity should be populated with all the propagation information, as well as all the other properties such as links, tags and events.</summary>
  157. <returns>
  158. <see langword="true" /> if the activity should be populated; <see langword="false" /> otherwise.</returns>
  159. </member>
  160. <member name="P:System.Diagnostics.Activity.Kind">
  161. <summary>Gets the relationship between the activity, its parents, and its children in a trace.</summary>
  162. <returns>One of the enumeration values that indicate relationship between the activity, its parents, and its children in a trace.</returns>
  163. </member>
  164. <member name="P:System.Diagnostics.Activity.Links">
  165. <summary>Gets the list of all the activity links attached to this activity.</summary>
  166. <returns>An enumeration of activity links attached to this activity. If the activity has no links, returns an empty enumeration.</returns>
  167. </member>
  168. <member name="P:System.Diagnostics.Activity.OperationName">
  169. <summary>Gets the operation name.</summary>
  170. <returns>The name of the operation.</returns>
  171. </member>
  172. <member name="P:System.Diagnostics.Activity.Parent">
  173. <summary>Gets the parent <see cref="T:System.Diagnostics.Activity" /> that created this activity.</summary>
  174. <returns>The parent of this <see cref="T:System.Diagnostics.Activity" />, if it is from the same process, or <see langword="null" /> if this instance has no parent (it is a root activity) or if the parent is from outside the process.</returns>
  175. </member>
  176. <member name="P:System.Diagnostics.Activity.ParentId">
  177. <summary>Gets the ID of this activity's parent.</summary>
  178. <returns>The parent ID, if one exists, or <see langword="null" /> if it does not.</returns>
  179. </member>
  180. <member name="P:System.Diagnostics.Activity.ParentSpanId">
  181. <summary>Gets the parent's <see cref="P:System.Diagnostics.Activity.SpanId" />.</summary>
  182. <returns>The parent's <see cref="P:System.Diagnostics.Activity.SpanId" />.</returns>
  183. </member>
  184. <member name="P:System.Diagnostics.Activity.Recorded">
  185. <summary>Gets a value that indicates whether the W3CIdFlags.Recorded flag is set.</summary>
  186. <returns>
  187. <see langword="true" /> if the W3CIdFlags.Recorded flag is set; otherwise, <see langword="false" />.</returns>
  188. </member>
  189. <member name="P:System.Diagnostics.Activity.RootId">
  190. <summary>Gets the root ID of this <see cref="T:System.Diagnostics.Activity" />.</summary>
  191. <returns>The root ID, or <see langword="null" /> if the current instance has either a <see cref="P:System.Diagnostics.Activity.ParentId" /> or an <see cref="P:System.Diagnostics.Activity.Id" />.</returns>
  192. </member>
  193. <member name="P:System.Diagnostics.Activity.Source">
  194. <summary>Get the activity source associated with this activity.</summary>
  195. </member>
  196. <member name="P:System.Diagnostics.Activity.SpanId">
  197. <summary>Gets the SPAN part of the <see cref="P:System.Diagnostics.Activity.Id" />.</summary>
  198. <returns>The ID for the SPAN part of <see cref="P:System.Diagnostics.Activity.Id" />, if the <see cref="T:System.Diagnostics.Activity" /> has the W3C format; otherwise, a zero <see langword="SpanId" />.</returns>
  199. </member>
  200. <member name="P:System.Diagnostics.Activity.StartTimeUtc">
  201. <summary>Gets the time when the operation started.</summary>
  202. <returns>The UTC time that the operation started.</returns>
  203. </member>
  204. <member name="P:System.Diagnostics.Activity.TagObjects">
  205. <summary>Returns the list of tags representing information to log along with the activity. This information is not passed on to the children of this activity.</summary>
  206. <returns>A key-value pair enumeration of tags and objects.</returns>
  207. </member>
  208. <member name="P:System.Diagnostics.Activity.Tags">
  209. <summary>Gets a collection of key/value pairs that represent information that will be logged along with the <see cref="T:System.Diagnostics.Activity" /> to the logging system.</summary>
  210. <returns>An enumeration of string-string key-value-pairs.</returns>
  211. </member>
  212. <member name="P:System.Diagnostics.Activity.TraceId">
  213. <summary>Gets the TraceId part of the <see cref="P:System.Diagnostics.Activity.Id" />.</summary>
  214. <returns>The ID for the TraceId part of the <see cref="P:System.Diagnostics.Activity.Id" />, if the ID has the W3C format; otherwise, a zero TraceId.</returns>
  215. </member>
  216. <member name="P:System.Diagnostics.Activity.TraceStateString">
  217. <summary>Gets the W3C <see langword="tracestate" /> header.</summary>
  218. <returns>The W3C <see langword="tracestate" /> header.</returns>
  219. </member>
  220. <member name="T:System.Diagnostics.ActivityContext">
  221. <summary>A representation that conforms to the W3C TraceContext specification. It contains two identifiers: a TraceId and a SpanId, along with a set of common TraceFlags and system-specific TraceState values.</summary>
  222. </member>
  223. <member name="M:System.Diagnostics.ActivityContext.#ctor(System.Diagnostics.ActivityTraceId,System.Diagnostics.ActivitySpanId,System.Diagnostics.ActivityTraceFlags,System.String,System.Boolean)">
  224. <summary>Construct a new activity context instance using the specified arguments.</summary>
  225. <param name="traceId">A trace identifier.</param>
  226. <param name="spanId">A span identifier.</param>
  227. <param name="traceFlags">Contain details about the trace.</param>
  228. <param name="traceState">Carries system-specific configuration data.</param>
  229. <param name="isRemote">Indicates if the context is propagated from a remote parent.</param>
  230. </member>
  231. <member name="M:System.Diagnostics.ActivityContext.Equals(System.Diagnostics.ActivityContext)">
  232. <summary>Indicates whether the current object is equal to another object of the same type.</summary>
  233. <param name="value">The object to compare to this instance.</param>
  234. <returns>
  235. <see langword="true" /> if the current object is equal to the <paramref name="other" /> parameter; otherwise, <see langword="false" />.</returns>
  236. </member>
  237. <member name="M:System.Diagnostics.ActivityContext.Equals(System.Object)">
  238. <summary>Determines whether this instance and a specified <see langword="ActivityContext" /> object have the same value.</summary>
  239. <param name="obj">The object to compare to this instance.</param>
  240. <returns>
  241. <see langword="true" /> if the current object is equal to the <paramref name="obj" /> parameter; otherwise, <see langword="false" />.</returns>
  242. </member>
  243. <member name="M:System.Diagnostics.ActivityContext.GetHashCode">
  244. <summary>Provides a hash function for the current <see langword="ActivityContext" /> that's suitable for hashing algorithms and data structures, such as hash tables.</summary>
  245. <returns>A hash code for the current <see langword="ActivityContext" />.</returns>
  246. </member>
  247. <member name="M:System.Diagnostics.ActivityContext.op_Equality(System.Diagnostics.ActivityContext,System.Diagnostics.ActivityContext)">
  248. <summary>Determines whether two specified <see langword="ActivityContext" /> values are equal.</summary>
  249. <param name="left">The first value to compare.</param>
  250. <param name="right">The second value to compare.</param>
  251. <returns>
  252. <see langword="true" /> if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, <see langword="false" />.</returns>
  253. </member>
  254. <member name="M:System.Diagnostics.ActivityContext.op_Inequality(System.Diagnostics.ActivityContext,System.Diagnostics.ActivityContext)">
  255. <summary>Determines whether two specified <see langword="ActivityContext" /> values are not equal.</summary>
  256. <param name="left">The first value to compare.</param>
  257. <param name="right">The second value to compare.</param>
  258. <returns>
  259. <see langword="true" /> if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, <see langword="false" />.</returns>
  260. </member>
  261. <member name="M:System.Diagnostics.ActivityContext.Parse(System.String,System.String)">
  262. <summary>Parses a W3C trace context headers to an <see cref="T:System.Diagnostics.ActivityContext" /> object.</summary>
  263. <param name="traceParent">The W3C trace parent header.</param>
  264. <param name="traceState">The trace state.</param>
  265. <exception cref="T:System.ArgumentException">The trace parent is invalid.</exception>
  266. <returns>The <see cref="T:System.Diagnostics.ActivityContext" /> object created from the parsing operation.</returns>
  267. </member>
  268. <member name="M:System.Diagnostics.ActivityContext.TryParse(System.String,System.String,System.Diagnostics.ActivityContext@)">
  269. <summary>Tries to parse the W3C trace context headers to an <see cref="T:System.Diagnostics.ActivityContext" /> object.</summary>
  270. <param name="traceParent">The W3C trace parent header.</param>
  271. <param name="traceState">The W3C trace state.</param>
  272. <param name="context">When this method returns <see langword="true" />, the <see cref="T:System.Diagnostics.ActivityContext" /> object created from the parsing operation.</param>
  273. <returns>
  274. <see langword="true" /> if the parsing was successful; <see langword="false" /> otherwise.</returns>
  275. </member>
  276. <member name="P:System.Diagnostics.ActivityContext.IsRemote">
  277. <summary>Indicates if the activity context was propagated from a remote parent.</summary>
  278. <returns>
  279. <see langword="true" /> if it was propagated from a remote parent; <see langword="false" /> otherwise.</returns>
  280. </member>
  281. <member name="P:System.Diagnostics.ActivityContext.SpanId">
  282. <summary>The Id of the request as known by the caller.</summary>
  283. <returns>The Span Id in the context.</returns>
  284. </member>
  285. <member name="P:System.Diagnostics.ActivityContext.TraceFlags">
  286. <summary>The flags defined by the W3C standard along with the ID for the activity.</summary>
  287. <returns>The context tracing flags.</returns>
  288. </member>
  289. <member name="P:System.Diagnostics.ActivityContext.TraceId">
  290. <summary>The trace identifier.</summary>
  291. <returns>The tracing identifier in the context.</returns>
  292. </member>
  293. <member name="P:System.Diagnostics.ActivityContext.TraceState">
  294. <summary>Holds the W3C 'tracestate' header.</summary>
  295. <returns>A string representing the W3C 'tracestate' header.</returns>
  296. </member>
  297. <member name="T:System.Diagnostics.ActivityCreationOptions`1">
  298. <summary>Encapsulates all the information that is sent to the activity listener, to make decisions about the creation of the activity instance, as well as its state.
  299. The possible generic type parameters are <see cref="T:System.Diagnostics.ActivityContext" /> or <see cref="T:System.String" />.</summary>
  300. <typeparam name="T">The type of the <see langword="Parent" /> property. Should be either <see cref="T:System.String" /> or <see langword="ActivityContext" />.</typeparam>
  301. </member>
  302. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Kind">
  303. <summary>Gets the activity kind which the activity will be created with.</summary>
  304. <returns>One of the enumeration values that represent an activity kind.</returns>
  305. </member>
  306. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Links">
  307. <summary>Gets the enumeration of activity links that the activity will be created with.</summary>
  308. <returns>An enumeration of activity links.</returns>
  309. </member>
  310. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Name">
  311. <summary>Gets the name to use as OperationName of the activity that will get created.</summary>
  312. <returns>A string representing the activity name.</returns>
  313. </member>
  314. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Parent">
  315. <summary>Gets the parent context or parent Id that the activity will get created with.</summary>
  316. <returns>The parent of the activity, represented either as a <see cref="T:System.String" /> or as an <see cref="T:System.Diagnostics.ActivityContext" />.</returns>
  317. </member>
  318. <member name="P:System.Diagnostics.ActivityCreationOptions`1.SamplingTags">
  319. <summary>Gets the collection that is used to add more tags during the sampling process. The added tags are also added to the created Activity if it is decided that it should be created by the <see cref="T:System.Diagnostics.ActivityListener" /> callbacks.</summary>
  320. <returns>The Activity tags collection.</returns>
  321. </member>
  322. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Source">
  323. <summary>Gets the activity source that creates the activity.</summary>
  324. <returns>An activity source object.</returns>
  325. </member>
  326. <member name="P:System.Diagnostics.ActivityCreationOptions`1.Tags">
  327. <summary>Gets the tags that the activity will be created with.</summary>
  328. <returns>A key-value pair enumeration of tags associated with the activity.</returns>
  329. </member>
  330. <member name="P:System.Diagnostics.ActivityCreationOptions`1.TraceId">
  331. <summary>Gets the trace Id to use in the Activity object if it is decided that it should be created by <see cref="T:System.Diagnostics.ActivityListener" /> callbacks.</summary>
  332. <returns>The trace Id.</returns>
  333. </member>
  334. <member name="T:System.Diagnostics.ActivityEvent">
  335. <summary>Represents an event containing a name and a timestamp, as well as an optional list of tags.</summary>
  336. </member>
  337. <member name="M:System.Diagnostics.ActivityEvent.#ctor(System.String)">
  338. <summary>Initializes a new activity event instance using the specified name and the current time as the event timestamp.</summary>
  339. <param name="name">The event name.</param>
  340. </member>
  341. <member name="M:System.Diagnostics.ActivityEvent.#ctor(System.String,System.DateTimeOffset,System.Diagnostics.ActivityTagsCollection)">
  342. <summary>Initializes a new activity event instance using the specified name, timestamp and tags.</summary>
  343. <param name="name">The event name.</param>
  344. <param name="timestamp">The event timestamp. Timestamp must only be used for the events that happened in the past, not at the moment of this call.</param>
  345. <param name="tags">The event tags.</param>
  346. </member>
  347. <member name="P:System.Diagnostics.ActivityEvent.Name">
  348. <summary>Gets the activity event name.</summary>
  349. <returns>A string representing the activity event name.</returns>
  350. </member>
  351. <member name="P:System.Diagnostics.ActivityEvent.Tags">
  352. <summary>Gets the collection of tags associated with the event.</summary>
  353. <returns>A key-value pair enumeration containing the tags associated with the event.</returns>
  354. </member>
  355. <member name="P:System.Diagnostics.ActivityEvent.Timestamp">
  356. <summary>Gets the activity event timestamp.</summary>
  357. <returns>A datetime offset representing the activity event timestamp.</returns>
  358. </member>
  359. <member name="T:System.Diagnostics.ActivityIdFormat">
  360. <summary>Specifies the format of the <see cref="P:System.Diagnostics.Activity.Id" /> property.</summary>
  361. </member>
  362. <member name="F:System.Diagnostics.ActivityIdFormat.Hierarchical">
  363. <summary>The hierarchical format.</summary>
  364. </member>
  365. <member name="F:System.Diagnostics.ActivityIdFormat.Unknown">
  366. <summary>An unknown format.</summary>
  367. </member>
  368. <member name="F:System.Diagnostics.ActivityIdFormat.W3C">
  369. <summary>The W3C format.</summary>
  370. </member>
  371. <member name="T:System.Diagnostics.ActivityKind">
  372. <summary>Describes the relationship between the activity, its parents and its children in a trace.</summary>
  373. </member>
  374. <member name="F:System.Diagnostics.ActivityKind.Client">
  375. <summary>Outgoing request to the external component.</summary>
  376. </member>
  377. <member name="F:System.Diagnostics.ActivityKind.Consumer">
  378. <summary>Output received from an external component.</summary>
  379. </member>
  380. <member name="F:System.Diagnostics.ActivityKind.Internal">
  381. <summary>Internal operation within an application, as opposed to operations with remote parents or children. This is the default value.</summary>
  382. </member>
  383. <member name="F:System.Diagnostics.ActivityKind.Producer">
  384. <summary>Output provided to external components.</summary>
  385. </member>
  386. <member name="F:System.Diagnostics.ActivityKind.Server">
  387. <summary>Requests incoming from external component.</summary>
  388. </member>
  389. <member name="T:System.Diagnostics.ActivityLink">
  390. <summary>Activities may be linked to zero or more activity context instances that are causally related.
  391. Activity links can point to activity contexts inside a single trace or across different traces.
  392. Activity links can be used to represent batched operations where an activity was initiated by multiple initiating activities, each representing a single incoming item being processed in the batch.</summary>
  393. </member>
  394. <member name="M:System.Diagnostics.ActivityLink.#ctor(System.Diagnostics.ActivityContext,System.Diagnostics.ActivityTagsCollection)">
  395. <summary>Constructs a new activity link, which can be linked to an activity.</summary>
  396. <param name="context">The trace activity context.</param>
  397. <param name="tags">The key-value pair list of tags associated to the activity context.</param>
  398. </member>
  399. <member name="M:System.Diagnostics.ActivityLink.Equals(System.Diagnostics.ActivityLink)">
  400. <summary>Indicates whether the current activity link is equal to another activity link.</summary>
  401. <param name="value">The activity link to compare.</param>
  402. <returns>
  403. <see langword="true" /> if the current activity link is equal to <paramref name="other" />; otherwise, <see langword="false" />.</returns>
  404. </member>
  405. <member name="M:System.Diagnostics.ActivityLink.Equals(System.Object)">
  406. <summary>Indicates whether the current activity link is equal to another object.</summary>
  407. <param name="obj">The object to compare.</param>
  408. <returns>
  409. <see langword="true" /> if the current activity link is equal to <paramref name="obj" />; otherwise, <see langword="false" />.</returns>
  410. </member>
  411. <member name="M:System.Diagnostics.ActivityLink.GetHashCode">
  412. <summary>Provides a hash function for the current <see langword="ActivityLink" /> that's suitable for hashing algorithms and data structures, such as hash tables.</summary>
  413. <returns>A hash code for the current <see langword="ActivityLink" />.</returns>
  414. </member>
  415. <member name="M:System.Diagnostics.ActivityLink.op_Equality(System.Diagnostics.ActivityLink,System.Diagnostics.ActivityLink)">
  416. <summary>Determines whether two specified <see langword="ActivityLink" /> values are equal.</summary>
  417. <param name="left">The first value to compare.</param>
  418. <param name="right">The second value to compare.</param>
  419. <returns>
  420. <see langword="true" /> if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, <see langword="false" />.</returns>
  421. </member>
  422. <member name="M:System.Diagnostics.ActivityLink.op_Inequality(System.Diagnostics.ActivityLink,System.Diagnostics.ActivityLink)">
  423. <summary>Determines whether two specified <see langword="ActivityLink" /> values are not equal.</summary>
  424. <param name="left">The first value to compare.</param>
  425. <param name="right">The second value to compare.</param>
  426. <returns>
  427. <see langword="true" /> if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, <see langword="false" />.</returns>
  428. </member>
  429. <member name="P:System.Diagnostics.ActivityLink.Context">
  430. <summary>Retrieves the activity context inside this activity link.</summary>
  431. </member>
  432. <member name="P:System.Diagnostics.ActivityLink.Tags">
  433. <summary>Retrieves the key-value pair enumeration of tags attached to the activity context.</summary>
  434. <returns>An enumeration of tags attached to the activity context.</returns>
  435. </member>
  436. <member name="T:System.Diagnostics.ActivityListener">
  437. <summary>Allows listening to the start and stop activity events and gives the opportunity to decide creating an activity for sampling scenarios.</summary>
  438. </member>
  439. <member name="M:System.Diagnostics.ActivityListener.#ctor">
  440. <summary>Construct a new activity listener object to start listeneing to the activity events.</summary>
  441. </member>
  442. <member name="M:System.Diagnostics.ActivityListener.Dispose">
  443. <summary>Unregisters this activity listener object from listening to activity events.</summary>
  444. </member>
  445. <member name="P:System.Diagnostics.ActivityListener.ActivityStarted">
  446. <summary>Gets or sets the callback used to listen to the activity start event.</summary>
  447. <returns>An activity callback instance used to listen to the activity start event.</returns>
  448. </member>
  449. <member name="P:System.Diagnostics.ActivityListener.ActivityStopped">
  450. <summary>Gets or sets the callback used to listen to the activity stop event.</summary>
  451. <returns>An activity callback instance used to listen to the activity stop event.</returns>
  452. </member>
  453. <member name="P:System.Diagnostics.ActivityListener.Sample">
  454. <summary>Gets or sets the callback that is used to decide if creating <see cref="T:System.Diagnostics.Activity" /> objects with a specific data state is allowed.</summary>
  455. <returns>A sample activity instance.</returns>
  456. </member>
  457. <member name="P:System.Diagnostics.ActivityListener.SampleUsingParentId">
  458. <summary>Gets or sets the callback that is used to decide if creating <see cref="T:System.Diagnostics.Activity" /> objects with a specific data state is allowed.</summary>
  459. <returns>A sample activity instance.</returns>
  460. </member>
  461. <member name="P:System.Diagnostics.ActivityListener.ShouldListenTo">
  462. <summary>Gets or sets the callback that allows deciding if activity object events that were created using the activity source object should be listened or not.</summary>
  463. <returns>
  464. <see langword="true" /> to listen events; <see langword="false" /> otherwise.</returns>
  465. </member>
  466. <member name="T:System.Diagnostics.ActivitySamplingResult">
  467. <summary>Enumeration values used by <see cref="T:System.Diagnostics.ActivityListener" /> to indicate the amount of data to collect for the related <see cref="T:System.Diagnostics.Activity" />. Requesting more data causes a greater performance overhead.</summary>
  468. </member>
  469. <member name="F:System.Diagnostics.ActivitySamplingResult.AllData">
  470. <summary>The activity object should be populated with all the propagation information and also all other properties such as Links, Tags, and Events. Using this value causes <see cref="P:System.Diagnostics.Activity.IsAllDataRequested" /> to return <see langword="true" />.</summary>
  471. </member>
  472. <member name="F:System.Diagnostics.ActivitySamplingResult.AllDataAndRecorded">
  473. <summary>The activity object should be populated the same as the <see cref="F:System.Diagnostics.ActivitySamplingResult.AllData" /> case. Additionally, Activity.Recorded is set to <see langword="true" />. For activities using the W3C trace ids, this sets a flag bit in the ID that will be propagated downstream requesting that the trace is recorded everywhere.</summary>
  474. </member>
  475. <member name="F:System.Diagnostics.ActivitySamplingResult.None">
  476. <summary>The activity object does not need to be created.</summary>
  477. </member>
  478. <member name="F:System.Diagnostics.ActivitySamplingResult.PropagationData">
  479. <summary>The activity object needs to be created. It will have a Name, a Source, an Id and Baggage. Other properties are unnecessary and will be ignored by this listener.</summary>
  480. </member>
  481. <member name="T:System.Diagnostics.ActivitySource">
  482. <summary>Provides APIs to create and start <see cref="T:System.Diagnostics.Activity" /> objects and to register <see cref="T:System.Diagnostics.ActivityListener" /> objects to listen to the <see cref="T:System.Diagnostics.Activity" /> events.</summary>
  483. </member>
  484. <member name="M:System.Diagnostics.ActivitySource.#ctor(System.String,System.String)">
  485. <summary>Constructs an activity source object with the specified <paramref name="name" />.</summary>
  486. <param name="name">The name of the activity source object.</param>
  487. <param name="version">The version of the component publishing the tracing info.</param>
  488. </member>
  489. <member name="M:System.Diagnostics.ActivitySource.AddActivityListener(System.Diagnostics.ActivityListener)">
  490. <summary>Adds a listener to the activity starting and stopping events.</summary>
  491. <param name="listener">The activity listener object to use for listening to the activity events.</param>
  492. </member>
  493. <member name="M:System.Diagnostics.ActivitySource.Dispose">
  494. <summary>Disposes the activity source object, removes the current instance from the global list, and empties the listeners list.</summary>
  495. </member>
  496. <member name="M:System.Diagnostics.ActivitySource.HasListeners">
  497. <summary>Checks if there are any listeners for this activity source.</summary>
  498. <returns>
  499. <see langword="true" /> if there is a listener registered for this activity source; otherwise, <see langword="false" />.</returns>
  500. </member>
  501. <member name="M:System.Diagnostics.ActivitySource.StartActivity(System.String,System.Diagnostics.ActivityKind)">
  502. <summary>Creates a new activity if there are active listeners for it, using the specified name and activity kind.</summary>
  503. <param name="name">The operation name of the activity.</param>
  504. <param name="kind">The activity kind.</param>
  505. <returns>The created activity object, if it had active listeners, or <see langword="null" /> if it has no event listeners.</returns>
  506. </member>
  507. <member name="M:System.Diagnostics.ActivitySource.StartActivity(System.String,System.Diagnostics.ActivityKind,System.Diagnostics.ActivityContext,System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.Object}},System.Collections.Generic.IEnumerable{System.Diagnostics.ActivityLink},System.DateTimeOffset)">
  508. <summary>Creates a new activity if there are active listeners for it, using the specified name, activity kind, parent activity context, tags, optional activity link and optional start time.</summary>
  509. <param name="name">The operation name of the activity.</param>
  510. <param name="kind">The activity kind.</param>
  511. <param name="parentContext">The parent <see cref="T:System.Diagnostics.ActivityContext" /> object to initialize the created activity object with.</param>
  512. <param name="tags">The optional tags list to initialize the created activity object with.</param>
  513. <param name="links">The optional <see cref="T:System.Diagnostics.ActivityLink" /> list to initialize the created activity object with.</param>
  514. <param name="startTime">The optional start timestamp to set on the created activity object.</param>
  515. <returns>The created activity object, if it had active listeners, or <see langword="null" /> if it has no event listeners.</returns>
  516. </member>
  517. <member name="M:System.Diagnostics.ActivitySource.StartActivity(System.String,System.Diagnostics.ActivityKind,System.String,System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.Object}},System.Collections.Generic.IEnumerable{System.Diagnostics.ActivityLink},System.DateTimeOffset)">
  518. <summary>Creates a new activity if there are active listeners for it, using the specified name, activity kind, parent Id, tags, optional activity links and optional start time.</summary>
  519. <param name="name">The operation name of the activity.</param>
  520. <param name="kind">The activity kind.</param>
  521. <param name="parentId">The parent Id to initialize the created activity object with.</param>
  522. <param name="tags">The optional tags list to initialize the created activity object with.</param>
  523. <param name="links">The optional <see cref="T:System.Diagnostics.ActivityLink" /> list to initialize the created activity object with.</param>
  524. <param name="startTime">The optional start timestamp to set on the created activity object.</param>
  525. <returns>The created activity object, if it had active listeners, or <see langword="null" /> if it has no event listeners.</returns>
  526. </member>
  527. <member name="P:System.Diagnostics.ActivitySource.Name">
  528. <summary>Returns the activity source name.</summary>
  529. <returns>A string that represents the activity source name.</returns>
  530. </member>
  531. <member name="P:System.Diagnostics.ActivitySource.Version">
  532. <summary>Returns the activity source version.</summary>
  533. <returns>A string that represents the activity source version.</returns>
  534. </member>
  535. <member name="T:System.Diagnostics.ActivitySpanId">
  536. <summary>Represents a <see cref="P:System.Diagnostics.Activity.SpanId" /> formatted based on a W3C standard.</summary>
  537. </member>
  538. <member name="M:System.Diagnostics.ActivitySpanId.CopyTo(System.Span{System.Byte})">
  539. <summary>Copies the 8 bytes of the current <see cref="T:System.Diagnostics.ActivitySpanId" /> to a specified span.</summary>
  540. <param name="destination">The span to which the 8 bytes of the SpanID are to be copied.</param>
  541. </member>
  542. <member name="M:System.Diagnostics.ActivitySpanId.CreateFromBytes(System.ReadOnlySpan{System.Byte})">
  543. <summary>Creates a new <see cref="T:System.Diagnostics.ActivitySpanId" /> value from a read-only span of eight bytes.</summary>
  544. <param name="idData">A read-only span of eight bytes.</param>
  545. <exception cref="T:System.ArgumentOutOfRangeException">
  546. <paramref name="idData" /> does not contain eight bytes.</exception>
  547. <returns>The new span ID.</returns>
  548. </member>
  549. <member name="M:System.Diagnostics.ActivitySpanId.CreateFromString(System.ReadOnlySpan{System.Char})">
  550. <summary>Creates a new <see cref="T:System.Diagnostics.ActivitySpanId" /> value from a read-only span of 16 hexadecimal characters.</summary>
  551. <param name="idData">A span that contains 16 hexadecimal characters.</param>
  552. <exception cref="T:System.ArgumentOutOfRangeException">
  553. <paramref name="idData" /> does not contain 16 hexadecimal characters.
  554. -or-
  555. The characters in <paramref name="idData" /> are not all lower-case hexadecimal characters or all zeros.</exception>
  556. <returns>The new span ID.</returns>
  557. </member>
  558. <member name="M:System.Diagnostics.ActivitySpanId.CreateFromUtf8String(System.ReadOnlySpan{System.Byte})">
  559. <summary>Creates a new <see cref="T:System.Diagnostics.ActivitySpanId" /> value from a read-only span of UTF8-encoded bytes.</summary>
  560. <param name="idData">A read-only span of UTF8-encoded bytes.</param>
  561. <returns>The new span ID.</returns>
  562. </member>
  563. <member name="M:System.Diagnostics.ActivitySpanId.CreateRandom">
  564. <summary>Creates a new <see cref="T:System.Diagnostics.ActivitySpanId" /> based on a random number (that is very likely to be unique).</summary>
  565. <returns>The new span ID.</returns>
  566. </member>
  567. <member name="M:System.Diagnostics.ActivitySpanId.Equals(System.Diagnostics.ActivitySpanId)">
  568. <summary>Determines whether this instance and the specified <see cref="T:System.Diagnostics.ActivitySpanId" /> instance have the same value.</summary>
  569. <param name="spanId">The instance to compare.</param>
  570. <returns>
  571. <see langword="true" /> if <paramref name="spanId" /> has the same hex value as the current instance; otherwise, <see langword="false" />.</returns>
  572. </member>
  573. <member name="M:System.Diagnostics.ActivitySpanId.Equals(System.Object)">
  574. <summary>the current instance and a specified object, which also must be an <see cref="T:System.Diagnostics.ActivitySpanId" /> instance, have the same value.</summary>
  575. <param name="obj">The object to compare.</param>
  576. <returns>
  577. <see langword="true" /> if <paramref name="obj" /> is an instance of <see cref="T:System.Diagnostics.ActivitySpanId" /> and has the same hex value as the current instance; otherwise, <see langword="false" />.</returns>
  578. </member>
  579. <member name="M:System.Diagnostics.ActivitySpanId.GetHashCode">
  580. <summary>Returns the hash code of the SpanId.</summary>
  581. <returns>The hash code of the SpanId.</returns>
  582. </member>
  583. <member name="M:System.Diagnostics.ActivitySpanId.op_Equality(System.Diagnostics.ActivitySpanId,System.Diagnostics.ActivitySpanId)">
  584. <summary>Determines whether two specified <see cref="T:System.Diagnostics.ActivitySpanId" /> instances have the same value.</summary>
  585. <param name="spanId1">The first instance to compare.</param>
  586. <param name="spandId2">The second instance to compare.</param>
  587. <returns>
  588. <see langword="true" /> if the SpanId of <paramref name="spanId1" /> is the same as the SpanId of <paramref name="spandId2" />; otherwise, <see langword="false" />.</returns>
  589. </member>
  590. <member name="M:System.Diagnostics.ActivitySpanId.op_Inequality(System.Diagnostics.ActivitySpanId,System.Diagnostics.ActivitySpanId)">
  591. <summary>Determine whether two specified <see cref="T:System.Diagnostics.ActivitySpanId" /> instances have unequal values.</summary>
  592. <param name="spanId1">The first instance to compare.</param>
  593. <param name="spandId2">The second instance to compare.</param>
  594. <returns>
  595. <see langword="true" /> if the SpanId of <paramref name="spanId1" /> is different from the SpanId of <paramref name="spandId2" />; otherwise, <see langword="false" />.</returns>
  596. </member>
  597. <member name="M:System.Diagnostics.ActivitySpanId.ToHexString">
  598. <summary>Returns a 16-character hexadecimal string that represents this span ID.</summary>
  599. <returns>The 16-character hexadecimal string representation of this span ID.</returns>
  600. </member>
  601. <member name="M:System.Diagnostics.ActivitySpanId.ToString">
  602. <summary>Returns a 16-character hexadecimal string that represents this span ID.</summary>
  603. <returns>The 16-character hexadecimal string representation of this span ID.</returns>
  604. </member>
  605. <member name="T:System.Diagnostics.ActivityTagsCollection">
  606. <summary>ActivityTagsCollection is a collection class used to store tracing tags.
  607. This collection will be used with classes like <see cref="T:System.Diagnostics.ActivityEvent" /> and <see cref="T:System.Diagnostics.ActivityLink" />.
  608. This collection behaves as follows:
  609. - The collection items will be ordered according to how they are added.
  610. - Don't allow duplication of items with the same key.
  611. - When using the indexer to store an item in the collection:
  612. - If the item has a key that previously existed in the collection and the value is <see langword="null" />, the collection item matching the key will be removed from the collection.
  613. - If the item has a key that previously existed in the collection and the value is not <see langword="null" />, the new item value will replace the old value stored in the collection.
  614. - Otherwise, the item will be added to the collection.
  615. - Add method will add a new item to the collection if an item doesn't already exist with the same key. Otherwise, it will throw an exception.</summary>
  616. </member>
  617. <member name="M:System.Diagnostics.ActivityTagsCollection.#ctor">
  618. <summary>Create a new instance of the collection.</summary>
  619. </member>
  620. <member name="M:System.Diagnostics.ActivityTagsCollection.#ctor(System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.Object}})">
  621. <summary>Create a new instance of the collection and store the input list items in the collection.</summary>
  622. <param name="list">Initial list to store in the collection.</param>
  623. </member>
  624. <member name="M:System.Diagnostics.ActivityTagsCollection.Add(System.Collections.Generic.KeyValuePair{System.String,System.Object})">
  625. <summary>Adds an item to the collection</summary>
  626. <param name="item">Key and value pair of the tag to add to the collection.</param>
  627. <exception cref="T:System.InvalidOperationException">
  628. <paramref name="item" /> already exists in the list.</exception>
  629. <exception cref="T:System.ArgumentNullException">
  630. <paramref name="item" /> is <see langword="null" />.</exception>
  631. </member>
  632. <member name="M:System.Diagnostics.ActivityTagsCollection.Add(System.String,System.Object)">
  633. <summary>Adds a tag with the provided key and value to the collection. This collection doesn't allow adding two tags with the same key.</summary>
  634. <param name="key">The tag key.</param>
  635. <param name="value">The tag value.</param>
  636. </member>
  637. <member name="M:System.Diagnostics.ActivityTagsCollection.Clear">
  638. <summary>Removes all items from the collection.</summary>
  639. </member>
  640. <member name="M:System.Diagnostics.ActivityTagsCollection.Contains(System.Collections.Generic.KeyValuePair{System.String,System.Object})">
  641. <summary>Determines whether the <see cref="T:System.Collections.Generic.ICollection`1" /> contains a specific value.</summary>
  642. <param name="item">The object to locate in the <see cref="T:System.Collections.Generic.ICollection`1" />.</param>
  643. <returns>
  644. <see langword="true" /> if <paramref name="item" /> is found in the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />.</returns>
  645. </member>
  646. <member name="M:System.Diagnostics.ActivityTagsCollection.ContainsKey(System.String)">
  647. <summary>Determines whether the collection contains an element with the specified key.</summary>
  648. <param name="key">The key to locate in the <see cref="T:System.Collections.Generic.IDictionary`2" />.</param>
  649. <returns>
  650. <see langword="true" /> if the collection contains tag with that key. <see langword="false" /> otherwise.</returns>
  651. </member>
  652. <member name="M:System.Diagnostics.ActivityTagsCollection.CopyTo(System.Collections.Generic.KeyValuePair{System.String,System.Object}[],System.Int32)">
  653. <summary>Copies the elements of the collection to an array, starting at a particular array index.</summary>
  654. <param name="array">The array that is the destination of the elements copied from collection.</param>
  655. <param name="arrayIndex">The zero-based index in array at which copying begins.</param>
  656. </member>
  657. <member name="M:System.Diagnostics.ActivityTagsCollection.GetEnumerator">
  658. <summary>Returns an enumerator that iterates through the collection.</summary>
  659. <returns>An enumerator for the <see langword="ActivityTagsCollection" />.</returns>
  660. </member>
  661. <member name="M:System.Diagnostics.ActivityTagsCollection.Remove(System.Collections.Generic.KeyValuePair{System.String,System.Object})">
  662. <summary>Removes the first occurrence of a specific item from the collection.</summary>
  663. <param name="item">The tag key value pair to remove.</param>
  664. <returns>
  665. <see langword="true" /> if item was successfully removed from the collection; otherwise, <see langword="false" />. This method also returns <see langword="false" /> if item is not found in the original collection.</returns>
  666. </member>
  667. <member name="M:System.Diagnostics.ActivityTagsCollection.Remove(System.String)">
  668. <summary>Removes the tag with the specified key from the collection.</summary>
  669. <param name="key">The tag key.</param>
  670. <returns>
  671. <see langword="true" /> if the item existed and removed. <see langword="false" /> otherwise.</returns>
  672. </member>
  673. <member name="M:System.Diagnostics.ActivityTagsCollection.System#Collections#Generic#IEnumerable{System#Collections#Generic#KeyValuePair{System#String@System#Object}}#GetEnumerator">
  674. <summary>Returns an enumerator that iterates through the collection.</summary>
  675. <returns>An enumerator that can be used to iterate through the collection.</returns>
  676. </member>
  677. <member name="M:System.Diagnostics.ActivityTagsCollection.System#Collections#IEnumerable#GetEnumerator">
  678. <summary>Returns an enumerator that iterates through the collection.</summary>
  679. <returns>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</returns>
  680. </member>
  681. <member name="M:System.Diagnostics.ActivityTagsCollection.TryGetValue(System.String,System.Object@)">
  682. <summary>Gets the value associated with the specified key.</summary>
  683. <param name="key">The tag key.</param>
  684. <param name="value">The tag value.</param>
  685. <returns>When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter. This parameter is passed uninitialized.</returns>
  686. </member>
  687. <member name="P:System.Diagnostics.ActivityTagsCollection.Count">
  688. <summary>Gets the number of elements contained in the collection.</summary>
  689. </member>
  690. <member name="P:System.Diagnostics.ActivityTagsCollection.IsReadOnly">
  691. <summary>Gets a value indicating whether the collection is read-only. This always returns <see langword="false" />.</summary>
  692. <returns>Always returns <see langword="false" />.</returns>
  693. </member>
  694. <member name="P:System.Diagnostics.ActivityTagsCollection.Item(System.String)">
  695. <summary>Gets or sets a specified collection item.
  696. When setting a value to this indexer property, the following behavior is observed:
  697. - If the key previously existed in the collection and the value is <see langword="null" />, the collection item matching the key will get removed from the collection.
  698. - If the key previously existed in the collection and the value is not <see langword="null" />, the value will replace the old value stored in the collection.
  699. - Otherwise, a new item will get added to the collection.</summary>
  700. <param name="key">The key of the value to get or set.</param>
  701. <returns>The object mapped to the key.</returns>
  702. </member>
  703. <member name="P:System.Diagnostics.ActivityTagsCollection.Keys">
  704. <summary>Get the list of the keys of all stored tags.</summary>
  705. </member>
  706. <member name="P:System.Diagnostics.ActivityTagsCollection.Values">
  707. <summary>Get the list of the values of all stored tags.</summary>
  708. </member>
  709. <member name="T:System.Diagnostics.ActivityTagsCollection.Enumerator">
  710. <summary>Enumerates the elements of an <see langword="ActivityTagsCollection" />.</summary>
  711. </member>
  712. <member name="M:System.Diagnostics.ActivityTagsCollection.Enumerator.Dispose">
  713. <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.</summary>
  714. </member>
  715. <member name="M:System.Diagnostics.ActivityTagsCollection.Enumerator.MoveNext">
  716. <summary>Advances the enumerator to the next element of the collection.</summary>
  717. <returns>
  718. <see langword="true" /> if the enumerator was successfully advanced to the next element; <see langword="false" /> if the enumerator has passed the end of the collection.</returns>
  719. </member>
  720. <member name="M:System.Diagnostics.ActivityTagsCollection.Enumerator.System#Collections#IEnumerator#Reset">
  721. <summary>Sets the enumerator to its initial position, which is before the first element in the collection.</summary>
  722. </member>
  723. <member name="P:System.Diagnostics.ActivityTagsCollection.Enumerator.Current">
  724. <summary>Gets the element in the collection at the current position of the enumerator.</summary>
  725. <returns>The element in the collection at the current position of the enumerator.</returns>
  726. </member>
  727. <member name="P:System.Diagnostics.ActivityTagsCollection.Enumerator.System#Collections#IEnumerator#Current">
  728. <summary>Gets the element in the collection at the current position of the enumerator.</summary>
  729. <returns>The element in the collection at the current position of the enumerator.</returns>
  730. </member>
  731. <member name="T:System.Diagnostics.ActivityTraceFlags">
  732. <summary>Specifies flags defined by the W3C standard that are associated with an activity.</summary>
  733. </member>
  734. <member name="F:System.Diagnostics.ActivityTraceFlags.None">
  735. <summary>The activity has not been marked.</summary>
  736. </member>
  737. <member name="F:System.Diagnostics.ActivityTraceFlags.Recorded">
  738. <summary>The activity (or more likely its parents) has been marked as useful to record.</summary>
  739. </member>
  740. <member name="T:System.Diagnostics.ActivityTraceId">
  741. <summary>Represents a <see cref="P:System.Diagnostics.Activity.TraceId" /> whose format is based on a W3C standard.</summary>
  742. </member>
  743. <member name="M:System.Diagnostics.ActivityTraceId.CopyTo(System.Span{System.Byte})">
  744. <summary>Copies the 16 bytes of the current <see cref="T:System.Diagnostics.ActivityTraceId" /> to a specified span.</summary>
  745. <param name="destination">The span to which the 16 bytes of the trace ID are to be copied.</param>
  746. </member>
  747. <member name="M:System.Diagnostics.ActivityTraceId.CreateFromBytes(System.ReadOnlySpan{System.Byte})">
  748. <summary>Creates a new <see cref="T:System.Diagnostics.ActivityTraceId" /> value from a read-only span of 16 bytes.</summary>
  749. <param name="idData">A read-only span of 16 bytes.</param>
  750. <exception cref="T:System.ArgumentOutOfRangeException">
  751. <paramref name="idData" /> does not contain eight bytes.</exception>
  752. <returns>The new trace ID.</returns>
  753. </member>
  754. <member name="M:System.Diagnostics.ActivityTraceId.CreateFromString(System.ReadOnlySpan{System.Char})">
  755. <summary>Creates a new <see cref="T:System.Diagnostics.ActivityTraceId" /> value from a read-only span of 32 hexadecimal characters.</summary>
  756. <param name="idData">A span that contains 32 hexadecimal characters.</param>
  757. <exception cref="T:System.ArgumentOutOfRangeException">
  758. <paramref name="idData" /> does not contain 16 hexadecimal characters.
  759. -or-
  760. The characters in <paramref name="idData" /> are not all lower-case hexadecimal characters or all zeros.</exception>
  761. <returns>The new trace ID.</returns>
  762. </member>
  763. <member name="M:System.Diagnostics.ActivityTraceId.CreateFromUtf8String(System.ReadOnlySpan{System.Byte})">
  764. <summary>Creates a new <see cref="T:System.Diagnostics.ActivityTraceId" /> value from a read-only span of UTF8-encoded bytes.</summary>
  765. <param name="idData">A read-only span of UTF8-encoded bytes.</param>
  766. <returns>The new trace ID.</returns>
  767. </member>
  768. <member name="M:System.Diagnostics.ActivityTraceId.CreateRandom">
  769. <summary>Creates a new <see cref="T:System.Diagnostics.ActivitySpanId" /> based on a random number (that is very likely to be unique).</summary>
  770. <returns>The new span ID.</returns>
  771. </member>
  772. <member name="M:System.Diagnostics.ActivityTraceId.Equals(System.Diagnostics.ActivityTraceId)">
  773. <summary>Determines whether the current instance and a specified <see cref="T:System.Diagnostics.ActivityTraceId" /> are equal.</summary>
  774. <param name="traceId">The instance to compare.</param>
  775. <returns>
  776. <see langword="true" /> if <paramref name="traceId" /> has the same hex value as the current instance; otherwise, <see langword="false" />.</returns>
  777. </member>
  778. <member name="M:System.Diagnostics.ActivityTraceId.Equals(System.Object)">
  779. <summary>Determines whether this instance and a specified object, which must also be an <see cref="T:System.Diagnostics.ActivityTraceId" /> instance, have the same value.</summary>
  780. <param name="obj">The object to compare.</param>
  781. <returns>
  782. <see langword="true" /> if <paramref name="obj" /> is an instance of <see cref="T:System.Diagnostics.ActivityTraceId" /> and has the same hex value as the current instance; otherwise, <see langword="false" />.</returns>
  783. </member>
  784. <member name="M:System.Diagnostics.ActivityTraceId.GetHashCode">
  785. <summary>Returns the hash code of the TraceId.</summary>
  786. <returns>The hash code of the TraceId.</returns>
  787. </member>
  788. <member name="M:System.Diagnostics.ActivityTraceId.op_Equality(System.Diagnostics.ActivityTraceId,System.Diagnostics.ActivityTraceId)">
  789. <summary>Determines whether two specified <see cref="T:System.Diagnostics.ActivityTraceId" /> instances have the same value.</summary>
  790. <param name="traceId1">The first instance to compare.</param>
  791. <param name="traceId2">The second instance to compare.</param>
  792. <returns>
  793. <see langword="true" /> if the TraceId of <paramref name="traceId1" /> is the same as the TraceId of <paramref name="traceId2" />; otherwise, <see langword="false" />.</returns>
  794. </member>
  795. <member name="M:System.Diagnostics.ActivityTraceId.op_Inequality(System.Diagnostics.ActivityTraceId,System.Diagnostics.ActivityTraceId)">
  796. <summary>Determines whether two specified <see cref="T:System.Diagnostics.ActivityTraceId" /> instances have the same value.</summary>
  797. <param name="traceId1">The first instance to compare.</param>
  798. <param name="traceId2">The second instance to compare.</param>
  799. <returns>
  800. <see langword="true" /> if the TraceId of <paramref name="traceId1" /> is different from the TraceId of <paramref name="traceId2" />; otherwise, <see langword="false" />.</returns>
  801. </member>
  802. <member name="M:System.Diagnostics.ActivityTraceId.ToHexString">
  803. <summary>Returns a 16-character hexadecimal string that represents this span ID.</summary>
  804. <returns>The 32-character hexadecimal string representation of this trace ID.</returns>
  805. </member>
  806. <member name="M:System.Diagnostics.ActivityTraceId.ToString">
  807. <summary>Returns a 32-character hexadecimal string that represents this trace ID.</summary>
  808. <returns>The 32-character hexadecimal string representation of this trace ID.</returns>
  809. </member>
  810. <member name="T:System.Diagnostics.DiagnosticListener">
  811. <summary>Provides an implementation of the abstract <see cref="T:System.Diagnostics.DiagnosticSource" /> class that represents a named place to which a source sends its information (events).</summary>
  812. </member>
  813. <member name="M:System.Diagnostics.DiagnosticListener.#ctor(System.String)">
  814. <summary>Creates a new <see cref="T:System.Diagnostics.DiagnosticListener" />.</summary>
  815. <param name="name">The name of this <see cref="T:System.Diagnostics.DiagnosticListener" />.</param>
  816. </member>
  817. <member name="M:System.Diagnostics.DiagnosticListener.Dispose">
  818. <summary>Disposes the NotificationListeners.</summary>
  819. </member>
  820. <member name="M:System.Diagnostics.DiagnosticListener.IsEnabled">
  821. <summary>Determines whether there are any registered subscribers.</summary>
  822. <returns>
  823. <see langword="true" /> if there are any registered subscribers, <see langword="false" /> otherwise.</returns>
  824. </member>
  825. <member name="M:System.Diagnostics.DiagnosticListener.IsEnabled(System.String)">
  826. <summary>Checks whether the <see cref="T:System.Diagnostics.DiagnosticListener" /> is enabled.</summary>
  827. <param name="name">The name of the event to check.</param>
  828. <returns>
  829. <see langword="true" /> if notifications are enabled; otherwise, <see langword="false" />.</returns>
  830. </member>
  831. <member name="M:System.Diagnostics.DiagnosticListener.IsEnabled(System.String,System.Object,System.Object)">
  832. <summary>Checks if any subscriber to the diagnostic events is interested in receiving events with this name. Subscribers indicate their interest using a delegate provided in <see cref="Overload:System.Diagnostics.DiagnosticListener.Subscribe" />.</summary>
  833. <param name="name">The name of the event to check.</param>
  834. <param name="arg1">The object that represents a context.</param>
  835. <param name="arg2">The object that represents a context.</param>
  836. <returns>
  837. <see langword="true" /> if it is enabled, <see langword="false" /> otherwise.</returns>
  838. </member>
  839. <member name="M:System.Diagnostics.DiagnosticListener.OnActivityExport(System.Diagnostics.Activity,System.Object)">
  840. <summary>Invokes the OnActivityExport method of all the subscribers.</summary>
  841. <param name="activity">The activity affected by an external event.</param>
  842. <param name="payload">An object that represents the outgoing request.</param>
  843. </member>
  844. <member name="M:System.Diagnostics.DiagnosticListener.OnActivityImport(System.Diagnostics.Activity,System.Object)">
  845. <summary>Invokes the OnActivityImport method of all the subscribers.</summary>
  846. <param name="activity">The activity affected by an external event.</param>
  847. <param name="payload">An object that represents the incoming request.</param>
  848. </member>
  849. <member name="M:System.Diagnostics.DiagnosticListener.Subscribe(System.IObserver{System.Collections.Generic.KeyValuePair{System.String,System.Object}})">
  850. <summary>Adds a subscriber.</summary>
  851. <param name="observer">A subscriber.</param>
  852. <returns>A reference to an interface that allows the listener to stop receiving notifications before the <see cref="T:System.Diagnostics.DiagnosticSource" /> has finished sending them.</returns>
  853. </member>
  854. <member name="M:System.Diagnostics.DiagnosticListener.Subscribe(System.IObserver{System.Collections.Generic.KeyValuePair{System.String,System.Object}},System.Func{System.String,System.Object,System.Object,System.Boolean})">
  855. <summary>Adds a subscriber, and optionally filters events based on their name and up to two context objects.</summary>
  856. <param name="observer">A subscriber.</param>
  857. <param name="isEnabled">A delegate that filters events based on their name and up to two context objects (which can be <see langword="null" />), or <see langword="null" /> to if an event filter is not desirable.</param>
  858. <returns>A reference to an interface that allows the listener to stop receiving notifications before the <see cref="T:System.Diagnostics.DiagnosticSource" /> has finished sending them.</returns>
  859. </member>
  860. <member name="M:System.Diagnostics.DiagnosticListener.Subscribe(System.IObserver{System.Collections.Generic.KeyValuePair{System.String,System.Object}},System.Func{System.String,System.Object,System.Object,System.Boolean},System.Action{System.Diagnostics.Activity,System.Object},System.Action{System.Diagnostics.Activity,System.Object})">
  861. <summary>Adds a subscriber, optionally filters events based on their name and up to two context objects, and specifies methods to call when providers import or export activites from outside the process.</summary>
  862. <param name="observer">A subscriber.</param>
  863. <param name="isEnabled">A delegate that filters events based on their name and up to two context objects (which can be <see langword="null" />), or <see langword="null" /> if an event filter is not desirable.</param>
  864. <param name="onActivityImport">An action delegate that receives the activity affected by an external event and an object that represents the incoming request.</param>
  865. <param name="onActivityExport">An action delegate that receives the activity affected by an external event and an object that represents the outgoing request.</param>
  866. <returns>A reference to an interface that allows the listener to stop receiving notifications before the <see cref="T:System.Diagnostics.DiagnosticSource" /> has finished sending them.</returns>
  867. </member>
  868. <member name="M:System.Diagnostics.DiagnosticListener.Subscribe(System.IObserver{System.Collections.Generic.KeyValuePair{System.String,System.Object}},System.Predicate{System.String})">
  869. <summary>Adds a subscriber, and optionally filters events based on their name.</summary>
  870. <param name="observer">A subscriber.</param>
  871. <param name="isEnabled">A delegate that filters events based on their name (<see cref="T:System.String" />). The delegate should return <see langword="true" /> if the event is enabled.</param>
  872. <returns>A reference to an interface that allows the listener to stop receiving notifications before the <see cref="T:System.Diagnostics.DiagnosticSource" /> has finished sending them.</returns>
  873. </member>
  874. <member name="M:System.Diagnostics.DiagnosticListener.ToString">
  875. <summary>Returns a string with the name of this DiagnosticListener.</summary>
  876. <returns>The name of this DiagnosticListener.</returns>
  877. </member>
  878. <member name="M:System.Diagnostics.DiagnosticListener.Write(System.String,System.Object)">
  879. <summary>Logs a notification.</summary>
  880. <param name="name">The name of the event to log.</param>
  881. <param name="value">An object that represents the payload for the event.</param>
  882. </member>
  883. <member name="P:System.Diagnostics.DiagnosticListener.AllListeners">
  884. <summary>Gets the collection of listeners for this <see cref="T:System.Diagnostics.DiagnosticListener" />.</summary>
  885. </member>
  886. <member name="P:System.Diagnostics.DiagnosticListener.Name">
  887. <summary>Gets the name of this <see cref="T:System.Diagnostics.DiagnosticListener" />.</summary>
  888. <returns>The name of the <see cref="T:System.Diagnostics.DiagnosticListener" />.</returns>
  889. </member>
  890. <member name="T:System.Diagnostics.DiagnosticSource">
  891. <summary>An abstract class that allows code to be instrumented for production-time logging of rich data payloads for consumption within the process that was instrumented.</summary>
  892. </member>
  893. <member name="M:System.Diagnostics.DiagnosticSource.#ctor">
  894. <summary>Initializes an instance of the <see cref="T:System.Diagnostics.DiagnosticSource" /> class.</summary>
  895. </member>
  896. <member name="M:System.Diagnostics.DiagnosticSource.IsEnabled(System.String)">
  897. <summary>Verifies if the notification event is enabled.</summary>
  898. <param name="name">The name of the event being written.</param>
  899. <returns>
  900. <see langword="true" /> if the notification event is enabled, <see langword="false" /> otherwise.</returns>
  901. </member>
  902. <member name="M:System.Diagnostics.DiagnosticSource.IsEnabled(System.String,System.Object,System.Object)">
  903. <summary>Verifies it the notification event is enabled.</summary>
  904. <param name="name">The name of the event being written.</param>
  905. <param name="arg1">An object that represents the additional context for IsEnabled. Consumers should expect to receive <see langword="null" /> which may indicate that producer called pure IsEnabled(string) to check if consumer wants to get notifications for such events at all. Based on that, producer may call IsEnabled(string, object, object) again with non-<see langword="null" /> context.</param>
  906. <param name="arg2">Optional. An object that represents the additional context for IsEnabled. <see langword="null" /> by default. Consumers should expect to receive <see langword="null" /> which may indicate that producer called pure IsEnabled(string) or producer passed all necessary context in <paramref name="arg1" />.</param>
  907. <returns>
  908. <see langword="true" /> if the notification event is enabled, <see langword="false" /> otherwise.</returns>
  909. </member>
  910. <member name="M:System.Diagnostics.DiagnosticSource.OnActivityExport(System.Diagnostics.Activity,System.Object)">
  911. <summary>Transfers state from an activity to some event or operation, such as an outgoing HTTP request, that will occur outside the process.</summary>
  912. <param name="activity">The activity affected by an external event.</param>
  913. <param name="payload">An object that represents the outgoing request.</param>
  914. </member>
  915. <member name="M:System.Diagnostics.DiagnosticSource.OnActivityImport(System.Diagnostics.Activity,System.Object)">
  916. <summary>Transfers state to an activity from some event or operation, such as an incoming request, that occurred outside the process.</summary>
  917. <param name="activity">The activity affected by an external event.</param>
  918. <param name="payload">A payload that represents the incoming request.</param>
  919. </member>
  920. <member name="M:System.Diagnostics.DiagnosticSource.StartActivity(System.Diagnostics.Activity,System.Object)">
  921. <summary>Starts an <see cref="T:System.Diagnostics.Activity" /> and writes a start event.</summary>
  922. <param name="activity">The <see cref="T:System.Diagnostics.Activity" /> to be started.</param>
  923. <param name="args">An object that represent the value being passed as a payload for the event.</param>
  924. <returns>The started activity for convenient chaining.</returns>
  925. </member>
  926. <member name="M:System.Diagnostics.DiagnosticSource.StopActivity(System.Diagnostics.Activity,System.Object)">
  927. <summary>Stops the given <see cref="T:System.Diagnostics.Activity" />, maintains the global <see cref="P:System.Diagnostics.Activity.Current" /> activity, and notifies consumers that the <see cref="T:System.Diagnostics.Activity" /> was stopped.</summary>
  928. <param name="activity">The activity to be stopped.</param>
  929. <param name="args">An object that represents the value passed as a payload for the event.</param>
  930. </member>
  931. <member name="M:System.Diagnostics.DiagnosticSource.Write(System.String,System.Object)">
  932. <summary>Provides a generic way of logging complex payloads.</summary>
  933. <param name="name">The name of the event being written.</param>
  934. <param name="value">An object that represents the value being passed as a payload for the event. This is often an anonymous type which contains several sub-values.</param>
  935. </member>
  936. <member name="T:System.Diagnostics.SampleActivity`1">
  937. <summary>A delegate that defines the signature of the <see cref="T:System.Diagnostics.ActivityListener" /> callbacks used in the sampling process.</summary>
  938. <param name="options">The Activity creation options used by <see cref="T:System.Diagnostics.ActivityListener" /> callbacks to decide creating the Activity object or not.</param>
  939. <typeparam name="T">The type of the requested parent to create the Activity object with. Should be either a string or an <see cref="T:System.Diagnostics.ActivityContext" /> instance.</typeparam>
  940. <returns>An object containing the sampling results, which indicate the amount of data to collect for the related <see cref="T:System.Diagnostics.Activity" />.</returns>
  941. </member>
  942. </members>
  943. </doc>