Grpc.Core.Status.html 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378
  1. <!DOCTYPE html>
  2. <!--[if IE]><![endif]-->
  3. <html>
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  7. <title>Struct Status
  8. | gRPC C# </title>
  9. <meta name="viewport" content="width=device-width">
  10. <meta name="title" content="Struct Status
  11. | gRPC C# ">
  12. <meta name="generator" content="docfx 2.36.0.0">
  13. <link rel="shortcut icon" href="../favicon.ico">
  14. <link rel="stylesheet" href="../styles/docfx.vendor.css">
  15. <link rel="stylesheet" href="../styles/docfx.css">
  16. <link rel="stylesheet" href="../styles/main.css">
  17. <meta property="docfx:navrel" content="../toc.html">
  18. <meta property="docfx:tocrel" content="toc.html">
  19. <meta property="docfx:rel" content="../">
  20. </head>
  21. <body data-spy="scroll" data-target="#affix" data-offset="120">
  22. <div id="wrapper">
  23. <header>
  24. <nav id="autocollapse" class="navbar navbar-inverse ng-scope" role="navigation">
  25. <div class="container">
  26. <div class="navbar-header">
  27. <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar">
  28. <span class="sr-only">Toggle navigation</span>
  29. <span class="icon-bar"></span>
  30. <span class="icon-bar"></span>
  31. <span class="icon-bar"></span>
  32. </button>
  33. <a class="navbar-brand" href="../index.html">
  34. <img id="logo" class="svg" src="../logo.svg" alt="">
  35. </a>
  36. </div>
  37. <div class="collapse navbar-collapse" id="navbar">
  38. <form class="navbar-form navbar-right" role="search" id="search">
  39. <div class="form-group">
  40. <input type="text" class="form-control" id="search-query" placeholder="Search" autocomplete="off">
  41. </div>
  42. </form>
  43. </div>
  44. </div>
  45. </nav>
  46. <div class="subnav navbar navbar-default">
  47. <div class="container hide-when-search" id="breadcrumb">
  48. <ul class="breadcrumb">
  49. <li></li>
  50. </ul>
  51. </div>
  52. </div>
  53. </header>
  54. <div class="container body-content">
  55. <div id="search-results">
  56. <div class="search-list"></div>
  57. <div class="sr-items">
  58. <p><i class="glyphicon glyphicon-refresh index-loading"></i></p>
  59. </div>
  60. <ul id="pagination"></ul>
  61. </div>
  62. </div>
  63. <div role="main" class="container body-content hide-when-search">
  64. <div class="sidenav hide-when-search">
  65. <a class="btn toc-toggle collapse" data-toggle="collapse" href="#sidetoggle" aria-expanded="false" aria-controls="sidetoggle">Show / Hide Table of Contents</a>
  66. <div class="sidetoggle collapse" id="sidetoggle">
  67. <div id="sidetoc"></div>
  68. </div>
  69. </div>
  70. <div class="article row grid-right">
  71. <div class="col-md-10">
  72. <article class="content wrap" id="_content" data-uid="Grpc.Core.Status">
  73. <h1 id="Grpc_Core_Status" data-uid="Grpc.Core.Status" class="text-break">Struct Status
  74. </h1>
  75. <div class="markdown level0 summary"><p>Represents RPC result, which consists of <a class="xref" href="Grpc.Core.Status.html#Grpc_Core_Status_StatusCode">StatusCode</a> and an optional detail string.</p>
  76. </div>
  77. <div class="markdown level0 conceptual"></div>
  78. <div class="inheritedMembers">
  79. <h5>Inherited Members</h5>
  80. <div>
  81. <span class="xref">System.ValueType.Equals(System.Object)</span>
  82. </div>
  83. <div>
  84. <span class="xref">System.ValueType.GetHashCode()</span>
  85. </div>
  86. <div>
  87. <span class="xref">System.Object.Equals(System.Object, System.Object)</span>
  88. </div>
  89. <div>
  90. <span class="xref">System.Object.GetType()</span>
  91. </div>
  92. <div>
  93. <span class="xref">System.Object.ReferenceEquals(System.Object, System.Object)</span>
  94. </div>
  95. </div>
  96. <h6><strong>Namespace</strong>: <a class="xref" href="Grpc.Core.html">Grpc.Core</a></h6>
  97. <h6><strong>Assembly</strong>: Grpc.Core.Api.dll</h6>
  98. <h5 id="Grpc_Core_Status_syntax">Syntax</h5>
  99. <div class="codewrapper">
  100. <pre><code class="lang-csharp hljs">public struct Status</code></pre>
  101. </div>
  102. <h3 id="constructors">Constructors
  103. </h3>
  104. <a id="Grpc_Core_Status__ctor_" data-uid="Grpc.Core.Status.#ctor*"></a>
  105. <h4 id="Grpc_Core_Status__ctor_Grpc_Core_StatusCode_System_String_" data-uid="Grpc.Core.Status.#ctor(Grpc.Core.StatusCode,System.String)">Status(StatusCode, String)</h4>
  106. <div class="markdown level1 summary"><p>Creates a new instance of <code>Status</code>.</p>
  107. </div>
  108. <div class="markdown level1 conceptual"></div>
  109. <h5 class="decalaration">Declaration</h5>
  110. <div class="codewrapper">
  111. <pre><code class="lang-csharp hljs">public Status(StatusCode statusCode, string detail)</code></pre>
  112. </div>
  113. <h5 class="parameters">Parameters</h5>
  114. <table class="table table-bordered table-striped table-condensed">
  115. <thead>
  116. <tr>
  117. <th>Type</th>
  118. <th>Name</th>
  119. <th>Description</th>
  120. </tr>
  121. </thead>
  122. <tbody>
  123. <tr>
  124. <td><a class="xref" href="Grpc.Core.StatusCode.html">StatusCode</a></td>
  125. <td><span class="parametername">statusCode</span></td>
  126. <td><p>Status code.</p>
  127. </td>
  128. </tr>
  129. <tr>
  130. <td><span class="xref">System.String</span></td>
  131. <td><span class="parametername">detail</span></td>
  132. <td><p>Detail.</p>
  133. </td>
  134. </tr>
  135. </tbody>
  136. </table>
  137. <a id="Grpc_Core_Status__ctor_" data-uid="Grpc.Core.Status.#ctor*"></a>
  138. <h4 id="Grpc_Core_Status__ctor_Grpc_Core_StatusCode_System_String_System_Exception_" data-uid="Grpc.Core.Status.#ctor(Grpc.Core.StatusCode,System.String,System.Exception)">Status(StatusCode, String, Exception)</h4>
  139. <div class="markdown level1 summary"><p>Creates a new instance of <code>Status</code>.
  140. Users should not use this constructor, except for creating instances for testing.
  141. The debug error string should only be populated by gRPC internals.
  142. Note: experimental API that can change or be removed without any prior notice.</p>
  143. </div>
  144. <div class="markdown level1 conceptual"></div>
  145. <h5 class="decalaration">Declaration</h5>
  146. <div class="codewrapper">
  147. <pre><code class="lang-csharp hljs">public Status(StatusCode statusCode, string detail, Exception debugException)</code></pre>
  148. </div>
  149. <h5 class="parameters">Parameters</h5>
  150. <table class="table table-bordered table-striped table-condensed">
  151. <thead>
  152. <tr>
  153. <th>Type</th>
  154. <th>Name</th>
  155. <th>Description</th>
  156. </tr>
  157. </thead>
  158. <tbody>
  159. <tr>
  160. <td><a class="xref" href="Grpc.Core.StatusCode.html">StatusCode</a></td>
  161. <td><span class="parametername">statusCode</span></td>
  162. <td><p>Status code.</p>
  163. </td>
  164. </tr>
  165. <tr>
  166. <td><span class="xref">System.String</span></td>
  167. <td><span class="parametername">detail</span></td>
  168. <td><p>Detail.</p>
  169. </td>
  170. </tr>
  171. <tr>
  172. <td><span class="xref">System.Exception</span></td>
  173. <td><span class="parametername">debugException</span></td>
  174. <td><p>Optional internal error details.</p>
  175. </td>
  176. </tr>
  177. </tbody>
  178. </table>
  179. <h3 id="fields">Fields
  180. </h3>
  181. <h4 id="Grpc_Core_Status_DefaultCancelled" data-uid="Grpc.Core.Status.DefaultCancelled">DefaultCancelled</h4>
  182. <div class="markdown level1 summary"><p>Default result of a cancelled RPC. StatusCode=Cancelled, empty details message.</p>
  183. </div>
  184. <div class="markdown level1 conceptual"></div>
  185. <h5 class="decalaration">Declaration</h5>
  186. <div class="codewrapper">
  187. <pre><code class="lang-csharp hljs">public static readonly Status DefaultCancelled</code></pre>
  188. </div>
  189. <h5 class="fieldValue">Field Value</h5>
  190. <table class="table table-bordered table-striped table-condensed">
  191. <thead>
  192. <tr>
  193. <th>Type</th>
  194. <th>Description</th>
  195. </tr>
  196. </thead>
  197. <tbody>
  198. <tr>
  199. <td><a class="xref" href="Grpc.Core.Status.html">Status</a></td>
  200. <td></td>
  201. </tr>
  202. </tbody>
  203. </table>
  204. <h4 id="Grpc_Core_Status_DefaultSuccess" data-uid="Grpc.Core.Status.DefaultSuccess">DefaultSuccess</h4>
  205. <div class="markdown level1 summary"><p>Default result of a successful RPC. StatusCode=OK, empty details message.</p>
  206. </div>
  207. <div class="markdown level1 conceptual"></div>
  208. <h5 class="decalaration">Declaration</h5>
  209. <div class="codewrapper">
  210. <pre><code class="lang-csharp hljs">public static readonly Status DefaultSuccess</code></pre>
  211. </div>
  212. <h5 class="fieldValue">Field Value</h5>
  213. <table class="table table-bordered table-striped table-condensed">
  214. <thead>
  215. <tr>
  216. <th>Type</th>
  217. <th>Description</th>
  218. </tr>
  219. </thead>
  220. <tbody>
  221. <tr>
  222. <td><a class="xref" href="Grpc.Core.Status.html">Status</a></td>
  223. <td></td>
  224. </tr>
  225. </tbody>
  226. </table>
  227. <h3 id="properties">Properties
  228. </h3>
  229. <a id="Grpc_Core_Status_DebugException_" data-uid="Grpc.Core.Status.DebugException*"></a>
  230. <h4 id="Grpc_Core_Status_DebugException" data-uid="Grpc.Core.Status.DebugException">DebugException</h4>
  231. <div class="markdown level1 summary"><p>In case of an error, this field may contain additional error details to help with debugging.
  232. This field will be only populated on a client and its value is generated locally,
  233. based on the internal state of the gRPC client stack (i.e. the value is never sent over the wire).
  234. Note that this field is available only for debugging purposes, the application logic should
  235. never rely on values of this field (it should use <code>StatusCode</code> and <code>Detail</code> instead).
  236. Example: when a client fails to connect to a server, this field may provide additional details
  237. why the connection to the server has failed.
  238. Note: experimental API that can change or be removed without any prior notice.</p>
  239. </div>
  240. <div class="markdown level1 conceptual"></div>
  241. <h5 class="decalaration">Declaration</h5>
  242. <div class="codewrapper">
  243. <pre><code class="lang-csharp hljs">public Exception DebugException { get; }</code></pre>
  244. </div>
  245. <h5 class="propertyValue">Property Value</h5>
  246. <table class="table table-bordered table-striped table-condensed">
  247. <thead>
  248. <tr>
  249. <th>Type</th>
  250. <th>Description</th>
  251. </tr>
  252. </thead>
  253. <tbody>
  254. <tr>
  255. <td><span class="xref">System.Exception</span></td>
  256. <td></td>
  257. </tr>
  258. </tbody>
  259. </table>
  260. <a id="Grpc_Core_Status_Detail_" data-uid="Grpc.Core.Status.Detail*"></a>
  261. <h4 id="Grpc_Core_Status_Detail" data-uid="Grpc.Core.Status.Detail">Detail</h4>
  262. <div class="markdown level1 summary"><p>Gets the detail.</p>
  263. </div>
  264. <div class="markdown level1 conceptual"></div>
  265. <h5 class="decalaration">Declaration</h5>
  266. <div class="codewrapper">
  267. <pre><code class="lang-csharp hljs">public string Detail { get; }</code></pre>
  268. </div>
  269. <h5 class="propertyValue">Property Value</h5>
  270. <table class="table table-bordered table-striped table-condensed">
  271. <thead>
  272. <tr>
  273. <th>Type</th>
  274. <th>Description</th>
  275. </tr>
  276. </thead>
  277. <tbody>
  278. <tr>
  279. <td><span class="xref">System.String</span></td>
  280. <td></td>
  281. </tr>
  282. </tbody>
  283. </table>
  284. <a id="Grpc_Core_Status_StatusCode_" data-uid="Grpc.Core.Status.StatusCode*"></a>
  285. <h4 id="Grpc_Core_Status_StatusCode" data-uid="Grpc.Core.Status.StatusCode">StatusCode</h4>
  286. <div class="markdown level1 summary"><p>Gets the gRPC status code. OK indicates success, all other values indicate an error.</p>
  287. </div>
  288. <div class="markdown level1 conceptual"></div>
  289. <h5 class="decalaration">Declaration</h5>
  290. <div class="codewrapper">
  291. <pre><code class="lang-csharp hljs">public StatusCode StatusCode { get; }</code></pre>
  292. </div>
  293. <h5 class="propertyValue">Property Value</h5>
  294. <table class="table table-bordered table-striped table-condensed">
  295. <thead>
  296. <tr>
  297. <th>Type</th>
  298. <th>Description</th>
  299. </tr>
  300. </thead>
  301. <tbody>
  302. <tr>
  303. <td><a class="xref" href="Grpc.Core.StatusCode.html">StatusCode</a></td>
  304. <td></td>
  305. </tr>
  306. </tbody>
  307. </table>
  308. <h3 id="methods">Methods
  309. </h3>
  310. <a id="Grpc_Core_Status_ToString_" data-uid="Grpc.Core.Status.ToString*"></a>
  311. <h4 id="Grpc_Core_Status_ToString" data-uid="Grpc.Core.Status.ToString">ToString()</h4>
  312. <div class="markdown level1 summary"><p>Returns a <span class="xref">System.String</span> that represents the current <a class="xref" href="Grpc.Core.Status.html">Status</a>.</p>
  313. </div>
  314. <div class="markdown level1 conceptual"></div>
  315. <h5 class="decalaration">Declaration</h5>
  316. <div class="codewrapper">
  317. <pre><code class="lang-csharp hljs">public override string ToString()</code></pre>
  318. </div>
  319. <h5 class="returns">Returns</h5>
  320. <table class="table table-bordered table-striped table-condensed">
  321. <thead>
  322. <tr>
  323. <th>Type</th>
  324. <th>Description</th>
  325. </tr>
  326. </thead>
  327. <tbody>
  328. <tr>
  329. <td><span class="xref">System.String</span></td>
  330. <td></td>
  331. </tr>
  332. </tbody>
  333. </table>
  334. <h5 class="overrides">Overrides</h5>
  335. <div><span class="xref">System.ValueType.ToString()</span></div>
  336. </article>
  337. </div>
  338. <div class="hidden-sm col-md-2" role="complementary">
  339. <div class="sideaffix">
  340. <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
  341. <!-- <p><a class="back-to-top" href="#top">Back to top</a><p> -->
  342. </nav>
  343. </div>
  344. </div>
  345. </div>
  346. </div>
  347. <footer>
  348. <div class="grad-bottom"></div>
  349. <div class="footer">
  350. <div class="container">
  351. <span class="pull-right">
  352. <a href="#top">Back to top</a>
  353. </span>
  354. <span>Generated by <strong>DocFX</strong></span>
  355. </div>
  356. </div>
  357. </footer>
  358. </div>
  359. <script type="text/javascript" src="../styles/docfx.vendor.js"></script>
  360. <script type="text/javascript" src="../styles/docfx.js"></script>
  361. <script type="text/javascript" src="../styles/main.js"></script>
  362. </body>
  363. </html>