AnonymousPipeClientStream 클래스

참조

정의

네임스페이스:: System.IO.Pipes

어셈블리:: System.IO.Pipes.dll

어셈블리:: System.Core.dll

어셈블리:: netstandard.dll

Source:: AnonymousPipeClientStream.cs

Source:: AnonymousPipeClientStream.cs

Source:: AnonymousPipeClientStream.cs

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Windows 플랫폼에서 취소 지원 없이 동기 및 비동기 읽기 및 쓰기 작업을 모두 지원하는 익명 파이프 스트림의 클라이언트 쪽을 노출합니다.

public ref class AnonymousPipeClientStream sealed : System::IO::Pipes::PipeStream

public sealed class AnonymousPipeClientStream : System.IO.Pipes.PipeStream

type AnonymousPipeClientStream = class
    inherit PipeStream

Public NotInheritable Class AnonymousPipeClientStream
Inherits PipeStream

상속: Object

Stream

PipeStream
AnonymousPipeClientStream

상속: Object

MarshalByRefObject

Stream

PipeStream
AnonymousPipeClientStream

예제

다음 예제에서는 익명 파이프를 사용하여 부모 프로세스에서 자식 프로세스로 문자열을 보냅니다. 이 예제에서는 값이 인 AnonymousPipeServerStream 부모 프로세스에 개체를 PipeDirection 만듭니Out다. 또한 값In이 인 AnonymousPipeClientStream 자식 프로세스에 개체를 PipeDirection 만듭니다. 그런 다음, 부모 프로세스는 사용자가 제공한 문자열을 자식 프로세스로 보냅니다. 문자열이 콘솔에 표시됩니다.

이 예제는 서버 프로세스에서 시작하는 클라이언트 프로세스에 대한 것입니다. 클라이언트 코드 pipeClient.exe 에서 결과 실행 파일의 이름을 지정하고 이 예제를 실행할 때 서버 실행 파일과 동일한 디렉터리에 복사합니다. 파이프 클라이언트와 서버 모두에 대한 코드를 포함한 전체 코드 예제는 방법: 로컬 프로세스 간 통신에 익명 파이프 사용을 참조하세요.

//<snippet01>
#using <System.Core.dll>

using namespace System;
using namespace System::IO;
using namespace System::IO::Pipes;

ref class PipeClient
{
public:
    static void Main(array<String^>^ args)
    {
        if (args->Length > 1)
        {
            PipeStream^ pipeClient = gcnew AnonymousPipeClientStream(PipeDirection::In, args[1]);

            Console::WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                pipeClient->TransmissionMode);

            StreamReader^ sr = gcnew StreamReader(pipeClient);

            // Display the read text to the console
            String^ temp;

            // Wait for 'sync message' from the server.
            do
            {
                Console::WriteLine("[CLIENT] Wait for sync...");
                temp = sr->ReadLine();
            }
            while (!temp->StartsWith("SYNC"));

            // Read the server data and echo to the console.
            while ((temp = sr->ReadLine()) != nullptr)
            {
                Console::WriteLine("[CLIENT] Echo: " + temp);
            }
            sr->Close();
            pipeClient->Close();
        }
        Console::Write("[CLIENT] Press Enter to continue...");
        Console::ReadLine();
    }
};

int main()
{
    array<String^>^ args = Environment::GetCommandLineArgs();
    PipeClient::Main(args);
}
//</snippet01>

//<snippet01>
using System;
using System.IO;
using System.IO.Pipes;

class PipeClient
{
    static void Main(string[] args)
    {
        if (args.Length > 0)
        {
            using (PipeStream pipeClient =
                new AnonymousPipeClientStream(PipeDirection.In, args[0]))
            {
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.",
                   pipeClient.TransmissionMode);

                using (StreamReader sr = new StreamReader(pipeClient))
                {
                    // Display the read text to the console
                    string temp;

                    // Wait for 'sync message' from the server.
                    do
                    {
                        Console.WriteLine("[CLIENT] Wait for sync...");
                        temp = sr.ReadLine();
                    }
                    while (!temp.StartsWith("SYNC"));

                    // Read the server data and echo to the console.
                    while ((temp = sr.ReadLine()) != null)
                    {
                        Console.WriteLine("[CLIENT] Echo: " + temp);
                    }
                }
            }
        }
        Console.Write("[CLIENT] Press Enter to continue...");
        Console.ReadLine();
    }
}
//</snippet01>

'<snippet01>
Imports System.IO
Imports System.IO.Pipes

Class PipeClient
    Shared Sub Main(args() as String)
        If args.Length > 0 Then
            Using pipeClient As New AnonymousPipeClientStream(PipeDirection.In, args(0))
                Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.", _
                   pipeClient.TransmissionMode)

                Using sr As New StreamReader(pipeClient)
                    ' Display the read text to the console
                    Dim temp As String

                    ' Wait for 'sync message' from the server.
                    Do
                        Console.WriteLine("[CLIENT] Wait for sync...")
                        temp = sr.ReadLine()
                    Loop While temp.StartsWith("SYNC") = False

                    ' Read the server data and echo to the console.
                    temp = sr.ReadLine()
                    While Not temp = Nothing
                        Console.WriteLine("[CLIENT] Echo: " + temp)
                        temp = sr.ReadLine()
                    End While
                End Using
            End Using
        End If
        Console.Write("[CLIENT] Press Enter to continue...")
        Console.ReadLine()
    End Sub
End Class
'</snippet01>

설명

익명 파이프는 자식 프로세스와 부모 프로세스 간에 안전하고 안전한 프로세스 간 통신을 제공하는 데 도움이 됩니다. AnonymousPipeClientStream 클래스를 사용하면 자식 프로세스가 부모 프로세스에 연결하고 정보를 교환할 수 있습니다.

익명 파이프는 일반적으로 부모 프로세스와 자식 프로세스 간에 데이터를 전송하는 명명되지 않은 단방향 파이프입니다. 익명 파이프는 항상 로컬입니다. 네트워크를 통해 사용할 수 없습니다. PipeDirection 익명 파이프가 단방향으로 정의되므로 값 InOut 은 지원되지 않습니다.

익명 파이프는 읽기 모드를 PipeTransmissionMode.Message 지원하지 않습니다.

익명 파이프의 클라이언트 쪽은 메서드를 호출 GetClientHandleAsString 하여 서버 쪽에서 제공하는 파이프 핸들에서 만들어야 합니다. 그런 다음 클라이언트 프로세스를 만들 때 문자열이 매개 변수로 전달됩니다. 클라이언트 프로세스에서 매개 변수로 pipeHandleAsString 생성자에 전달 AnonymousPipeClientStream 됩니다.

Windows에서는 익명 파이프에서 비동기(겹치는) 읽기 및 쓰기 작업이 지원되지 않습니다(참조 https://docs.microsoft.com/en-us/windows/win32/ipc/anonymous-pipe-operations). 클래스는 AnonymousPipeClientStream 비동 Stream 기 작업이 작동할 수 있도록 Windows 플랫폼의 스레드 풀에서 작업을 예약하지만 해당 작업의 취소는 지원되지 않습니다.

생성자

AnonymousPipeClientStream(PipeDirection, SafePipeHandle)	지정된 핸들을 사용하여 AnonymousPipeClientStream 클래스의 새 인스턴스를 초기화합니다.
AnonymousPipeClientStream(PipeDirection, String)	지정된 파이프 방향 및 파이프 핸들의 문자열 표현을 사용하여 AnonymousPipeClientStream 클래스의 새 인스턴스를 초기화합니다.
AnonymousPipeClientStream(String)	파이프 핸들의 지정된 문자열 표현을 사용하여 AnonymousPipeClientStream 클래스의 새 인스턴스를 초기화합니다.

속성

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	AnonymousPipeClientStream 개체에 대한 읽기 모드를 설정합니다.
ReadTimeout	스트림 읽기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값(밀리초)을 가져오거나 설정합니다. (다음에서 상속됨 Stream)
SafePipeHandle	현재 PipeStream 개체에서 캡슐화하는 파이프의 로컬 끝에 대한 SafeHandle을 가져옵니다. (다음에서 상속됨 PipeStream)
TransmissionMode	현재 파이프가 지원하는 파이프 전송 모드를 가져옵니다.
WriteTimeout	스트림 쓰기 시도가 만료되기 전까지 기다릴 시간을 결정하는 값(밀리초)을 가져오거나 설정합니다. (다음에서 상속됨 Stream)

메서드

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	비동기 읽기 작업을 시작합니다. (다음에서 상속됨 PipeStream)
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)
Dispose()	Stream에서 사용하는 모든 리소스를 해제합니다. (다음에서 상속됨 Stream)
Dispose(Boolean)	PipeStream 클래스에 사용되는 관리되지 않는 리소스를 해제하고, 필요에 따라 관리되는 리소스를 해제합니다. (다음에서 상속됨 PipeStream)
DisposeAsync()	Stream에서 사용하는 관리되지 않는 리소스를 비동기적으로 해제합니다. (다음에서 상속됨 Stream)
EndRead(IAsyncResult)	보류 중인 비동기 읽기 요청을 끝냅니다. (다음에서 상속됨 PipeStream)
EndWrite(IAsyncResult)	보류 중인 비동기 쓰기 요청을 끝냅니다. (다음에서 상속됨 PipeStream)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
Finalize()	가비지 컬렉션에 의해 AnonymousPipeClientStream 인스턴스가 회수되기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다.
Flush()	현재 스트림에 대한 버퍼를 지우고 버퍼링된 모든 데이터를 내부 디바이스에 기록합니다. (다음에서 상속됨 PipeStream)
FlushAsync()	이 스트림에 대한 모든 버퍼를 비동기적으로 지우고 버퍼링된 모든 데이터가 내부 디바이스에 비동기적으로 쓰여지도록 합니다. (다음에서 상속됨 Stream)
FlushAsync(CancellationToken)	비동기적으로 현재 스트림에 대한 버퍼를 지우고 버퍼링된 모든 데이터를 내부 디바이스에 기록합니다. (다음에서 상속됨 PipeStream)
GetAccessControl()	현재 PipeSecurity 개체에서 설명하는 파이프의 ACL(액세스 제어 목록) 엔트리를 캡슐화하는 PipeStream 개체를 가져옵니다. (다음에서 상속됨 PipeStream)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
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)	`count` 현재 스트림에서 바이트 수를 읽고 스트림 내의 위치를 이동합니다. (다음에서 상속됨 Stream)
ReadExactly(Span<Byte>)	현재 스트림에서 바이트를 읽고 가 채워질 때까지 `buffer` 스트림 내의 위치를 이동합니다. (다음에서 상속됨 Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	현재 스트림에서 바이트 수를 비동기적으로 읽고 `count` , 스트림 내의 위치를 확장하고, 취소 요청을 모니터링합니다. (다음에서 상속됨 Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	현재 스트림에서 바이트를 비동기적으로 읽고, 가 채워질 때까지 `buffer` 스트림 내의 위치를 발전시키고, 취소 요청을 모니터링합니다. (다음에서 상속됨 Stream)
Seek(Int64, SeekOrigin)	현재 스트림의 현재 위치를 지정된 값으로 설정합니다. (다음에서 상속됨 PipeStream)
SetAccessControl(PipeSecurity)	PipeSecurity 개체에서 지정한 ACL(액세스 제어 목록) 엔트리를 현재 PipeStream 개체에 지정된 파이프에 적용합니다. (다음에서 상속됨 PipeStream)
SetLength(Int64)	현재 스트림의 길이를 지정된 값으로 설정합니다. (다음에서 상속됨 PipeStream)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
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)	비동기 일회용에서 반환되는 작업을 대기하는 방법을 구성합니다.

적용 대상

AnonymousPipeClientStream 클래스

정의

예제

설명

생성자

속성

메서드

확장 메서드

적용 대상

피드백

추가 리소스