WebClient.UploadFileAsync Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

Отправляет указанный локальный файл в указанный ресурс. Эти методы не блокируют вызывающий поток.

Перегрузки

Имя	Описание
UploadFileAsync(Uri, String)	Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.
UploadFileAsync(Uri, String, String)	Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.
UploadFileAsync(Uri, String, String, Object)	Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.

UploadFileAsync(Uri, String)

Исходный код:

WebClient.cs

Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ fileName);

public void UploadFileAsync(Uri address, string fileName);

member this.UploadFileAsync : Uri * string -> unit

Public Sub UploadFileAsync (address As Uri, fileName As String)

Параметры

address

Uri

URI ресурса для получения файла. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.

fileName

String

Файл для отправки в ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

fileName is null, содержит Emptyнедопустимый символ или указанный путь к файлу не существует.

-или-

Произошла ошибка при открытии потока.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление после завершения отправки файла, добавьте обработчик событий в UploadFileCompleted событие.

Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать при ожидании ответа сервера, используйте один из UploadFile методов.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой (""), должно быть относительным универсальным кодом ресурса (URI), address который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadFile(Uri, String).

UploadFileAsync(Uri, String, String)

Исходный код:

WebClient.cs

Отправляет указанный локальный файл в указанный ресурс с помощью метода POST. Этот метод не блокирует вызывающий поток.

public:
 void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);

public void UploadFileAsync(Uri address, string? method, string fileName);

member this.UploadFileAsync : Uri * string * string -> unit

Public 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

Файл для отправки в ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

fileName is null, содержит Emptyнедопустимый символ или указанный путь к файлу не существует.

-или-

Произошла ошибка при открытии потока.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление после завершения отправки файла, добавьте обработчик событий в UploadFileCompleted событие.

Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать при ожидании ответа сервера, используйте один из UploadFile методов.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой (""), должно быть относительным универсальным кодом ресурса (URI), address который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadFile(Uri, String, String).

UploadFileAsync(Uri, String, String, Object)

Исходный код:

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);

member this.UploadFileAsync : Uri * string * string * obj -> unit

Public 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

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

fileName is null, содержит Emptyнедопустимый символ или указанный путь к файлу не существует.

-или-

Произошла ошибка при открытии потока.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

Заголовок Content-type начинается с multipart.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление после завершения отправки файла, добавьте обработчик событий в UploadFileCompleted событие.

Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать при ожидании ответа сервера, используйте один из UploadFile методов.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой (""), должно быть относительным универсальным кодом ресурса (URI), address который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.