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


WebClient.UploadFileTaskAsync Метод

Определение

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

Перегрузки

UploadFileTaskAsync(Uri, String, String)

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

UploadFileTaskAsync(String, String, String)

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

UploadFileTaskAsync(String, String)

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

UploadFileTaskAsync(Uri, String)

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

UploadFileTaskAsync(Uri, String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string? method, string fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string method, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string method, string fileName);
member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

Параметры

address
Uri

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

method
String

Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.

fileName
String

Локальный файл для отправки в ресурс.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр fileNamenull.

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки файла в ресурс. Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

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

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

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

Заметка

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

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

UploadFileTaskAsync(String, String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ method, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string? method, string fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string method, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string method, string fileName);
member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

Параметры

address
String

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

method
String

Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.

fileName
String

Локальный файл для отправки в ресурс.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр fileNamenull.

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки файла в ресурс. Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

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

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

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

Заметка

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

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

UploadFileTaskAsync(String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (string address, string fileName);
member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : string * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

Параметры

address
String

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

fileName
String

Локальный файл для отправки в ресурс.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр fileNamenull.

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки файла в ресурс. Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

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

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

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

Заметка

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

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

UploadFileTaskAsync(Uri, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);
member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task<byte[]>
Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

Параметры

address
Uri

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

fileName
String

Локальный файл для отправки в ресурс.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр fileNamenull.

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки файла в ресурс. Файл отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

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

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

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

Заметка

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

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