FtpWebRequest.EndGetRequestStream(IAsyncResult) Método

Definição

Espaço de Nomes:
System.Net
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Termina uma operação assíncrona pendente iniciada com BeginGetRequestStream(AsyncCallback, Object).

public:
 override System::IO::Stream ^ EndGetRequestStream(IAsyncResult ^ asyncResult);
public override System.IO.Stream EndGetRequestStream(IAsyncResult asyncResult);
override this.EndGetRequestStream : IAsyncResult -> System.IO.Stream
Public Overrides Function EndGetRequestStream (asyncResult As IAsyncResult) As Stream

Parâmetros

asyncResult
IAsyncResult

O IAsyncResult objeto que foi devolvido quando a operação começou.

Devoluções

Stream

Uma instância gravável Stream associada a esta instância.

Exceções

ArgumentNullException

asyncResult é null.

ArgumentException

asyncResult não foi obtido ao chamar BeginGetRequestStream(AsyncCallback, Object).

InvalidOperationException

Este método já era chamado para a operação identificada por asyncResult.

Exemplos

O exemplo de código seguinte demonstra como terminar uma operação assíncrona para obter o fluxo de um pedido. Este exemplo de código faz parte de um exemplo maior fornecido para a FtpWebRequest visão geral da classe.

private static void EndGetStreamCallback(IAsyncResult ar)
{
    FtpState state = (FtpState) ar.AsyncState;

    Stream requestStream = null;
    // End the asynchronous call to get the request stream.
    try
    {
        requestStream = state.Request.EndGetRequestStream(ar);
        // Copy the file contents to the request stream.
        const int bufferLength = 2048;
        byte[] buffer = new byte[bufferLength];
        int count = 0;
        int readBytes = 0;
        FileStream stream = File.OpenRead(state.FileName);
        do
        {
            readBytes = stream.Read(buffer, 0, bufferLength);
            requestStream.Write(buffer, 0, readBytes);
            count += readBytes;
        }
        while (readBytes != 0);
        Console.WriteLine ("Writing {0} bytes to the stream.", count);
        // IMPORTANT: Close the request stream before sending the request.
        requestStream.Close();
        // Asynchronously get the response to the upload request.
        state.Request.BeginGetResponse(
            new AsyncCallback (EndGetResponseCallback),
            state
        );
    }
    // Return exceptions to the main application thread.
    catch (Exception e)
    {
        Console.WriteLine("Could not get the request stream.");
        state.OperationException = e;
        state.OperationComplete.Set();
        return;
    }
}

Observações

Se a operação não estiver concluída, o EndGetRequestStream método bloqueia-se até que a operação seja concluída. Para determinar se a operação foi concluída, verifique a IsCompleted propriedade antes de chamar EndGetRequestStream.

Para além das exceções mencionadas em "Exceções", EndGetRequestStream relança exceções que foram lançadas ao abrir o stream para escrever.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Rastreamento de Rede no .NET Framework.

Aplica-se a

Ver também