Compartilhar via


FtpWebRequest.EndGetRequestStream(IAsyncResult) Método

Definição

Encerra 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 objeto IAsyncResult retornado quando a operação foi iniciada.

Retornos

Uma instância de Stream associada a esta instância.

Exceções

asyncResult é null.

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

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

Exemplos

O exemplo de código a seguir demonstra o fim de uma operação assíncrona para obter o fluxo de uma solicitação. Este exemplo de código faz parte de um exemplo maior fornecido para a visão geral da FtpWebRequest 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;
    }
}

Comentários

Se a operação não tiver sido concluída, o EndGetRequestStream método será bloqueado 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.

Além das exceções indicadas em "Exceções", EndGetRequestStream o gera novamente exceções que foram geradas ao abrir o fluxo para gravação.

Observação

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

Aplica-se a

Confira também