Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
AnonymousPipeClientStream Constructor (PipeDirection, SafePipeHandle)

AnonymousPipeClientStream Constructor (PipeDirection, SafePipeHandle)

Initializes a new instance of the AnonymousPipeClientStream class from the specified handle.

Namespace:  System.IO.Pipes
Assembly:  System.Core (in System.Core.dll)

public AnonymousPipeClientStream(
	PipeDirection direction,
	SafePipeHandle safePipeHandle


Type: System.IO.Pipes.PipeDirection

One of the enumeration values that determines the direction of the pipe.

Anonymous pipes can only be in one direction, so direction cannot be set to InOut.

Type: Microsoft.Win32.SafeHandles.SafePipeHandle

A safe handle for the pipe that this AnonymousPipeClientStream object will encapsulate.


safePipeHandle is not a valid handle.


safePipeHandle is null.


direction is set to InOut.


An I/O error, such as a disk error, has occurred.


The stream has been closed.

A PipeDirection value of InOut is not supported because anonymous pipes are defined to be one-way.

The following example demonstrates a way to send a string from a parent process to a child process by using anonymous pipes. In this example, an AnonymousPipeClientStream object is created in a child process with a PipeDirection value of In.

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(args[0]))

                Console.WriteLine("Current TransmissionMode: {0}.",

                // Anonymous Pipes do not support Message mode. 
                    Console.WriteLine("Setting ReadMode to \"Message\".");
                    pipeClient.ReadMode = PipeTransmissionMode.Message;
                catch (NotSupportedException e)
                    Console.WriteLine("EXCEPTION: {0}", e.Message);

                using (StreamReader sr = new StreamReader(pipeClient))
                    // Display the read text to the console 
                    string temp;
                    while ((temp = sr.ReadLine()) != null)
        Console.Write("Press Enter to continue...");

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

  • Demand 

    for full trust for the immediate caller. This member cannot be used by partially trusted code.

© 2015 Microsoft