Поделиться через

WebClient.UploadFileAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.WebClient.dll
Сборка:
System.dll
Сборка:
netstandard.dll

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

Перегрузки

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 -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)

Параметры

address
Uri

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

fileName
String

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр fileNamenull.

WebException

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

Параметр addressnull.

-или-

Параметр fileNamenull.

WebException

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

Параметр addressnull.

-или-

Параметр fileNamenull.

WebException

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.

Применяется к