Ағылшын тілінде оқу

Бөлісу құралы:


AnonymousPipeServerStream Класс

Определение

Предоставляет поток вокруг анонимного канала, который поддерживает синхронные и асинхронные операции чтения и записи.

public sealed class AnonymousPipeServerStream : System.IO.Pipes.PipeStream
Наследование
AnonymousPipeServerStream
Наследование
AnonymousPipeServerStream

Примеры

В следующем примере строка из родительского процесса отправляется в дочерний процесс с помощью анонимных каналов. В этом примере создается объект AnonymousPipeServerStream в родительском процессе со значением PipeDirectionPipeDirection.Out. Он также создает объект AnonymousPipeClientStream в дочернем процессе со значением PipeDirectionPipeDirection.In. Затем родительский процесс отправляет в дочерний процесс строку, предоставленную пользователем. Строка отображается в консоли.

В этом примере используется серверный процесс, который использует класс AnonymousPipeServerStream. Полный пример кода, включая код для клиента и сервера канала, см. в разделе Практическое руководство. Использование анонимных каналов для локальной межпроцессной связи.

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

class PipeServer
{
    static void Main()
    {
        Process pipeClient = new Process();

        pipeClient.StartInfo.FileName = "pipeClient.exe";

        using (AnonymousPipeServerStream pipeServer =
            new AnonymousPipeServerStream(PipeDirection.Out,
            HandleInheritability.Inheritable))
        {
            Console.WriteLine("[SERVER] Current TransmissionMode: {0}.",
                pipeServer.TransmissionMode);

            // Pass the client process a handle to the server.
            pipeClient.StartInfo.Arguments =
                pipeServer.GetClientHandleAsString();
            pipeClient.StartInfo.UseShellExecute = false;
            pipeClient.Start();

            pipeServer.DisposeLocalCopyOfClientHandle();

            try
            {
                // Read user input and send that to the client process.
                using (StreamWriter sw = new StreamWriter(pipeServer))
                {
                    sw.AutoFlush = true;
                    // Send a 'sync message' and wait for client to receive it.
                    sw.WriteLine("SYNC");
                    pipeServer.WaitForPipeDrain();
                    // Send the console input to the client process.
                    Console.Write("[SERVER] Enter text: ");
                    sw.WriteLine(Console.ReadLine());
                }
            }
            // Catch the IOException that is raised if the pipe is broken
            // or disconnected.
            catch (IOException e)
            {
                Console.WriteLine("[SERVER] Error: {0}", e.Message);
            }
        }

        pipeClient.WaitForExit();
        pipeClient.Close();
        Console.WriteLine("[SERVER] Client quit. Server terminating.");
    }
}
//</snippet01>

Комментарии

Анонимные каналы помогают обеспечить безопасное и безопасное взаимодействие между дочерними и родительскими процессами. Класс AnonymousPipeServerStream позволяет родительскому процессу отправлять или получать информацию из дочернего процесса.

Анонимные каналы не именуются, односторонние каналы, которые обычно передают данные между родительскими и дочерними процессами. Анонимные каналы всегда являются локальными; их нельзя использовать через сеть. Значение PipeDirectionInOut не поддерживается, так как анонимные каналы определены как односторонние.

Анонимные каналы не поддерживают режим чтения PipeTransmissionMode.Message.

Клиентская сторона анонимного канала должна быть создана из дескриптора канала, предоставленного сервером, путем вызова метода GetClientHandleAsString. Затем строка передается в качестве параметра при создании клиентского процесса. Затем из клиентского процесса он передается конструктору AnonymousPipeClientStream в качестве параметра pipeHandleAsString.

Объект AnonymousPipeServerStream должен удалить дескриптор клиента с помощью метода DisposeLocalCopyOfClientHandle, чтобы получать уведомления при выходе клиента.

Конструкторы

AnonymousPipeServerStream()

Инициализирует новый экземпляр класса AnonymousPipeServerStream.

AnonymousPipeServerStream(PipeDirection)

Инициализирует новый экземпляр класса AnonymousPipeServerStream с указанным направлением канала.

AnonymousPipeServerStream(PipeDirection, HandleInheritability)

Инициализирует новый экземпляр класса AnonymousPipeServerStream с указанным направлением канала и режимом наследования.

AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32)

Инициализирует новый экземпляр класса AnonymousPipeServerStream с указанным направлением канала, режимом наследования и размером буфера.

AnonymousPipeServerStream(PipeDirection, HandleInheritability, Int32, PipeSecurity)

Инициализирует новый экземпляр класса AnonymousPipeServerStream с указанным направлением канала, режимом наследования, размером буфера и безопасностью канала.

AnonymousPipeServerStream(PipeDirection, SafePipeHandle, SafePipeHandle)

Инициализирует новый экземпляр класса AnonymousPipeServerStream из указанных дескрипторов канала.

Свойства

CanRead

Возвращает значение, указывающее, поддерживает ли текущий поток операции чтения.

(Унаследовано от PipeStream)
CanSeek

Возвращает значение, указывающее, поддерживает ли текущий поток операции поиска.

(Унаследовано от PipeStream)
CanTimeout

Возвращает значение, определяющее, может ли текущий поток истекает время ожидания.

(Унаследовано от Stream)
CanWrite

Возвращает значение, указывающее, поддерживает ли текущий поток операции записи.

(Унаследовано от PipeStream)
ClientSafePipeHandle

Возвращает безопасный дескриптор для объекта AnonymousPipeClientStream, который в настоящее время подключен к объекту AnonymousPipeServerStream.

InBufferSize

Возвращает размер в байтах входящего буфера для канала.

(Унаследовано от PipeStream)
IsAsync

Возвращает значение, указывающее, был ли объект PipeStream открыт асинхронно или синхронно.

(Унаследовано от PipeStream)
IsConnected

Возвращает или задает значение, указывающее, подключен ли объект PipeStream.

(Унаследовано от PipeStream)
IsHandleExposed

Возвращает значение, указывающее, предоставляется ли дескриптор объекту PipeStream.

(Унаследовано от PipeStream)
IsMessageComplete

Возвращает значение, указывающее, есть ли в сообщении больше данных, возвращаемых из последней операции чтения.

(Унаследовано от PipeStream)
Length

Возвращает длину потока в байтах.

(Унаследовано от PipeStream)
OutBufferSize

Возвращает размер в байтах исходящего буфера для канала.

(Унаследовано от PipeStream)
Position

Возвращает или задает текущее положение текущего потока.

(Унаследовано от PipeStream)
ReadMode

Задает режим чтения для объекта AnonymousPipeServerStream. Для анонимных каналов режим передачи должен быть Byte.

ReadTimeout

Возвращает или задает значение в миллисекундах, которое определяет, сколько времени поток попытается прочитать до истечения времени ожидания.

(Унаследовано от Stream)
SafePipeHandle

Возвращает безопасный дескриптор для локального конца канала, который инкапсулирует текущий объект PipeStream.

(Унаследовано от 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)
DisposeLocalCopyOfClientHandle()

Закрывает локальную копию дескриптора объекта AnonymousPipeClientStream.

EndRead(IAsyncResult)

Завершает ожидающий асинхронный запрос на чтение.

(Унаследовано от PipeStream)
EndWrite(IAsyncResult)

Завершает ожидающий асинхронный запрос на запись.

(Унаследовано от PipeStream)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
Finalize()

Освобождает неуправляемые ресурсы и выполняет другие операции очистки перед восстановлением экземпляра AnonymousPipeServerStream сборкой мусора.

Flush()

Очищает буфер для текущего потока и приводит к записи буферных данных на базовое устройство.

(Унаследовано от PipeStream)
FlushAsync()

Асинхронно очищает все буферы для этого потока и приводит к записи всех буферных данных на базовое устройство.

(Унаследовано от Stream)
FlushAsync(CancellationToken)

Асинхронно очищает буфер для текущего потока и приводит к записи буферных данных на базовое устройство.

(Унаследовано от PipeStream)
GetAccessControl()

Возвращает объект PipeSecurity, который инкапсулирует записи списка управления доступом (ACL) для канала, описанного текущим объектом PipeStream.

(Унаследовано от PipeStream)
GetClientHandleAsString()

Возвращает связанный AnonymousPipeClientStream дескриптор объекта в виде строки.

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)

Применяет записи списка управления доступом (ACL), указанные объектом PipeSecurity, к каналу, указанному текущим объектом 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)

Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

Применяется к

Өнім Нұсқалар
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1