NamedPipeServerStream Konstruktory

Definice

Obor názvů:

System.IO.Pipes

Sestavení:

System.IO.Pipes.dll

Inicializuje novou instanci NamedPipeServerStream třídy.

Přetížení

NamedPipeServerStream(String)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru, režimem přenosu, možnostmi kanálu a doporučenými velikostmi vyrovnávací paměti.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru, režimem přenosu a možnostmi kanálu.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicializuje novou instanci NamedPipeServerStream třídy ze zadaného úchytu potrubí.
NamedPipeServerStream(String, PipeDirection, Int32)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu a maximálním počtem instancí serveru.
NamedPipeServerStream(String, PipeDirection)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu a směrem kanálu.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru a režimem přenosu.

NamedPipeServerStream(String)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu.

public:
 NamedPipeServerStream(System::String ^ pipeName);

public NamedPipeServerStream (string pipeName);

new System.IO.Pipes.NamedPipeServerStream : string -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String)

Parametry

pipeName

String

Název kanálu.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Výchozí směr potrubí pro InOut.

• Maximální počet instancí serveru, které sdílejí stejný název, je nastavený na 1.

• Hodnota PipeTransmissionModeByte.

• Hodnota PipeOptionsNone.

• Výchozí velikosti vstupní a výstupní vyrovnávací paměti.

• Žádné zabezpečení potrubí.

• Hodnota HandleInheritabilityNone.

• Není zadáno žádné další PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrováním kanálu, maximálním počtem instancí serveru, režimem přenosu, možnostmi kanálu a doporučenými vstupními a odchozími velikostmi vyrovnávací paměti.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options, int inBufferSize, int outBufferSize);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer)

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

maxNumberOfServerInstances

Int32

Maximální počet instancí serveru, které sdílejí stejný název. Tuto hodnotu můžete předat MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z hodnot výčtu, která určuje režim přenosu potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

inBufferSize

Int32

Kladná hodnota větší než 0, která označuje velikost vstupní vyrovnávací paměti.

outBufferSize

Int32

Kladná hodnota větší než 0, která označuje velikost výstupní vyrovnávací paměti.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

-nebo-

direction není platná PipeDirection hodnota.

-nebo-

maxNumberofServerInstances je menší než -1 nebo větší než 254 (-1 označuje MaxAllowedServerInstances)

-nebo-

options není platná PipeOptions hodnota.

-nebo-

inBufferSize je negativní.

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Žádné další zabezpečení kanálu.

• Výchozí HandleInheritability hodnota Noneje .

• Není zadáno žádné další .PipeAccessRights

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru, režimem přenosu a možnostmi kanálu.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode, System::IO::Pipes::PipeOptions options);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions)

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

maxNumberOfServerInstances

Int32

Maximální počet instancí serveru, které sdílejí stejný název. Tuto hodnotu můžete předat MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z hodnot výčtu, která určuje režim přenosu potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit kanál.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

-nebo-

direction není platná PipeDirection hodnota.

-nebo-

maxNumberofServerInstances je menší než -1 nebo větší než 254 (-1 znamená MaxAllowedServerInstances)

-nebo-

options není platná PipeOptions hodnota.

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Výchozí velikosti vstupní a výstupní vyrovnávací paměti.

• Žádné zabezpečení potrubí.

• Hodnota HandleInheritabilityNone.

• Není zadáno žádné další .PipeAccessRights

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Zdroj:

NamedPipeServerStream.Unix.cs

Inicializuje novou instanci NamedPipeServerStream třídy ze zadaného úchytu kanálu.

public:
 NamedPipeServerStream(System::IO::Pipes::PipeDirection direction, bool isAsync, bool isConnected, Microsoft::Win32::SafeHandles::SafePipeHandle ^ safePipeHandle);

public NamedPipeServerStream (System.IO.Pipes.PipeDirection direction, bool isAsync, bool isConnected, Microsoft.Win32.SafeHandles.SafePipeHandle safePipeHandle);

new System.IO.Pipes.NamedPipeServerStream : System.IO.Pipes.PipeDirection * bool * bool * Microsoft.Win32.SafeHandles.SafePipeHandle -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (direction As PipeDirection, isAsync As Boolean, isConnected As Boolean, safePipeHandle As SafePipeHandle)

Parametry

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

isAsync

Boolean

truechcete-li označit, že popisovač byl otevřen asynchronně; v opačném případě . false

isConnected

Boolean

truek označení, že potrubí je připojeno; v opačném případě . false

safePipeHandle

SafePipeHandle

Bezpečný úchyt pro potrubí, který tento NamedPipeServerStream objekt zapouzdřuje.

Výjimky

ArgumentOutOfRangeException

direction není platná PipeDirection hodnota.

ArgumentNullException

safePipeHandle je null.

ArgumentException

safePipeHandle je neplatný popisovač.

IOException

safePipeHandle není platný úchyt potrubí.

-nebo-

Byl překročen maximální počet instancí serveru.

NamedPipeServerStream(String, PipeDirection, Int32)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu a maximálním počtem instancí serveru.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer)

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

maxNumberOfServerInstances

Int32

Maximální počet instancí serveru, které sdílejí stejný název. Tuto hodnotu můžete předat MaxAllowedServerInstances .

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

-nebo-

direction není platná PipeDirection hodnota.

-nebo-

Je vyžadováno nezáporné číslo.

-nebo-

maxNumberofServerInstances je menší než -1 nebo větší než 254 (-1 znamená MaxAllowedServerInstances)

-nebo-

None nebo Inheritable se vyžaduje.

-nebo-

Přístupová práva jsou omezená na ChangePermissions příznaky , TakeOwnership a AccessSystemSecurity .

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Výchozí hodnota 1 pro maximální počet instancí serveru, které sdílejí stejný název.

• Výchozí PipeTransmissionMode hodnota je Byte.

• Hodnota PipeOptionsNone.

• Výchozí velikosti vstupní a výstupní vyrovnávací paměti.

• Žádné zabezpečení potrubí.

• Hodnota HandleInheritabilityNone.

• Není zadáno žádné další PipeAccessRights.

NamedPipeServerStream(String, PipeDirection)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu a směrem kanálu.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection)

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

-nebo-

direction není platná PipeDirection hodnota.

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Příklady

Následující příklad ukazuje metodu pro odeslání řetězce z nadřazeného procesu do podřízeného procesu pomocí pojmenovaných kanálů. Tento příklad vytvoří NamedPipeServerStream objekt v nadřazené procesu. Objekt NamedPipeServerStream má PipeDirection hodnotu Out, která pak blokuje, dokud NamedPipeClientStream objekt nenaváže připojení k aktuálnímu NamedPipeServerStream objektu.

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

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Hodnota PipeTransmissionModeByte.

• Hodnota PipeOptionsNone.

• Výchozí velikosti vstupní a výstupní vyrovnávací paměti.

• Žádné zabezpečení potrubí.

• Hodnota HandleInheritabilityNone.

• Není zadáno žádné další PipeAccessRights.

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Zdroj:

NamedPipeServerStream.cs

Inicializuje novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru a režimem přenosu.

public:
 NamedPipeServerStream(System::String ^ pipeName, System::IO::Pipes::PipeDirection direction, int maxNumberOfServerInstances, System::IO::Pipes::PipeTransmissionMode transmissionMode);

public NamedPipeServerStream (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode);

new System.IO.Pipes.NamedPipeServerStream : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode -> System.IO.Pipes.NamedPipeServerStream

Public Sub New (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode)

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

maxNumberOfServerInstances

Int32

Maximální počet instancí serveru, které sdílejí stejný název. Tuto hodnotu můžete předat MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z hodnot výčtu, která určuje režim přenosu potrubí.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je řetězec nulové délky.

ArgumentOutOfRangeException

pipeName je nastavená na anonymní.

-nebo-

direction není platná PipeDirection hodnota.

-nebo-

maxNumberofServerInstances je menší než -1 nebo větší než 254 (-1 označuje MaxAllowedServerInstances)

NotSupportedException

pipeName obsahuje dvojtečku (":").

IOException

Byl překročen maximální počet instancí serveru.

Poznámky

Tento konstruktor vytvoří NamedPipeServerStream objekt, který má následující vlastnosti:

• Výchozí PipeOptions hodnota je None.

• Výchozí velikosti vstupní a výstupní vyrovnávací paměti.

• Žádné zabezpečení potrubí.

• Hodnota HandleInheritabilityNone.

• Není zadáno žádné další PipeAccessRights.