NamedPipeClientStream.xml 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <Type Name="NamedPipeClientStream" FullName="System.IO.Pipes.NamedPipeClientStream">
  3. <TypeSignature Language="C#" Value="public sealed class NamedPipeClientStream : System.IO.Pipes.PipeStream" />
  4. <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit NamedPipeClientStream extends System.IO.Pipes.PipeStream" />
  5. <AssemblyInfo>
  6. <AssemblyName>System.Core</AssemblyName>
  7. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  8. </AssemblyInfo>
  9. <Base>
  10. <BaseTypeName>System.IO.Pipes.PipeStream</BaseTypeName>
  11. </Base>
  12. <Interfaces />
  13. <Attributes>
  14. <Attribute>
  15. <AttributeName>System.MonoTODO("working only on win32 right now")</AttributeName>
  16. </Attribute>
  17. </Attributes>
  18. <Docs>
  19. <remarks>
  20. <attribution license="cc4" from="Microsoft" modified="false" />
  21. <para>Named pipes provide one-way or duplex pipes for communication between a pipe server and one or more pipe clients. Named pipes can be used for interprocess communication locally or over a network. A single pipe name can be shared by multiple <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> objects.</para>
  22. <para>Any process can act as either a named pipe server or client, or both. </para>
  23. <block subset="none" type="note">
  24. <para>For winxppro and win2kserver, a maximum of 10 pipes can simultaneously connect over the network.</para>
  25. </block>
  26. </remarks>
  27. <summary>
  28. <attribution license="cc4" from="Microsoft" modified="false" />
  29. <para>Exposes a <see cref="T:System.IO.Stream" /> around a named pipe, which supports both synchronous and asynchronous read and write operations.</para>
  30. </summary>
  31. </Docs>
  32. <Members>
  33. <Member MemberName=".ctor">
  34. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string pipeName);" />
  35. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string pipeName) cil managed" />
  36. <MemberType>Constructor</MemberType>
  37. <AssemblyInfo>
  38. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  39. </AssemblyInfo>
  40. <Parameters>
  41. <Parameter Name="pipeName" Type="System.String" />
  42. </Parameters>
  43. <Docs>
  44. <remarks>
  45. <attribution license="cc4" from="Microsoft" modified="false" />
  46. <para>This constructor uses the following default values:</para>
  47. <list type="bullet">
  48. <item>
  49. <para>A default server name of ".". </para>
  50. </item>
  51. <item>
  52. <para>A default <see cref="T:System.IO.Pipes.PipeDirection" /> value of <see cref="F:System.IO.Pipes.PipeDirection.InOut" />. </para>
  53. </item>
  54. <item>
  55. <para>A default <see cref="T:System.IO.Pipes.PipeOptions" /> value of <see cref="F:System.IO.Pipes.PipeOptions.None" />. </para>
  56. </item>
  57. <item>
  58. <para>A default <see cref="T:System.Security.Principal.TokenImpersonationLevel" /> value of <see cref="F:System.Security.Principal.TokenImpersonationLevel.None" />. </para>
  59. </item>
  60. <item>
  61. <para>A default <see cref="T:System.IO.HandleInheritability" /> value of <see cref="F:System.IO.HandleInheritability.None" />.</para>
  62. </item>
  63. </list>
  64. </remarks>
  65. <summary>
  66. <attribution license="cc4" from="Microsoft" modified="false" />
  67. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe name.</para>
  68. </summary>
  69. <param name="pipeName">
  70. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  71. </Docs>
  72. </Member>
  73. <Member MemberName=".ctor">
  74. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName);" />
  75. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName) cil managed" />
  76. <MemberType>Constructor</MemberType>
  77. <AssemblyInfo>
  78. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  79. </AssemblyInfo>
  80. <Parameters>
  81. <Parameter Name="serverName" Type="System.String" />
  82. <Parameter Name="pipeName" Type="System.String" />
  83. </Parameters>
  84. <Docs>
  85. <remarks>
  86. <attribution license="cc4" from="Microsoft" modified="false" />
  87. <para>This constructor uses the following default values:</para>
  88. <list type="bullet">
  89. <item>
  90. <para>A default <see cref="T:System.IO.Pipes.PipeDirection" /> value of <see cref="F:System.IO.Pipes.PipeDirection.InOut" />. </para>
  91. </item>
  92. <item>
  93. <para>A default <see cref="T:System.IO.Pipes.PipeOptions" /> value of <see cref="F:System.IO.Pipes.PipeOptions.None" />. </para>
  94. </item>
  95. <item>
  96. <para>A default <see cref="T:System.Security.Principal.TokenImpersonationLevel" /> value of <see cref="F:System.Security.Principal.TokenImpersonationLevel.None" />. </para>
  97. </item>
  98. <item>
  99. <para>A default <see cref="T:System.IO.HandleInheritability" /> value of <see cref="F:System.IO.HandleInheritability.None" />.</para>
  100. </item>
  101. </list>
  102. </remarks>
  103. <summary>
  104. <attribution license="cc4" from="Microsoft" modified="false" />
  105. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names.</para>
  106. </summary>
  107. <param name="serverName">
  108. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  109. <param name="pipeName">
  110. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  111. </Docs>
  112. </Member>
  113. <Member MemberName=".ctor">
  114. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction);" />
  115. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName, valuetype System.IO.Pipes.PipeDirection direction) cil managed" />
  116. <MemberType>Constructor</MemberType>
  117. <AssemblyInfo>
  118. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  119. </AssemblyInfo>
  120. <Parameters>
  121. <Parameter Name="serverName" Type="System.String" />
  122. <Parameter Name="pipeName" Type="System.String" />
  123. <Parameter Name="direction" Type="System.IO.Pipes.PipeDirection" />
  124. </Parameters>
  125. <Docs>
  126. <remarks>
  127. <attribution license="cc4" from="Microsoft" modified="false" />
  128. <para>This constructor uses the following default values:</para>
  129. <list type="bullet">
  130. <item>
  131. <para>A default <see cref="T:System.IO.Pipes.PipeOptions" /> value of <see cref="F:System.IO.Pipes.PipeOptions.None" />. </para>
  132. </item>
  133. <item>
  134. <para>A default <see cref="T:System.Security.Principal.TokenImpersonationLevel" /> value of <see cref="F:System.Security.Principal.TokenImpersonationLevel.None" />. </para>
  135. </item>
  136. <item>
  137. <para>A default <see cref="T:System.IO.HandleInheritability" /> value of <see cref="F:System.IO.HandleInheritability.None" />.</para>
  138. </item>
  139. </list>
  140. </remarks>
  141. <summary>
  142. <attribution license="cc4" from="Microsoft" modified="false" />
  143. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names, and the specified pipe direction.</para>
  144. </summary>
  145. <param name="serverName">
  146. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  147. <param name="pipeName">
  148. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  149. <param name="direction">
  150. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the direction of the pipe.</param>
  151. </Docs>
  152. </Member>
  153. <Member MemberName=".ctor">
  154. <MemberSignature Language="C#" Value="public NamedPipeClientStream (System.IO.Pipes.PipeDirection direction, bool isAsync, bool isConnected, Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle);" />
  155. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(valuetype System.IO.Pipes.PipeDirection direction, bool isAsync, bool isConnected, class Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle) cil managed" />
  156. <MemberType>Constructor</MemberType>
  157. <AssemblyInfo>
  158. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  159. </AssemblyInfo>
  160. <Parameters>
  161. <Parameter Name="direction" Type="System.IO.Pipes.PipeDirection" />
  162. <Parameter Name="isAsync" Type="System.Boolean" />
  163. <Parameter Name="isConnected" Type="System.Boolean" />
  164. <Parameter Name="safePipeHandle" Type="Microsoft.Win32.SafeHandles.SafePipeHandle" />
  165. </Parameters>
  166. <Docs>
  167. <remarks>To be added.</remarks>
  168. <summary>
  169. <attribution license="cc4" from="Microsoft" modified="false" />
  170. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class for the specified pipe handle with the specified pipe direction.</para>
  171. </summary>
  172. <param name="direction">
  173. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the direction of the pipe.</param>
  174. <param name="isAsync">
  175. <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that the handle was opened asynchronously; otherwise, false.</param>
  176. <param name="isConnected">
  177. <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that the pipe is connected; otherwise, false.</param>
  178. <param name="safePipeHandle">
  179. <attribution license="cc4" from="Microsoft" modified="false" />A safe handle for the pipe that this <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> object will encapsulate.</param>
  180. </Docs>
  181. </Member>
  182. <Member MemberName=".ctor">
  183. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options);" />
  184. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName, valuetype System.IO.Pipes.PipeDirection direction, valuetype System.IO.Pipes.PipeOptions options) cil managed" />
  185. <MemberType>Constructor</MemberType>
  186. <AssemblyInfo>
  187. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  188. </AssemblyInfo>
  189. <Parameters>
  190. <Parameter Name="serverName" Type="System.String" />
  191. <Parameter Name="pipeName" Type="System.String" />
  192. <Parameter Name="direction" Type="System.IO.Pipes.PipeDirection" />
  193. <Parameter Name="options" Type="System.IO.Pipes.PipeOptions" />
  194. </Parameters>
  195. <Docs>
  196. <remarks>
  197. <attribution license="cc4" from="Microsoft" modified="false" />
  198. <para>This constructor uses the following default values:</para>
  199. <list type="bullet">
  200. <item>
  201. <para>A default <see cref="T:System.Security.Principal.TokenImpersonationLevel" /> value of <see cref="F:System.Security.Principal.TokenImpersonationLevel.None" />. </para>
  202. </item>
  203. <item>
  204. <para>A default <see cref="T:System.IO.HandleInheritability" /> value of <see cref="F:System.IO.HandleInheritability.None" />.</para>
  205. </item>
  206. </list>
  207. </remarks>
  208. <summary>
  209. <attribution license="cc4" from="Microsoft" modified="false" />
  210. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names, and the specified pipe direction and pipe options.</para>
  211. </summary>
  212. <param name="serverName">
  213. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  214. <param name="pipeName">
  215. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  216. <param name="direction">
  217. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the direction of the pipe.</param>
  218. <param name="options">
  219. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines how to open or create the pipe.</param>
  220. </Docs>
  221. </Member>
  222. <Member MemberName=".ctor">
  223. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel);" />
  224. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName, valuetype System.IO.Pipes.PipeDirection direction, valuetype System.IO.Pipes.PipeOptions options, valuetype System.Security.Principal.TokenImpersonationLevel impersonationLevel) cil managed" />
  225. <MemberType>Constructor</MemberType>
  226. <AssemblyInfo>
  227. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  228. </AssemblyInfo>
  229. <Parameters>
  230. <Parameter Name="serverName" Type="System.String" />
  231. <Parameter Name="pipeName" Type="System.String" />
  232. <Parameter Name="direction" Type="System.IO.Pipes.PipeDirection" />
  233. <Parameter Name="options" Type="System.IO.Pipes.PipeOptions" />
  234. <Parameter Name="impersonationLevel" Type="System.Security.Principal.TokenImpersonationLevel" />
  235. </Parameters>
  236. <Docs>
  237. <remarks>
  238. <attribution license="cc4" from="Microsoft" modified="false" />
  239. <para>This constructor uses a default <see cref="T:System.IO.HandleInheritability" /> value of <see cref="F:System.IO.HandleInheritability.None" />.</para>
  240. </remarks>
  241. <summary>
  242. <attribution license="cc4" from="Microsoft" modified="false" />
  243. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names, and the specified pipe direction, pipe options, and security impersonation level.</para>
  244. </summary>
  245. <param name="serverName">
  246. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  247. <param name="pipeName">
  248. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  249. <param name="direction">
  250. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the direction of the pipe.</param>
  251. <param name="options">
  252. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines how to open or create the pipe.</param>
  253. <param name="impersonationLevel">
  254. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the security impersonation level.</param>
  255. </Docs>
  256. </Member>
  257. <Member MemberName=".ctor">
  258. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeAccessRights desiredAccessRights, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel, System.IO.HandleInheritability inheritability);" />
  259. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName, valuetype System.IO.Pipes.PipeAccessRights desiredAccessRights, valuetype System.IO.Pipes.PipeOptions options, valuetype System.Security.Principal.TokenImpersonationLevel impersonationLevel, valuetype System.IO.HandleInheritability inheritability) cil managed" />
  260. <MemberType>Constructor</MemberType>
  261. <AssemblyInfo>
  262. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  263. </AssemblyInfo>
  264. <Parameters>
  265. <Parameter Name="serverName" Type="System.String" />
  266. <Parameter Name="pipeName" Type="System.String" />
  267. <Parameter Name="desiredAccessRights" Type="System.IO.Pipes.PipeAccessRights" />
  268. <Parameter Name="options" Type="System.IO.Pipes.PipeOptions" />
  269. <Parameter Name="impersonationLevel" Type="System.Security.Principal.TokenImpersonationLevel" />
  270. <Parameter Name="inheritability" Type="System.IO.HandleInheritability" />
  271. </Parameters>
  272. <Docs>
  273. <remarks>
  274. <attribution license="cc4" from="Microsoft" modified="false" />
  275. <para>The pipe direction for this constructor is determined by the <paramref name="desiredAccessRights" /> parameter. If the <paramref name="desiredAccessRights" /> value is <see cref="F:System.IO.Pipes.PipeAccessRights.ReadData" />, the pipe direction will be <see cref="F:System.IO.Pipes.PipeDirection.In" />. If the value of <paramref name="desiredAccessRights" /> is <see cref="F:System.IO.Pipes.PipeAccessRights.WriteData" />, the pipe direction will be <see cref="F:System.IO.Pipes.PipeDirection.Out" />. If the value of <paramref name="desiredAccessRights" /> includes both <see cref="F:System.IO.Pipes.PipeAccessRights.ReadData" /> and <see cref="F:System.IO.Pipes.PipeAccessRights.WriteData" />, the pipe direction will be <see cref="F:System.IO.Pipes.PipeDirection.InOut" />.</para>
  276. </remarks>
  277. <summary>
  278. <attribution license="cc4" from="Microsoft" modified="false" />
  279. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names, and the specified pipe options, security impersonation level, and inheritability mode.</para>
  280. </summary>
  281. <param name="serverName">
  282. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  283. <param name="pipeName">
  284. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  285. <param name="desiredAccessRights">
  286. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that specifies the desired access rights of the pipe.</param>
  287. <param name="options">
  288. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines how to open or create the pipe.</param>
  289. <param name="impersonationLevel">
  290. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the security impersonation level.</param>
  291. <param name="inheritability">
  292. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines whether the underlying handle will be inheritable by child processes.</param>
  293. </Docs>
  294. </Member>
  295. <Member MemberName=".ctor">
  296. <MemberSignature Language="C#" Value="public NamedPipeClientStream (string serverName, string pipeName, System.IO.Pipes.PipeDirection direction, System.IO.Pipes.PipeOptions options, System.Security.Principal.TokenImpersonationLevel impersonationLevel, System.IO.HandleInheritability inheritability);" />
  297. <MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(string serverName, string pipeName, valuetype System.IO.Pipes.PipeDirection direction, valuetype System.IO.Pipes.PipeOptions options, valuetype System.Security.Principal.TokenImpersonationLevel impersonationLevel, valuetype System.IO.HandleInheritability inheritability) cil managed" />
  298. <MemberType>Constructor</MemberType>
  299. <AssemblyInfo>
  300. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  301. </AssemblyInfo>
  302. <Parameters>
  303. <Parameter Name="serverName" Type="System.String" />
  304. <Parameter Name="pipeName" Type="System.String" />
  305. <Parameter Name="direction" Type="System.IO.Pipes.PipeDirection" />
  306. <Parameter Name="options" Type="System.IO.Pipes.PipeOptions" />
  307. <Parameter Name="impersonationLevel" Type="System.Security.Principal.TokenImpersonationLevel" />
  308. <Parameter Name="inheritability" Type="System.IO.HandleInheritability" />
  309. </Parameters>
  310. <Docs>
  311. <remarks>To be added.</remarks>
  312. <summary>
  313. <attribution license="cc4" from="Microsoft" modified="false" />
  314. <para>Initializes a new instance of the <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> class with the specified pipe and server names, and the specified pipe direction, pipe options, security impersonation level, and inheritability mode.</para>
  315. </summary>
  316. <param name="serverName">
  317. <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote computer to connect to, or "." to specify the local computer.</param>
  318. <param name="pipeName">
  319. <attribution license="cc4" from="Microsoft" modified="false" />The name of the pipe.</param>
  320. <param name="direction">
  321. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the direction of the pipe.</param>
  322. <param name="options">
  323. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines how to open or create the pipe.</param>
  324. <param name="impersonationLevel">
  325. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines the security impersonation level.</param>
  326. <param name="inheritability">
  327. <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that determines whether the underlying handle will be inheritable by child processes.</param>
  328. </Docs>
  329. </Member>
  330. <Member MemberName="Connect">
  331. <MemberSignature Language="C#" Value="public void Connect ();" />
  332. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Connect() cil managed" />
  333. <MemberType>Method</MemberType>
  334. <AssemblyInfo>
  335. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  336. </AssemblyInfo>
  337. <ReturnValue>
  338. <ReturnType>System.Void</ReturnType>
  339. </ReturnValue>
  340. <Parameters />
  341. <Docs>
  342. <remarks>
  343. <attribution license="cc4" from="Microsoft" modified="false" />
  344. <para>This method calls the <see cref="M:System.IO.Pipes.NamedPipeClientStream.Connect(System.Int32)" /> method with an infinite time-out value.</para>
  345. <para>This method waits for a pipe instance to become available. <see cref="Overload:System.IO.Pipes.NamedPipeClientStream.Connect" /> might return before <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" /> is called from the <see cref="T:System.IO.Pipes.NamedPipeServerStream" /> object, but <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" /> will not return until <see cref="Overload:System.IO.Pipes.NamedPipeClientStream.Connect" /> has returned.</para>
  346. <para>Any data written to the pipe after a <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> object has connected, but before the server has called <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" />, will be available to the server following the call to <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" />.</para>
  347. </remarks>
  348. <summary>
  349. <attribution license="cc4" from="Microsoft" modified="false" />
  350. <para>Connects to a waiting server with an infinite time-out value.</para>
  351. </summary>
  352. </Docs>
  353. </Member>
  354. <Member MemberName="Connect">
  355. <MemberSignature Language="C#" Value="public void Connect (int timeout);" />
  356. <MemberSignature Language="ILAsm" Value=".method public hidebysig instance void Connect(int32 timeout) cil managed" />
  357. <MemberType>Method</MemberType>
  358. <AssemblyInfo>
  359. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  360. </AssemblyInfo>
  361. <ReturnValue>
  362. <ReturnType>System.Void</ReturnType>
  363. </ReturnValue>
  364. <Parameters>
  365. <Parameter Name="timeout" Type="System.Int32" />
  366. </Parameters>
  367. <Docs>
  368. <remarks>
  369. <attribution license="cc4" from="Microsoft" modified="false" />
  370. <para>This method waits for a pipe instance to become available. <see cref="Overload:System.IO.Pipes.NamedPipeClientStream.Connect" /> might return before <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" /> is called from the <see cref="T:System.IO.Pipes.NamedPipeServerStream" />, but <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" /> will not return until <see cref="Overload:System.IO.Pipes.NamedPipeClientStream.Connect" /> has returned. You set the <paramref name="timeout" /> parameter to <see cref="F:System.Threading.Timeout.Infinite" /> to specify an infinite time-out value.</para>
  371. <para>Any data written to the pipe after a <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> object has connected, but before the server has called <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" />, will be available to the server following the call to <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" />.</para>
  372. </remarks>
  373. <summary>
  374. <attribution license="cc4" from="Microsoft" modified="false" />
  375. <para>Connects to a waiting server within the specified time-out period.</para>
  376. </summary>
  377. <param name="timeout">
  378. <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait for the server to respond before the connection times out.</param>
  379. </Docs>
  380. </Member>
  381. <Member MemberName="NumberOfServerInstances">
  382. <MemberSignature Language="C#" Value="public int NumberOfServerInstances { get; }" />
  383. <MemberSignature Language="ILAsm" Value=".property instance int32 NumberOfServerInstances" />
  384. <MemberType>Property</MemberType>
  385. <AssemblyInfo>
  386. <AssemblyVersion>4.0.0.0</AssemblyVersion>
  387. </AssemblyInfo>
  388. <ReturnValue>
  389. <ReturnType>System.Int32</ReturnType>
  390. </ReturnValue>
  391. <Docs>
  392. <value>To be added.</value>
  393. <remarks>
  394. <attribution license="cc4" from="Microsoft" modified="false" />
  395. <para>This property returns the number of server instances for the <see cref="T:System.IO.Pipes.NamedPipeServerStream" /> object that the current <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> object has a handle to or is connected to. If the current <see cref="T:System.IO.Pipes.NamedPipeClientStream" /> object has not yet connected to a named pipe server, or if the current pipe handle has not yet been set, this property throws an <see cref="T:System.InvalidOperationException" />.</para>
  396. </remarks>
  397. <summary>
  398. <attribution license="cc4" from="Microsoft" modified="false" />
  399. <para>Gets the number of server instances that share the same pipe name.</para>
  400. </summary>
  401. </Docs>
  402. </Member>
  403. </Members>
  404. </Type>