WebClient.UploadDataTaskAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

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

UploadDataTaskAsync(String, Byte[])

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

Параметры

address

String

URI ресурса для получения данных.

data

Byte[]

Буфер данных для отправки в ресурс.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.

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

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

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

Заметка

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

UploadDataTaskAsync(Uri, Byte[])

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

Параметры

address

Uri

URI ресурса для получения данных.

data

Byte[]

Буфер данных для отправки в ресурс.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.

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

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

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

Заметка

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

UploadDataTaskAsync(String, String, Byte[])

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, string? method, byte[] data);

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

Параметры

address

String

URI ресурса для получения данных.

method

String

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

data

Byte[]

Буфер данных для отправки в ресурс.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.

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

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

Заметка

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

UploadDataTaskAsync(Uri, String, Byte[])

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, string? method, byte[] data);

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())

Параметры

address

Uri

URI ресурса для получения данных.

method

String

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

data

Byte[]

Буфер данных для отправки в ресурс.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.

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

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

Заметка

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