WebClient.UploadValues Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Передает коллекцию "имя-значение" ресурсу с заданным URI.
Перегрузки
| UploadValues(String, NameValueCollection) |
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI. |
| UploadValues(Uri, NameValueCollection) |
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI. |
| UploadValues(String, String, NameValueCollection) |
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод. |
| UploadValues(Uri, String, NameValueCollection) |
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод. |
UploadValues(String, NameValueCollection)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);public byte[] UploadValues (string address, System.Collections.Specialized.NameValueCollection data);member this.UploadValues : string * System.Collections.Specialized.NameValueCollection -> byte[]Public Function UploadValues (address As String, data As NameValueCollection) As Byte()Параметры
- address
- String
URI ресурса, которому передается коллекция.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Массив значений типа Byte, содержащий основной текст ответа ресурса.
Исключения
Параметр address имеет значение null.
-или-
Параметр data имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
data имеет значение null.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
При открытии потока произошла ошибка.
-или-
Заголовок Content-type не равен ни null, ни "application/x-www-form-urlencoded".
Примеры
В следующем примере кода собираются сведения от пользователя (имя, возраст и адрес) и публикуются значения на сервере с помощью UploadValues. Любой ответ от сервера отображается в консоли.
Console::Write( "\nPlease enter the URI to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URL" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// 'The Upload(String, NameValueCollection)' implicitly method sets HTTP POST as the request method.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {0}", Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URI to post data to : ");
string uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URL");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// 'The Upload(String,NameValueCollection)' implicitly method sets HTTP POST as the request method.
byte[] responseArray = myWebClient.UploadValues(uriString,myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{0}",Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the URL:")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' The Upload(String,NameValueCollection)' method implicitly sets the HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Комментарии
Метод UploadValues отправляет на NameValueCollection сервер. Этот метод блокирует при отправке данных. Чтобы продолжить выполнение во время ожидания ответа сервера, используйте один из UploadValuesAsync методов .
Если сервер не понимает базовый запрос, то его действия определяются базовыми классами протоколов. Как правило, WebException возникает исключение с заданным свойством Status , указывающим на ошибку.
Если заголовок Content-type имеет значение null, UploadValues метод задает для него значение application/x-www-form-urlencoded.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то это должен быть относительный URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadValues(Uri, NameValueCollection)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);public byte[] UploadValues (Uri address, System.Collections.Specialized.NameValueCollection data);member this.UploadValues : Uri * System.Collections.Specialized.NameValueCollection -> byte[]Public Function UploadValues (address As Uri, data As NameValueCollection) As Byte()Параметры
- address
- Uri
URI ресурса, которому передается коллекция.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Массив значений типа Byte, содержащий основной текст ответа ресурса.
Исключения
Параметр address имеет значение null.
-или-
Параметр data имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
data имеет значение null.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
При открытии потока произошла ошибка.
-или-
Заголовок Content-type не равен ни null, ни "application/x-www-form-urlencoded".
Комментарии
Метод UploadValues отправляет на NameValueCollection сервер. Этот метод блокирует при отправке данных. Чтобы продолжить выполнение во время ожидания ответа сервера, используйте один из UploadValuesAsync методов .
Если сервер не понимает базовый запрос, то его действия определяются базовыми классами протоколов. Как правило, WebException возникает исключение с заданным свойством Status , указывающим на ошибку.
Если заголовок Content-type имеет значение null, UploadValues метод задает для него значение application/x-www-form-urlencoded.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то это должен быть относительный URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadValues(String, String, NameValueCollection)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод.
public:
cli::array <System::Byte> ^ UploadValues(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);public byte[] UploadValues (string address, string? method, System.Collections.Specialized.NameValueCollection data);public byte[] UploadValues (string address, string method, System.Collections.Specialized.NameValueCollection data);member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()Параметры
- address
- String
URI ресурса, которому передается коллекция.
- method
- String
Метод HTTP, используемый для передачи файла ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Массив значений типа Byte, содержащий основной текст ответа ресурса.
Исключения
Параметр address имеет значение null.
-или-
Параметр data имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
data имеет значение null.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Значение заголовка Content-type не равно null или application/x-www-form-urlencoded.
Примеры
В следующем примере кода собираются сведения от пользователя (имя, возраст и адрес) и публикуются значения на сервере с помощью UploadValues. Любой ответ от сервера отображается в консоли.
Console::Write( "\nPlease enter the URL to post data to: " );
String^ uriString = Console::ReadLine();
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection^ myNameValueCollection = gcnew NameValueCollection;
Console::WriteLine( "Please enter the following parameters to be posted to the URI" );
Console::Write( "Name: " );
String^ name = Console::ReadLine();
Console::Write( "Age: " );
String^ age = Console::ReadLine();
Console::Write( "Address: " );
String^ address = Console::ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection->Add( "Name", name );
myNameValueCollection->Add( "Address", address );
myNameValueCollection->Add( "Age", age );
Console::WriteLine( "\nUploading to {0} ...", uriString );
// Upload the NameValueCollection.
array<Byte>^ responseArray = myWebClient->UploadValues( uriString, "POST", myNameValueCollection );
// Decode and display the response.
Console::WriteLine( "\nResponse received was :\n {0}", Encoding::ASCII->GetString( responseArray ) );
Console.Write("\nPlease enter the URL to post data to : ");
string uriString = Console.ReadLine();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
NameValueCollection myNameValueCollection = new NameValueCollection();
Console.WriteLine("Please enter the following parameters to be posted to the URI");
Console.Write("Name:");
string name = Console.ReadLine();
Console.Write("Age:");
string age = Console.ReadLine();
Console.Write("Address:");
string address = Console.ReadLine();
// Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name",name);
myNameValueCollection.Add("Address",address);
myNameValueCollection.Add("Age",age);
Console.WriteLine("\nUploading to {0} ...", uriString);
// Upload the NameValueCollection.
byte[] responseArray = myWebClient.UploadValues(uriString,"POST",myNameValueCollection);
// Decode and display the response.
Console.WriteLine("\nResponse received was :\n{0}",Encoding.ASCII.GetString(responseArray));
Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold some custom parameters to be posted to the URL.
Dim myNameValueCollection As New NameValueCollection()
Console.WriteLine("Please enter the following parameters to be posted to the Url")
Console.Write("Name:")
Dim name As String = Console.ReadLine()
Console.Write("Age:")
Dim age As String = Console.ReadLine()
Console.Write("Address:")
Dim address As String = Console.ReadLine()
' Add necessary parameter/value pairs to the name/value container.
myNameValueCollection.Add("Name", name)
myNameValueCollection.Add("Address", address)
myNameValueCollection.Add("Age", age)
Console.WriteLine(ControlChars.Cr + "Uploading to {0} ...", uriString)
' Upload the NameValueCollection.
Dim responseArray As Byte() = myWebClient.UploadValues(uriString, "POST", myNameValueCollection)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :" + ControlChars.Cr + "{0}", Encoding.ASCII.GetString(responseArray))
Комментарии
Метод UploadValues отправляет NameValueCollection в ресурс с помощью метода, указанного в параметре method , и возвращает любой ответ от сервера. Этот метод блокирует при отправке данных. Чтобы продолжить выполнение во время ожидания ответа сервера, используйте один из UploadValuesAsync методов .
Если заголовок Content-type имеет значение null, UploadValues метод присваивает ему значение application/x-www-form-urlencoded.
method Если параметр указывает команду, которая не понятна серверу, базовые классы протоколов определяют, что происходит. Как правило, WebException возникает исключение с заданным свойством Status , указывающим на ошибку.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то это должен быть относительный URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadValues(Uri, String, NameValueCollection)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью URI, используя указанный метод.
public:
cli::array <System::Byte> ^ UploadValues(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);public byte[] UploadValues (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);public byte[] UploadValues (Uri address, string method, System.Collections.Specialized.NameValueCollection data);member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()Параметры
- address
- Uri
URI ресурса, которому передается коллекция.
- method
- String
Метод HTTP, используемый для передачи файла ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Массив значений типа Byte, содержащий основной текст ответа ресурса.
Исключения
Параметр address имеет значение null.
-или-
Параметр data имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
data имеет значение null.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Значение заголовка Content-type не равно null или application/x-www-form-urlencoded.
Комментарии
Метод UploadValues отправляет NameValueCollection в ресурс с помощью метода, указанного в параметре method , и возвращает любой ответ от сервера. Этот метод блокирует передачу данных. Чтобы продолжить выполнение в ожидании ответа сервера, используйте один из UploadValuesAsync методов.
Если заголовок Content-type имеет значение null, UploadValues метод присваивает ему значение application/x-www-form-urlencoded.
method Если параметр задает глагол, который не распознается сервером, базовые классы протоколов определяют, что происходит. Как правило, возникает исключение со свойством , WebException заданным Status для указания ошибки.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по