FtpWebRequest.EndGetRequestStream(IAsyncResult) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Завершает ожидающие асинхронные операции, запущенные с 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
Параметры
- asyncResult
- IAsyncResult
Объект IAsyncResult , возвращенный при запуске операции.
Возвращаемое значение
Записываемый Stream экземпляр, связанный с этим экземпляром.
Исключения
asyncResult равно null.
asyncResult не был получен путем вызова BeginGetRequestStream(AsyncCallback, Object).
Этот метод уже был вызван для операции, определяемой asyncResult.
Примеры
В следующем примере кода показано завершение асинхронной операции для получения потока запроса. Этот пример кода является частью более крупного примера, предоставленного для FtpWebRequest обзора класса.
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;
}
}
Комментарии
Если операция не завершена, EndGetRequestStream метод блокируется до завершения операции. Чтобы определить, выполнена ли операция, проверьте свойство перед вызовом IsCompletedEndGetRequestStream.
Помимо исключений, отмеченных в разделе "Исключения" EndGetRequestStream , повторно создаются исключения, которые были созданы при открытии потока для записи.
Note
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.