NamedPipeServerStream 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
동기 및 비동기 읽기/쓰기 작업을 모두 지원하는 명명된 파이프 주위의 Stream을 노출합니다.
public ref class NamedPipeServerStream sealed : System::IO::Pipes::PipeStreampublic sealed class NamedPipeServerStream : System.IO.Pipes.PipeStreamtype NamedPipeServerStream = class
inherit PipeStreamPublic NotInheritable Class NamedPipeServerStream
Inherits PipeStream- 상속
- 상속
예제
다음 예제에서는 명명된 파이프를 사용하여 부모 프로세스에서 동일한 컴퓨터의 자식 프로세스로 문자열을 보내는 방법을 보여 줍니다. 이 예제에서는 값이 인 NamedPipeServerStream 부모 프로세스에 개체를 PipeDirection 만듭니 Out다. 그런 다음 서버는 자식 프로세스의 NamedPipeClientStream 개체가 연결되기를 기다립니다. 이 예제에서 두 프로세스는 동일한 컴퓨터에 있고 개체의 NamedPipeClientStreamIn값은 입니다PipeDirection. 그런 다음, 부모 프로세스는 사용자가 제공한 문자열을 자식 프로세스로 보냅니다. 문자열이 콘솔에 표시됩니다.
이 예제는 클래스를 사용하는 서버 프로세스를 위한 것입니다 NamedPipeServerStream . 파이프 클라이언트와 서버 모두에 대한 코드를 포함한 전체 코드 예제는 방법: 네트워크 간 통신에 명명된 파이프 사용을 참조하세요.
using System;
using System.IO;
using System.IO.Pipes;
class PipeServer
{
static void Main()
{
using (NamedPipeServerStream pipeServer =
new NamedPipeServerStream("testpipe", PipeDirection.Out))
{
Console.WriteLine("NamedPipeServerStream object created.");
// Wait for a client to connect
Console.Write("Waiting for client connection...");
pipeServer.WaitForConnection();
Console.WriteLine("Client connected.");
try
{
// Read user input and send that to the client process.
using (StreamWriter sw = new StreamWriter(pipeServer))
{
sw.AutoFlush = true;
Console.Write("Enter text: ");
sw.WriteLine(Console.ReadLine());
}
}
// Catch the IOException that is raised if the pipe is broken
// or disconnected.
catch (IOException e)
{
Console.WriteLine("ERROR: {0}", e.Message);
}
}
}
}
Imports System.IO
Imports System.IO.Pipes
Class PipeServer
Shared Sub Main()
Dim pipeServer As New NamedPipeServerStream("testpipe", PipeDirection.Out)
Console.WriteLine("NamedPipeServerStream object created.")
' Wait for a client to connect
Console.Write("Waiting for a client connection...")
pipeServer.WaitForConnection()
Console.WriteLine("Client connected.")
Try
'Read user input and send that to the client process.
Dim sw As New StreamWriter(pipeServer)
sw.AutoFlush = True
Console.Write("Enter Text: ")
sw.WriteLine(Console.ReadLine())
Catch ex As IOException
' Catch the IOException that is raised if the pipe is broken
' or disconnected
Console.WriteLine("ERROR: {0}", ex.Message)
End Try
End Sub
End Class
설명
명명된 파이프는 파이프 서버와 하나 이상의 파이프 클라이언트 간의 통신을 위한 단방향 또는 이중 파이프를 제공합니다. 명명된 파이프는 로컬 또는 네트워크를 통한 프로세스 간 통신에 사용할 수 있습니다. 단일 파이프 이름은 여러 NamedPipeClientStream 개체에서 공유할 수 있습니다.
모든 프로세스는 명명된 파이프 서버 또는 클라이언트 또는 둘 다로 작동할 수 있습니다.
생성자
필드
| MaxAllowedServerInstances |
시스템 리소스가 허용하는 최대 서버 인스턴스 수를 나타냅니다. |
속성
| CanRead |
현재 스트림이 읽기 작업을 지원하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| CanSeek |
현재 스트림이 검색 작업을 지원하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| CanTimeout |
현재 스트림이 시간 초과될 수 있는지를 결정하는 값을 가져옵니다. (다음에서 상속됨 Stream) |
| CanWrite |
현재 스트림이 쓰기 작업을 지원하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| InBufferSize |
파이프에 대한 인바운드 버퍼의 크기(바이트 단위)를 가져옵니다. (다음에서 상속됨 PipeStream) |
| IsAsync |
PipeStream 개체가 동기적으로 열렸는지 비동기적으로 열렸는지 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| IsConnected |
PipeStream 개체가 연결되었는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 PipeStream) |
| IsHandleExposed |
PipeStream 개체에 대한 핸들이 노출되는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| IsMessageComplete |
가장 최근의 읽기 작업을 통해 반환된 메시지에 다른 데이터가 더 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 PipeStream) |
| Length |
스트림의 길이(바이트 단위)를 가져옵니다. (다음에서 상속됨 PipeStream) |
| OutBufferSize |
파이프에 대한 아웃바운드 버퍼의 크기(바이트 단위)를 가져옵니다. (다음에서 상속됨 PipeStream) |
| Position |
현재 스트림의 현재 위치를 가져오거나 설정합니다. (다음에서 상속됨 PipeStream) |
| ReadMode |
PipeStream 개체에 대한 읽기 모드를 가져오거나 설정합니다. (다음에서 상속됨 PipeStream) |
| ReadTimeout |
스트림 읽기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값(밀리초)을 가져오거나 설정합니다. (다음에서 상속됨 Stream) |
| SafePipeHandle |
현재 PipeStream 개체에서 캡슐화하는 파이프의 로컬 끝에 대한 SafeHandle을 가져옵니다. (다음에서 상속됨 PipeStream) |
| TransmissionMode |
현재 파이프가 지원하는 파이프 전송 모드를 가져옵니다. (다음에서 상속됨 PipeStream) |
| WriteTimeout |
스트림 쓰기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값(밀리초)을 가져오거나 설정합니다. (다음에서 상속됨 Stream) |
메서드
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
비동기 읽기 작업을 시작합니다. (다음에서 상속됨 PipeStream) |
| BeginWaitForConnection(AsyncCallback, Object) |
클라이언트 연결을 대기할 비동기 작업을 시작합니다. |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
비동기 쓰기 작업을 시작합니다. (다음에서 상속됨 PipeStream) |
| CheckPipePropertyOperations() |
파이프가 속성을 가져오거나 설정할 수 있는 적절한 상태인지 확인합니다. (다음에서 상속됨 PipeStream) |
| CheckReadOperations() |
파이프가 읽기 작업을 위해 연결된 상태인지 확인합니다. (다음에서 상속됨 PipeStream) |
| CheckWriteOperations() |
파이프가 쓰기 작업을 위해 연결된 상태인지 확인합니다. (다음에서 상속됨 PipeStream) |
| Close() |
현재 스트림을 닫고 현재 스트림과 관련된 소켓과 파일 핸들 등의 리소스를 모두 해제합니다. 이 메서드를 호출하는 대신 스트림이 올바르게 삭제되었는지 확인합니다. (다음에서 상속됨 Stream) |
| CopyTo(Stream) |
현재 스트림에서 바이트를 읽어서 다른 스트림에 해당 바이트를 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CopyTo(Stream, Int32) |
현재 스트림에서 바이트를 읽어서 지정된 버퍼 크기로 다른 스트림에 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CopyToAsync(Stream) |
현재 스트림에서 모든 바이트를 비동기적으로 읽어 다른 스트림에 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CopyToAsync(Stream, CancellationToken) |
현재 스트림에서 바이트를 비동기적으로 읽어 지정된 취소 토큰을 사용하여 다른 스트림에 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CopyToAsync(Stream, Int32) |
현재 스트림에서 바이트를 비동기적으로 읽어 지정된 버퍼 크기로 다른 스트림에 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
현재 스트림에서 바이트를 비동기적으로 읽어 지정된 버퍼 크기 및 취소 토큰을 사용하여 다른 스트림에 씁니다. 두 스트림 위치는 복사된 바이트 수에 따라 고급입니다. (다음에서 상속됨 Stream) |
| CreateObjRef(Type) |
원격 개체와 통신하는 데 사용되는 프록시 생성에 필요한 모든 관련 정보가 들어 있는 개체를 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| CreateWaitHandle() |
사용되지 않음.
사용되지 않음.
사용되지 않음.
WaitHandle 개체를 할당합니다. (다음에서 상속됨 Stream) |
| Disconnect() |
현재 연결을 끊습니다. |
| Dispose() |
Stream에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Stream) |
| Dispose(Boolean) |
PipeStream 클래스에 사용되는 관리되지 않는 리소스를 해제하고, 필요에 따라 관리되는 리소스를 해제합니다. (다음에서 상속됨 PipeStream) |
| DisposeAsync() |
Stream에서 사용하는 관리되지 않는 리소스를 비동기적으로 해제합니다. (다음에서 상속됨 Stream) |
| EndRead(IAsyncResult) |
보류 중인 비동기 읽기 요청을 끝냅니다. (다음에서 상속됨 PipeStream) |
| EndWaitForConnection(IAsyncResult) |
클라이언트 연결을 대기할 비동기 작업을 끝냅니다. |
| EndWrite(IAsyncResult) |
보류 중인 비동기 쓰기 요청을 끝냅니다. (다음에서 상속됨 PipeStream) |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object) |
| Finalize() |
가비지 컬렉션에 의해 NamedPipeServerStream 인스턴스가 회수되기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다. |
| Flush() |
현재 스트림에 대한 버퍼를 지우고 버퍼링된 모든 데이터를 내부 디바이스에 기록합니다. (다음에서 상속됨 PipeStream) |
| FlushAsync() |
이 스트림에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 모든 데이터가 내부 디바이스에 비동기적으로 쓰여지도록 합니다. (다음에서 상속됨 Stream) |
| FlushAsync(CancellationToken) |
비동기적으로 현재 스트림에 대한 버퍼를 지우고 버퍼링된 모든 데이터를 내부 디바이스에 기록합니다. (다음에서 상속됨 PipeStream) |
| GetAccessControl() |
현재 PipeSecurity 개체에서 설명하는 파이프의 ACL(액세스 제어 목록) 엔트리를 캡슐화하는 PipeStream 개체를 가져옵니다. (다음에서 상속됨 PipeStream) |
| GetHashCode() |
기본 해시 함수로 작동합니다. (다음에서 상속됨 Object) |
| GetImpersonationUserName() |
파이프 반대쪽 끝에서 클라이언트의 사용자 이름을 가져옵니다. |
| GetLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 현재의 수명 서비스 개체를 검색합니다. (다음에서 상속됨 MarshalByRefObject) |
| GetType() |
현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object) |
| InitializeHandle(SafePipeHandle, Boolean, Boolean) |
지정된 PipeStream 개체에서 SafePipeHandle 개체를 초기화합니다. (다음에서 상속됨 PipeStream) |
| InitializeLifetimeService() |
사용되지 않음.
이 인스턴스의 수명 정책을 제어하는 수명 서비스 개체를 가져옵니다. (다음에서 상속됨 MarshalByRefObject) |
| MemberwiseClone() |
현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| MemberwiseClone(Boolean) |
현재 MarshalByRefObject 개체의 단순 복사본을 만듭니다. (다음에서 상속됨 MarshalByRefObject) |
| ObjectInvariant() |
사용되지 않음.
Contract에 대한 지원을 제공합니다. (다음에서 상속됨 Stream) |
| Read(Byte[], Int32, Int32) |
스트림에서 바이트 블록을 읽고 지정된 길이에 대해 지정된 위치에서 시작하는 지정 버퍼에 데이터를 씁니다. (다음에서 상속됨 PipeStream) |
| Read(Span<Byte>) |
현재 스트림에서 바이트 시퀀스를 읽고, 이를 바이트 배열에 쓰고, 읽은 바이트 수만큼 스트림에서 위치를 앞으로 이동합니다. (다음에서 상속됨 PipeStream) |
| ReadAsync(Byte[], Int32, Int32) |
현재 스트림에서 바이트 시퀀스를 읽고 읽은 바이트 수만큼 스트림에서 위치를 비동기적으로 앞으로 이동합니다. (다음에서 상속됨 Stream) |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
현재 스트림에서 지정된 바이트 수에 대해 지정된 위치에서 시작하는 바이트 배열까지 바이트의 시퀀스를 비동기적으로 읽고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다. (다음에서 상속됨 PipeStream) |
| ReadAsync(Memory<Byte>, CancellationToken) |
현재 스트림에서 바이트의 시퀀스를 비동기적으로 읽고, 이를 바이트 메모리 범위에 쓰고, 읽은 바이트 수만큼 스트림 내에서 앞으로 이동하며, 취소 요청을 모니터링합니다. (다음에서 상속됨 PipeStream) |
| ReadAtLeast(Span<Byte>, Int32, Boolean) |
현재 스트림에서 최소 바이트 수를 읽고 읽은 바이트 수만큼 스트림 내의 위치를 앞으로 이동합니다. (다음에서 상속됨 Stream) |
| ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken) |
현재 스트림에서 최소 바이트 수를 비동기적으로 읽고, 읽은 바이트 수만큼 스트림 내의 위치를 확장하고, 취소 요청을 모니터링합니다. (다음에서 상속됨 Stream) |
| ReadByte() |
파이프에서 바이트를 읽습니다. (다음에서 상속됨 PipeStream) |
| ReadExactly(Byte[], Int32, Int32) |
|
| ReadExactly(Span<Byte>) |
현재 스트림에서 바이트를 읽고 가 채워질 때까지 |
| ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
현재 스트림에서 바이트 수를 비동기적으로 읽고 |
| ReadExactlyAsync(Memory<Byte>, CancellationToken) |
현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 |
| RunAsClient(PipeStreamImpersonationWorker) |
클라이언트를 가장하는 동안 대리자를 호출합니다. |
| Seek(Int64, SeekOrigin) |
현재 스트림의 현재 위치를 지정된 값으로 설정합니다. (다음에서 상속됨 PipeStream) |
| SetAccessControl(PipeSecurity) |
PipeSecurity 개체에서 지정한 ACL(액세스 제어 목록) 엔트리를 현재 PipeStream 개체에 지정된 파이프에 적용합니다. (다음에서 상속됨 PipeStream) |
| SetLength(Int64) |
현재 스트림의 길이를 지정된 값으로 설정합니다. (다음에서 상속됨 PipeStream) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
| WaitForConnection() |
클라이언트가 이 NamedPipeServerStream 개체에 연결할 때까지 기다립니다. |
| WaitForConnectionAsync() |
클라이언트가 이 NamedPipeServerStream 개체에 비동기 방식으로 연결할 때까지 기다립니다. |
| WaitForConnectionAsync(CancellationToken) |
클라이언트가 이 NamedPipeServerStream 개체에 연결할 때까지 비동기 방식으로 기다리고 취소 요청을 모니터링합니다. |
| WaitForPipeDrain() |
전달된 바이트를 파이프의 다른 끝에서 모두 읽을 때까지 기다립니다. (다음에서 상속됨 PipeStream) |
| Write(Byte[], Int32, Int32) |
버퍼의 데이터를 사용하여 현재 스트림에 바이트 블록을 씁니다. (다음에서 상속됨 PipeStream) |
| Write(ReadOnlySpan<Byte>) |
현재 스트림에 바이트 시퀀스를 쓰고 쓴 바이트 수만큼 이 스트림에서 현재 위치를 앞으로 이동합니다. (다음에서 상속됨 PipeStream) |
| WriteAsync(Byte[], Int32, Int32) |
현재 스트림에 바이트 시퀀스를 비동기적으로 쓰고 쓴 바이트 수만큼 이 스트림에서 현재 위치를 앞으로 이동합니다. (다음에서 상속됨 Stream) |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
지정된 위치에서 시작하는 바이트 배열에서 지정된 바이트 수를 비동기적으로 쓰고, 쓴 바이트 수만큼 이 스트림 내의 현재 위치를 앞으로 이동하고, 취소 요청을 모니터링합니다. (다음에서 상속됨 PipeStream) |
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
바이트의 시퀀스를 현재 스트림에 비동기적으로 쓰고 쓰여진 바이트 수만큼 이 스트림 내의 현재 위치를 앞으로 이동한 후 취소 요청을 모니터링합니다. (다음에서 상속됨 PipeStream) |
| WriteByte(Byte) |
현재 스트림에 바이트를 씁니다. (다음에서 상속됨 PipeStream) |
확장 메서드
| CopyToAsync(Stream, PipeWriter, CancellationToken) |
Stream의 바이트를 비동기식으로 읽고 취소 토큰을 사용하여 지정된 PipeWriter에 씁니다. |
| GetAccessControl(PipeStream) |
파이프 스트림의 보안 정보를 반환합니다. |
| SetAccessControl(PipeStream, PipeSecurity) |
기존 파이프 스트림의 보안 특성을 변경합니다. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다. |
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기