NamedPipeClientStream 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
暴露命名管道周围的 Stream，该管道既支持同步读写操作，也支持异步读写操作。
public ref class NamedPipeClientStream sealed : System::IO::Pipes::PipeStreampublic sealed class NamedPipeClientStream : System.IO.Pipes.PipeStreamtype NamedPipeClientStream = class
inherit PipeStreamPublic NotInheritable Class NamedPipeClientStream
Inherits PipeStream- 继承
- 继承
示例
以下示例演示了一种使用命名管道将字符串从父进程发送到同一计算机上的子进程的方法。 此示例在 NamedPipeServerStream 父进程中创建对象。 对象的NamedPipeServerStreamPipeDirection值为 Out。然后，服务器等待NamedPipeClientStream子进程中的对象连接到该对象。 在此示例中，这两个进程位于同一PipeDirection台计算机上，NamedPipeClientStream并且 对象的值为 In。 接下来，父进程将用户提供的字符串发送给子进程。 字符串显示在控制台中。
此示例适用于连接到服务器进程的客户端进程。 有关整个代码示例（包括管道客户端和服务器的代码），请参阅 如何：使用命名管道进行网络进程间通信。
using System;
using System.IO;
using System.IO.Pipes;
class PipeClient
{
static void Main(string[] args)
{
using (NamedPipeClientStream pipeClient =
new NamedPipeClientStream(".", "testpipe", PipeDirection.In))
{
// Connect to the pipe or wait until the pipe is available.
Console.Write("Attempting to connect to pipe...");
pipeClient.Connect();
Console.WriteLine("Connected to pipe.");
Console.WriteLine("There are currently {0} pipe server instances open.",
pipeClient.NumberOfServerInstances);
using (StreamReader sr = new StreamReader(pipeClient))
{
// Display the read text to the console
string temp;
while ((temp = sr.ReadLine()) != null)
{
Console.WriteLine("Received from server: {0}", temp);
}
}
}
Console.Write("Press Enter to continue...");
Console.ReadLine();
}
}
Imports System.IO
Imports System.IO.Pipes
Imports System.Security.Principal
Class PipeClient
Shared Sub Main(ByVal args As String())
Dim pipeClient As New NamedPipeClientStream("localhost", _
"testpipe", PipeDirection.In, PipeOptions.None)
' Connect to the pipe or wait until the pipe is available.
Console.WriteLine("Attempting to connect to the pipe...")
pipeClient.Connect()
Console.WriteLine("Connect to the pipe.")
Console.WriteLine("There are currently {0} pipe server instances open.", _
pipeClient.NumberOfServerInstances)
Dim sr As New StreamReader(pipeClient)
Dim temp As String
temp = sr.ReadLine()
While Not temp Is Nothing
Console.WriteLine("Received from server: {0}", temp)
temp = sr.ReadLine()
End While
Console.Write("Press Enter to continue...")
Console.ReadLine()
End Sub
End Class
注解
命名管道提供单向或双工管道，用于管道服务器与一个或多个管道客户端之间的通信。 命名管道可用于本地或通过网络进行进程间通信。 单个管道名称可由多个 NamedPipeClientStream 对象共享。
任何进程都可以充当命名管道服务器或客户端，也可以同时充当这两者。
构造函数
属性
| CanRead |
获取一个值，该值指示当前流是否支持读操作。 (继承自 PipeStream) |
| CanSeek |
获取一个值，该值指示当前流是否支持查找操作。 (继承自 PipeStream) |
| CanTimeout |
获取一个值，该值确定当前流是否可以超时。 (继承自 Stream) |
| CanWrite |
获取一个值，该值指示当前流是否支持写操作。 (继承自 PipeStream) |
| InBufferSize |
获取管道的入站缓冲区的大小（以字节为单位）。 (继承自 PipeStream) |
| IsAsync |
获取一个值，该值指示 PipeStream 对象是异步打开还是同步打开。 (继承自 PipeStream) |
| IsConnected |
获取或设置一个值，该值指示是否已连接 PipeStream 对象。 (继承自 PipeStream) |
| IsHandleExposed |
获取一个值，该值指示是否公开了 PipeStream 对象的句柄。 (继承自 PipeStream) |
| IsMessageComplete |
获取一个值，该值指示最近的读操作返回的消息中是否有更多数据。 (继承自 PipeStream) |
| Length |
获取流长度（以字节为单位）。 (继承自 PipeStream) |
| NumberOfServerInstances |
获取共享同一管道名称的服务器实例的数量。 |
| OutBufferSize |
获取管道的出站缓冲区的大小（以字节为单位）。 (继承自 PipeStream) |
| Position |
获取或设置当前流的当前位置。 (继承自 PipeStream) |
| ReadMode |
获取或设置 PipeStream 对象的读取模式。 (继承自 PipeStream) |
| ReadTimeout |
获取或设置一个值（以毫秒为单位），该值确定流在超时前将尝试读取的时间。 (继承自 Stream) |
| SafePipeHandle |
获取当前 PipeStream 对象所封装的本地管道末端的安全句柄。 (继承自 PipeStream) |
| TransmissionMode |
获取当前管道支持的管道传输模式。 (继承自 PipeStream) |
| WriteTimeout |
获取或设置一个值（以毫秒为单位），该值确定流在超时前将尝试写入多长时间。 (继承自 Stream) |
方法
扩展方法
| GetAccessControl(PipeStream) |
返回管道流的安全信息。 |
| SetAccessControl(PipeStream, PipeSecurity) |
更改现有管道流的安全属性。 |
| ConfigureAwait(IAsyncDisposable, Boolean) |
配置如何执行从异步可处置项返回的任务的等待。 |
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈