NamedPipeServerStream Konstruktory

Definicja

Przestrzeń nazw:

System.IO.Pipes

Zestaw:

System.IO.Pipes.dll

Inicjuje nowe wystąpienie klasy NamedPipeServerStream.

Przeciążenia

NamedPipeServerStream(String)	Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32)	Inicjuje nowe wystąpienie NamedPipeServerStream klasy o określonej nazwie potoku, kierunku potoku, maksymalnej liczbie wystąpień serwera, trybie transmisji, opcjach potoku i zalecanych rozmiarach buforu i poza tym.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode, PipeOptions)	Inicjuje nowe wystąpienie NamedPipeServerStream klasy o określonej nazwie potoku, kierunku potoku, maksymalnej liczbie wystąpień serwera, trybie transmisji i opcjach potoku.
NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)	Inicjuje NamedPipeServerStream nowe wystąpienie klasy z określonego uchwytu potoku.
NamedPipeServerStream(String, PipeDirection, Int32)	Inicjuje nowe wystąpienie NamedPipeServerStream klasy o określonej nazwie potoku, kierunku potoku i maksymalnej liczbie wystąpień serwera.
NamedPipeServerStream(String, PipeDirection)	Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku i kierunku potoku.
NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)	Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku, kierunku potoku, maksymalnej liczbie wystąpień serwera i trybie transmisji.

NamedPipeServerStream(String)

Źródło:

NamedPipeServerStream.cs

Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku.

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

Nazwa potoku.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName jest ustawiona na "anonimowy".

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Domyślny kierunek potoku .InOut

• Maksymalna liczba wystąpień serwera, które mają taką samą nazwę ustawioną na 1.

• Wartość PipeTransmissionMode .Byte

• Wartość PipeOptions .None

• Domyślne rozmiary buforów wejściowych i wyjściowych.

• Brak zabezpieczeń potoku.

• Wartość HandleInheritability .None

• Nie określono dodatkowego PipeAccessRightselementu .

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

Źródło:

NamedPipeServerStream.cs

Inicjuje nowe wystąpienie NamedPipeServerStream klasy z określoną nazwą potoku, kierunkiem potoku, maksymalną liczbą wystąpień serwera, trybem transmisji, opcjami potoku oraz zalecanymi rozmiarami buforu i poza tym.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

maxNumberOfServerInstances

Int32

Maksymalna liczba wystąpień serwera, które mają taką samą nazwę. Tę wartość można przekazać MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z wartości wyliczenia, która określa tryb transmisji potoku.

options

PipeOptions

Jedna z wartości wyliczenia, która określa sposób otwierania lub tworzenia potoku.

inBufferSize

Int32

Wartość dodatnia większa niż 0, która wskazuje rozmiar buforu wejściowego.

outBufferSize

Int32

Wartość dodatnia większa niż 0, która wskazuje rozmiar buforu wyjściowego.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName jest ustawiona na "anonimowy".

-lub-

direction jest nieprawidłową PipeDirection wartością.

-lub-

maxNumberofServerInstanceswartość jest mniejsza niż -1 lub większa niż 254 (-1 wskazuje )MaxAllowedServerInstances

-lub-

options jest nieprawidłową PipeOptions wartością.

-lub-

inBufferSize jest ujemna.

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Brak dodatkowych zabezpieczeń potoku.

• Wartość domyślna HandleInheritability .None

• Nie określono dodatkowego PipeAccessRightselementu .

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

Źródło:

NamedPipeServerStream.cs

Inicjuje nowe wystąpienie NamedPipeServerStream klasy z określoną nazwą potoku, kierunkiem potoku, maksymalną liczbą wystąpień serwera, trybem transmisji i opcjami potoku.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

maxNumberOfServerInstances

Int32

Maksymalna liczba wystąpień serwera, które mają taką samą nazwę. Tę wartość można przekazać MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z wartości wyliczenia, która określa tryb transmisji potoku.

options

PipeOptions

Jedna z wartości wyliczenia, która określa sposób otwierania lub tworzenia potoku.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName parametr ma wartość "anonymous" (anonimowe).

-lub-

direction jest nieprawidłową PipeDirection wartością.

-lub-

maxNumberofServerInstances wartość jest mniejsza niż -1 lub większa niż 254 (-1 wskazuje MaxAllowedServerInstances)

-lub-

options jest nieprawidłową PipeOptions wartością.

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Domyślne rozmiary buforów wejściowych i wyjściowych.

• Brak zabezpieczeń potoku.

• Wartość HandleInheritabilityNone.

• Nie określono dodatkowego PipeAccessRightselementu .

NamedPipeServerStream(PipeDirection, Boolean, Boolean, SafePipeHandle)

Źródło:

NamedPipeServerStream.Unix.cs

Inicjuje NamedPipeServerStream nowe wystąpienie klasy z określonego uchwytu potoku.

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 wartości wyliczenia, która określa kierunek potoku.

isAsync

Boolean

true aby wskazać, że dojście zostało otwarte asynchronicznie; w przeciwnym razie , false.

isConnected

Boolean

true aby wskazać, że rura jest połączona; w przeciwnym razie , false.

safePipeHandle

SafePipeHandle

Bezpieczny uchwyt dla potoku, który ten NamedPipeServerStream obiekt będzie hermetyzować.

Wyjątki

ArgumentOutOfRangeException

direction jest nieprawidłową PipeDirection wartością.

ArgumentNullException

safePipeHandle to null.

ArgumentException

safePipeHandle jest nieprawidłowym dojściem.

IOException

safePipeHandle nie jest prawidłowym uchwytem potoku.

-lub-

Przekroczono maksymalną liczbę wystąpień serwera.

NamedPipeServerStream(String, PipeDirection, Int32)

Źródło:

NamedPipeServerStream.cs

Inicjuje nowe wystąpienie NamedPipeServerStream klasy o określonej nazwie potoku, kierunku potoku i maksymalnej liczbie wystąpień serwera.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

maxNumberOfServerInstances

Int32

Maksymalna liczba wystąpień serwera, które mają taką samą nazwę. Tę wartość można przekazać MaxAllowedServerInstances .

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName parametr ma wartość "anonymous" (anonimowe).

-lub-

direction jest nieprawidłową PipeDirection wartością.

-lub-

Wymagana jest liczba nieujemna.

-lub-

maxNumberofServerInstances wartość jest mniejsza niż -1 lub większa niż 254 (-1 wskazuje MaxAllowedServerInstances)

-lub-

None lub Inheritable jest wymagany.

-lub-

Prawa dostępu są ograniczone do ChangePermissions flag , TakeOwnership i AccessSystemSecurity .

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Wartość domyślna 1 dla maksymalnej liczby wystąpień serwera, które mają taką samą nazwę.

• Wartość domyślna PipeTransmissionMode .Byte

• Wartość PipeOptions .None

• Domyślne rozmiary buforów wejściowych i wyjściowych.

• Brak zabezpieczeń potoku.

• Wartość HandleInheritability .None

• Nie określono dodatkowego PipeAccessRightselementu .

NamedPipeServerStream(String, PipeDirection)

Źródło:

NamedPipeServerStream.cs

Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku i kierunku potoku.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName jest ustawiona na "anonimowy".

-lub-

direction jest nieprawidłową PipeDirection wartością.

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Przykłady

W poniższym przykładzie pokazano metodę wysyłania ciągu z procesu nadrzędnego do procesu podrzędnego przy użyciu nazwanych potoków. W tym przykładzie tworzony NamedPipeServerStream jest obiekt w procesie nadrzędnym. Obiekt NamedPipeServerStream ma PipeDirection wartość Out, która następnie blokuje, dopóki NamedPipeClientStream obiekt nie nawiąza połączenia z bieżącym NamedPipeServerStream obiektem.

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

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Wartość PipeTransmissionMode .Byte

• Wartość PipeOptions .None

• Domyślne rozmiary buforów wejściowych i wyjściowych.

• Brak zabezpieczeń potoku.

• Wartość HandleInheritability .None

• Nie określono dodatkowego PipeAccessRightselementu .

NamedPipeServerStream(String, PipeDirection, Int32, PipeTransmissionMode)

Źródło:

NamedPipeServerStream.cs

Inicjuje NamedPipeServerStream nowe wystąpienie klasy o określonej nazwie potoku, kierunku potoku, maksymalnej liczbie wystąpień serwera i trybie transmisji.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

maxNumberOfServerInstances

Int32

Maksymalna liczba wystąpień serwera, które mają taką samą nazwę. Tę wartość można przekazać MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z wartości wyliczenia, która określa tryb transmisji potoku.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest ciągiem o zerowej długości.

ArgumentOutOfRangeException

pipeName jest ustawiona na "anonimowy".

-lub-

direction jest nieprawidłową PipeDirection wartością.

-lub-

maxNumberofServerInstanceswartość jest mniejsza niż -1 lub większa niż 254 (-1 wskazuje )MaxAllowedServerInstances

NotSupportedException

pipeName zawiera dwukropek (":").

IOException

Przekroczono maksymalną liczbę wystąpień serwera.

Uwagi

Ten konstruktor tworzy NamedPipeServerStream obiekt o następujących cechach:

• Wartość domyślna PipeOptions .None

• Domyślne rozmiary buforów wejściowych i wyjściowych.

• Brak zabezpieczeń potoku.

• Wartość HandleInheritability .None

• Nie określono dodatkowego PipeAccessRightselementu .