SslStream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) Метод

Определение

Пространство имен:
System.Net.Security
Сборки:
netstandard.dll, System.Net.Security.dll
Сборка:
System.Net.Security.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs

Начинает асинхронную операцию записи, которая записывает Byteданные из указанного буфера в поток.

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback? asyncCallback, object? asyncState);
public override IAsyncResult BeginWrite(byte[] buffer, int offset, int count, AsyncCallback asyncCallback, object asyncState);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, count As Integer, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

buffer
Byte[]

Byte Массив, предоставляющий байты для записи в поток.

offset
Int32

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

count
Int32

Значение Int32 , указывающее число байтов для чтения из buffer.

asyncCallback
AsyncCallback

Делегат AsyncCallback , ссылающийся на метод для вызова при завершении операции записи.

asyncState
Object

Определяемый пользователем объект, содержащий сведения об операции записи. Этот объект передается asyncCallback делегату после завершения операции.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult , указывающий состояние асинхронной операции.

Исключения

ArgumentNullException

buffer равно null.

ArgumentException

offset меньше нуля.

–или–

offset больше длины buffer.

–или–

offset + число больше длины buffer.

IOException

Сбой операции записи.

NotSupportedException

Выполняется операция записи.

ObjectDisposedException

Этот объект был закрыт.

InvalidOperationException

Проверка подлинности не произошла.

Примеры

В следующем примере кода показано, как вызвать этот метод.

void ReadCallback(IAsyncResult ar)
{
    ClientState state = (ClientState) ar.AsyncState;
    SslStream stream = state.stream;
    // Read the  message sent by the client.
    // The end of the message is signaled using the
    // "<EOF>" marker.
    int byteCount = -1;
    try
    {
        Console.WriteLine("Reading data from the client.");
        byteCount = stream.EndRead(ar);
        // Use Decoder class to convert from bytes to UTF8
        // in case a character spans two buffers.
        Decoder decoder = Encoding.UTF8.GetDecoder();
        char[] chars = new char[decoder.GetCharCount(state.buffer,0, byteCount)];
        decoder.GetChars(state.buffer, 0, byteCount, chars,0);
        state.readData.Append (chars);
        // Check for EOF or an empty message.
        if (state.readData.ToString().IndexOf("<EOF>") == -1 && byteCount != 0)
        {
            // We are not finished reading.
            // Asynchronously read more message data from  the client.
            stream.BeginRead(state.buffer, 0, state.buffer.Length,
                new AsyncCallback(ReadCallback),
                state);
        }
        else
        {
            Console.WriteLine("Message from the client: {0}", state.readData.ToString());
        }

        // Encode a test message into a byte array.
        // Signal the end of the message using "<EOF>".
        byte[] message = Encoding.UTF8.GetBytes("Hello from the server.<EOF>");
        // Asynchronously send the message to the client.
        stream.BeginWrite(message, 0, message.Length,
            new AsyncCallback(WriteCallback),
            state);
    }
    catch (Exception readException)
    {
        Console.WriteLine("Read error: {0}", readException.Message);
        state.Close();
        return;
    }
}

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