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
Локальный файл для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.
- Атрибуты
Исключения
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
Локальный файл для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.
- Атрибуты
Исключения
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
Локальный файл для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.
- Атрибуты
Исключения
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
Локальный файл для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученного от ресурса при отправке файла.
- Атрибуты
Исключения
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.
