WebClient.UploadFileAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправляет указанный локальный файл в указанный ресурс. Эти методы не блокируют вызывающий поток.
Перегрузки
| UploadFileAsync(Uri, String) |
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток. |
| UploadFileAsync(Uri, String, String) |
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток. |
| UploadFileAsync(Uri, String, String, Object) |
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток. |
UploadFileAsync(Uri, String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);public void UploadFileAsync (Uri address, string fileName);member this.UploadFileAsync : Uri * string -> unitPublic Sub UploadFileAsync (address As Uri, fileName As String)Параметры
- address
- Uri
URI ресурса для получения файла. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- fileName
- String
Файл для отправки в ресурс.
Исключения
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
fileName
null, Empty, содержит недопустимый символ или указанный путь к файлу не существует.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
-или-
Заголовок Content-type начинается с multipart.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о завершении отправки файла, добавьте обработчик событий в событие UploadFileCompleted.
Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать время ожидания ответа сервера, используйте один из методов UploadFile.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadFile(Uri, String).
Применяется к
UploadFileAsync(Uri, String, String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);public void UploadFileAsync (Uri address, string? method, string fileName);public void UploadFileAsync (Uri address, string method, string fileName);member this.UploadFileAsync : Uri * string * string -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String)Параметры
- address
- Uri
URI ресурса для получения файла. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- method
- String
Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.
- fileName
- String
Файл для отправки в ресурс.
Исключения
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
fileName
null, Empty, содержит недопустимый символ или указанный путь к файлу не существует.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
-или-
Заголовок Content-type начинается с multipart.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о завершении отправки файла, добавьте обработчик событий в событие UploadFileCompleted.
Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать время ожидания ответа сервера, используйте один из методов UploadFile.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadFile(Uri, String, String).
Применяется к
UploadFileAsync(Uri, String, String, Object)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);public void UploadFileAsync (Uri address, string method, string fileName, object userToken);member this.UploadFileAsync : Uri * string * string * obj -> unitPublic Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)Параметры
- address
- Uri
URI ресурса для получения файла. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- method
- String
Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.
- fileName
- String
Файл для отправки в ресурс.
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
fileName
null, Empty, содержит недопустимый символ или указанный путь к файлу не существует.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
-или-
Заголовок Content-type начинается с multipart.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о завершении отправки файла, добавьте обработчик событий в событие UploadFileCompleted.
Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать время ожидания ответа сервера, используйте один из методов UploadFile.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
