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 -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)
Параметры
- address
- Uri
URI ресурса, которому передается файл. Для HTTP-ресурсов этот URI должен указывать ресурс, который может принять запрос, отправленный с помощью метода POST, например скрипт или страницу ASP.
- fileName
- String
Файл, передаваемый ресурсу.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр fileName
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
fileName
равен null
, Empty, или содержит недопустимый знак, или указанный путь к файлу не существует.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Заголовок Content-type
начинается с multipart
.
Комментарии
Файл отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получать уведомления о завершении отправки файла, добавьте в событие обработчик 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
, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- fileName
- String
Файл, передаваемый ресурсу.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр fileName
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
fileName
равен null
, Empty, или содержит недопустимый знак, или указанный путь к файлу не существует.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Заголовок Content-type
начинается с multipart
.
Комментарии
Файл отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получать уведомления о завершении отправки файла, добавьте в событие обработчик 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
, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- fileName
- String
Файл, передаваемый ресурсу.
- userToken
- Object
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр fileName
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
fileName
равен null
, Empty, или содержит недопустимый знак, или указанный путь к файлу не существует.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Заголовок Content-type
начинается с multipart
.
Комментарии
Файл отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получать уведомления о завершении отправки файла, добавьте в событие обработчик UploadFileCompleted событий.
Этот метод не блокирует вызывающий поток во время отправки файла. Чтобы отправить файл и заблокировать в ожидании ответа сервера, используйте один из UploadFile методов.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые еще не завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой (""), address
должен быть относительным URI, который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по