WebClient.UploadDataAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Передает буфер данных ресурсу, заданному с помощью URI. Этот метод не блокирует вызывающий поток.
Перегрузки
UploadDataAsync(Uri, String, Byte[]) |
Выгружает буфер данных в ресурс, указанный с помощью URI, используя указанный метод. Этот метод не блокирует вызывающий поток. |
UploadDataAsync(Uri, String, Byte[], Object) |
Передает буфер данных в ресурс, определенный с помощью URI, используя при этом указанный метод и маркер идентификации. |
UploadDataAsync(Uri, Byte[]) |
Выгружает буфер данных в ресурс, указанный с помощью URI, используя метод POST. Этот метод не блокирует вызывающий поток. |
UploadDataAsync(Uri, String, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);
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[]
Буфер данных, передаваемый ресурсу.
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);
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
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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[]
Буфер данных, передаваемый ресурсу.
Исключения
Параметр address
имеет значение null
.
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[]).
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по