Grpc.Core.SerializationContext.html 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251
  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>Class SerializationContext
  8. | gRPC C# </title>
  9. <meta name="viewport" content="width=device-width">
  10. <meta name="title" content="Class SerializationContext
  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.SerializationContext">
  73. <h1 id="Grpc_Core_SerializationContext" data-uid="Grpc.Core.SerializationContext" class="text-break">Class SerializationContext
  74. </h1>
  75. <div class="markdown level0 summary"><p>Provides storage for payload when serializing a message.</p>
  76. </div>
  77. <div class="markdown level0 conceptual"></div>
  78. <div class="inheritance">
  79. <h5>Inheritance</h5>
  80. <div class="level0"><span class="xref">System.Object</span></div>
  81. <div class="level1"><span class="xref">SerializationContext</span></div>
  82. </div>
  83. <div class="inheritedMembers">
  84. <h5>Inherited Members</h5>
  85. <div>
  86. <span class="xref">System.Object.Equals(System.Object)</span>
  87. </div>
  88. <div>
  89. <span class="xref">System.Object.Equals(System.Object, System.Object)</span>
  90. </div>
  91. <div>
  92. <span class="xref">System.Object.GetHashCode()</span>
  93. </div>
  94. <div>
  95. <span class="xref">System.Object.GetType()</span>
  96. </div>
  97. <div>
  98. <span class="xref">System.Object.MemberwiseClone()</span>
  99. </div>
  100. <div>
  101. <span class="xref">System.Object.ReferenceEquals(System.Object, System.Object)</span>
  102. </div>
  103. <div>
  104. <span class="xref">System.Object.ToString()</span>
  105. </div>
  106. </div>
  107. <h6><strong>Namespace</strong>: <a class="xref" href="Grpc.Core.html">Grpc.Core</a></h6>
  108. <h6><strong>Assembly</strong>: Grpc.Core.Api.dll</h6>
  109. <h5 id="Grpc_Core_SerializationContext_syntax">Syntax</h5>
  110. <div class="codewrapper">
  111. <pre><code class="lang-csharp hljs">public abstract class SerializationContext</code></pre>
  112. </div>
  113. <h3 id="methods">Methods
  114. </h3>
  115. <a id="Grpc_Core_SerializationContext_Complete_" data-uid="Grpc.Core.SerializationContext.Complete*"></a>
  116. <h4 id="Grpc_Core_SerializationContext_Complete" data-uid="Grpc.Core.SerializationContext.Complete">Complete()</h4>
  117. <div class="markdown level1 summary"><p>Complete the payload written to the buffer writer. <code>Complete()</code> can only be called once.</p>
  118. </div>
  119. <div class="markdown level1 conceptual"></div>
  120. <h5 class="decalaration">Declaration</h5>
  121. <div class="codewrapper">
  122. <pre><code class="lang-csharp hljs">public virtual void Complete()</code></pre>
  123. </div>
  124. <a id="Grpc_Core_SerializationContext_Complete_" data-uid="Grpc.Core.SerializationContext.Complete*"></a>
  125. <h4 id="Grpc_Core_SerializationContext_Complete_System_Byte___" data-uid="Grpc.Core.SerializationContext.Complete(System.Byte[])">Complete(Byte[])</h4>
  126. <div class="markdown level1 summary"><p>Use the byte array as serialized form of current message and mark serialization process as complete.
  127. <code>Complete(byte[])</code> can only be called once. By calling this method the caller gives up the ownership of the
  128. payload which must not be accessed afterwards.</p>
  129. </div>
  130. <div class="markdown level1 conceptual"></div>
  131. <h5 class="decalaration">Declaration</h5>
  132. <div class="codewrapper">
  133. <pre><code class="lang-csharp hljs">public virtual void Complete(byte[] payload)</code></pre>
  134. </div>
  135. <h5 class="parameters">Parameters</h5>
  136. <table class="table table-bordered table-striped table-condensed">
  137. <thead>
  138. <tr>
  139. <th>Type</th>
  140. <th>Name</th>
  141. <th>Description</th>
  142. </tr>
  143. </thead>
  144. <tbody>
  145. <tr>
  146. <td><span class="xref">System.Byte</span>[]</td>
  147. <td><span class="parametername">payload</span></td>
  148. <td><p>the serialized form of current message</p>
  149. </td>
  150. </tr>
  151. </tbody>
  152. </table>
  153. <a id="Grpc_Core_SerializationContext_GetBufferWriter_" data-uid="Grpc.Core.SerializationContext.GetBufferWriter*"></a>
  154. <h4 id="Grpc_Core_SerializationContext_GetBufferWriter" data-uid="Grpc.Core.SerializationContext.GetBufferWriter">GetBufferWriter()</h4>
  155. <div class="markdown level1 summary"><p>Gets buffer writer that can be used to write the serialized data. Once serialization is finished,
  156. <code>Complete()</code> needs to be called.</p>
  157. </div>
  158. <div class="markdown level1 conceptual"></div>
  159. <h5 class="decalaration">Declaration</h5>
  160. <div class="codewrapper">
  161. <pre><code class="lang-csharp hljs">public virtual IBufferWriter&lt;byte&gt; GetBufferWriter()</code></pre>
  162. </div>
  163. <h5 class="returns">Returns</h5>
  164. <table class="table table-bordered table-striped table-condensed">
  165. <thead>
  166. <tr>
  167. <th>Type</th>
  168. <th>Description</th>
  169. </tr>
  170. </thead>
  171. <tbody>
  172. <tr>
  173. <td><span class="xref">IBufferWriter</span>&lt;<span class="xref">System.Byte</span>&gt;</td>
  174. <td></td>
  175. </tr>
  176. </tbody>
  177. </table>
  178. <a id="Grpc_Core_SerializationContext_SetPayloadLength_" data-uid="Grpc.Core.SerializationContext.SetPayloadLength*"></a>
  179. <h4 id="Grpc_Core_SerializationContext_SetPayloadLength_System_Int32_" data-uid="Grpc.Core.SerializationContext.SetPayloadLength(System.Int32)">SetPayloadLength(Int32)</h4>
  180. <div class="markdown level1 summary"><p>Sets the payload length when writing serialized data into a buffer writer. If the serializer knows the full payload
  181. length in advance, providing that information before obtaining the buffer writer using <code>GetBufferWriter()</code> can improve
  182. serialization efficiency by avoiding copies. The provided payload length must be the same as the data written to the writer.
  183. Calling this method is optional. If the payload length is not set then the length is calculated using the data written to
  184. the buffer writer when <code>Complete()</code> is called.</p>
  185. </div>
  186. <div class="markdown level1 conceptual"></div>
  187. <h5 class="decalaration">Declaration</h5>
  188. <div class="codewrapper">
  189. <pre><code class="lang-csharp hljs">public virtual void SetPayloadLength(int payloadLength)</code></pre>
  190. </div>
  191. <h5 class="parameters">Parameters</h5>
  192. <table class="table table-bordered table-striped table-condensed">
  193. <thead>
  194. <tr>
  195. <th>Type</th>
  196. <th>Name</th>
  197. <th>Description</th>
  198. </tr>
  199. </thead>
  200. <tbody>
  201. <tr>
  202. <td><span class="xref">System.Int32</span></td>
  203. <td><span class="parametername">payloadLength</span></td>
  204. <td><p>The total length of the payload in bytes.</p>
  205. </td>
  206. </tr>
  207. </tbody>
  208. </table>
  209. </article>
  210. </div>
  211. <div class="hidden-sm col-md-2" role="complementary">
  212. <div class="sideaffix">
  213. <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
  214. <!-- <p><a class="back-to-top" href="#top">Back to top</a><p> -->
  215. </nav>
  216. </div>
  217. </div>
  218. </div>
  219. </div>
  220. <footer>
  221. <div class="grad-bottom"></div>
  222. <div class="footer">
  223. <div class="container">
  224. <span class="pull-right">
  225. <a href="#top">Back to top</a>
  226. </span>
  227. <span>Generated by <strong>DocFX</strong></span>
  228. </div>
  229. </div>
  230. </footer>
  231. </div>
  232. <script type="text/javascript" src="../styles/docfx.vendor.js"></script>
  233. <script type="text/javascript" src="../styles/docfx.js"></script>
  234. <script type="text/javascript" src="../styles/main.js"></script>
  235. </body>
  236. </html>