Export (0) Print
Expand All

AnonymousPipeClientStream Constructor (String)

Initializes a new instance of the AnonymousPipeClientStream class with the specified string representation of the pipe handle.

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

public AnonymousPipeClientStream(
	string pipeHandleAsString


Type: System.String

A string that represents the pipe handle.


pipeHandleAsString is not a valid pipe handle.

For constructors without a PipeDirection parameter, the default direction is In.

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.

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.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.

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft