WebClient.UploadDataAsync Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

Передает буфер данных ресурсу, заданному с помощью URI. Этот метод не блокирует вызывающий поток.

Перегрузки

UploadDataAsync(Uri, String, Byte[])	Выгружает буфер данных в ресурс, указанный с помощью URI, используя указанный метод. Этот метод не блокирует вызывающий поток.
UploadDataAsync(Uri, String, Byte[], Object)	Передает буфер данных в ресурс, определенный с помощью URI, используя при этом указанный метод и маркер идентификации.
UploadDataAsync(Uri, Byte[])	Выгружает буфер данных в ресурс, указанный с помощью URI, используя метод POST. Этот метод не блокирует вызывающий поток.

UploadDataAsync(Uri, String, Byte[])

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

WebClient.cs

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

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Параметры

address

Uri

URI ресурса, которому передаются данные.

method

String

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

data

Byte[]

Буфер данных, передаваемый ресурсу.

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из UploadData методов.

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

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

Примечание

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые UploadData(Uri, String, Byte[]).

UploadDataAsync(Uri, String, Byte[], Object)

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

WebClient.cs

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

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

Параметры

address

Uri

URI ресурса, которому передаются данные.

method

String

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

data

Byte[]

Буфер данных, передаваемый ресурсу.

userToken

Object

Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из UploadData методов.

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

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

Примечание

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

UploadDataAsync(Uri, Byte[])

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

WebClient.cs

Выгружает буфер данных в ресурс, указанный с помощью URI, используя метод POST. Этот метод не блокирует вызывающий поток.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Параметры

address

Uri

URI ресурса, которому передаются данные.

data

Byte[]

Буфер данных, передаваемый ресурсу.

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

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

Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из UploadData методов.

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

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

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

Примечание

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые UploadData(Uri, Byte[]).