WebClient.UploadFileTaskAsync Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

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

Перегрузки

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

UploadFileTaskAsync(Uri, String, String)

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

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

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, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

fileName

String

Локальный Файл, передаваемый ресурсу.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

Эта операция не блокируется. Возвращенный 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

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

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

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, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

fileName

String

Локальный Файл, передаваемый ресурсу.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

Эта операция не блокируется. Возвращенный 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

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

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

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, содержащий тело ответа, полученного из ресурса, когда файл был отправлен.

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

Эта операция не блокируется. Возвращенный 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

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

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

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, содержащий тело ответа, полученного из ресурса, когда файл был отправлен.

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

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

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.