WebClient.UploadValues Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przekazuje kolekcję nazw/wartości do zasobu przy użyciu określonego identyfikatora URI.
Przeciążenia
UploadValues(String, NameValueCollection) |
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI. |
UploadValues(Uri, NameValueCollection) |
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI. |
UploadValues(String, String, NameValueCollection) |
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI przy użyciu określonej metody. |
UploadValues(Uri, String, NameValueCollection) |
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI przy użyciu określonej metody. |
UploadValues(String, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator 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()
Parametry
- address
- String
Identyfikator URI zasobu do odbierania kolekcji.
- data
- NameValueCollection
Element NameValueCollection do wysłania do zasobu.
Zwraca
Tablica Byte zawierająca treść odpowiedzi z zasobu.
Wyjątki
Identyfikator URI utworzony przez połączenie elementu BaseAddressi address
jest nieprawidłowy.
-lub-
data
to null
.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
-lub-
Wystąpił błąd podczas otwierania strumienia.
-lub-
Nagłówek Content-type
nie null
jest ani "application/x-www-form-urlencoded".
Przykłady
Poniższy przykład kodu zbiera informacje z użytkownika (nazwa, wiek i adres) i publikuje wartości na serwerze przy użyciu polecenia UploadValues. Każda odpowiedź z serwera jest wyświetlana w konsoli programu .
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))
Uwagi
Metoda UploadValues wysyła element NameValueCollection do serwera. Ta metoda blokuje przekazywanie danych. Aby kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValuesAsync metod.
Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania błędu.
Jeśli nagłówek Content-type to null
, UploadValues metoda ustawia ją na "application/x-www-form-urlencoded".
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Dotyczy
UploadValues(Uri, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator 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()
Parametry
- address
- Uri
Identyfikator URI zasobu do odbierania kolekcji.
- data
- NameValueCollection
Element NameValueCollection do wysłania do zasobu.
Zwraca
Tablica Byte zawierająca treść odpowiedzi z zasobu.
Wyjątki
Identyfikator URI utworzony przez połączenie elementu BaseAddressi address
jest nieprawidłowy.
-lub-
data
to null
.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
-lub-
Wystąpił błąd podczas otwierania strumienia.
-lub-
Nagłówek Content-type
nie null
jest ani "application/x-www-form-urlencoded".
Uwagi
Metoda UploadValues wysyła element NameValueCollection do serwera. Ta metoda blokuje przekazywanie danych. Aby kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValuesAsync metod.
Jeśli bazowe żądanie nie jest zrozumiałe dla serwera, podstawowe klasy protokołów określają, co się dzieje. WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania błędu.
Jeśli nagłówek Content-type to null
, UploadValues metoda ustawia ją na "application/x-www-form-urlencoded".
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Ta metoda używa polecenia STOR do przekazania zasobu FTP. W przypadku zasobu HTTP jest używana metoda POST.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Dotyczy
UploadValues(String, String, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI przy użyciu określonej metody.
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()
Parametry
- address
- String
Identyfikator URI zasobu do odbierania kolekcji.
- method
- String
Metoda HTTP używana do wysyłania pliku do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.
- data
- NameValueCollection
Element NameValueCollection do wysłania do zasobu.
Zwraca
Tablica Byte zawierająca treść odpowiedzi z zasobu.
Wyjątki
Identyfikator URI utworzony przez połączenie elementu BaseAddressi address
jest nieprawidłowy.
-lub-
data
to null
.
-lub-
Wystąpił błąd podczas otwierania strumienia.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
-lub-
Wartość nagłówka Content-type
nie null
jest i nie application/x-www-form-urlencoded
jest .
Przykłady
Poniższy przykład kodu zbiera informacje z użytkownika (nazwa, wiek i adres) i publikuje wartości na serwerze przy użyciu polecenia UploadValues. Każda odpowiedź z serwera jest wyświetlana w konsoli programu .
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))
Uwagi
Metoda UploadValues wysyła NameValueCollection element do zasobu przy użyciu metody określonej w parametrze method
i zwraca dowolną odpowiedź z serwera. Ta metoda blokuje przekazywanie danych. Aby kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValuesAsync metod.
Content-type
Jeśli nagłówek to null
, UploadValues metoda ustawia ją na application/x-www-form-urlencoded
.
method
Jeśli parametr określa czasownik, który nie jest zrozumiały dla serwera, podstawowe klasy protokołów określają, co się dzieje.
WebException Zazwyczaj obiekt jest zgłaszany z właściwością ustawioną w Status celu wskazania błędu.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest pustym ciągiem, jest dołączana do address
elementu .
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Dotyczy
UploadValues(Uri, String, NameValueCollection)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Przekazuje określoną kolekcję nazw/wartości do zasobu zidentyfikowanych przez określony identyfikator URI przy użyciu określonej metody.
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()
Parametry
- address
- Uri
Identyfikator URI zasobu do odbierania kolekcji.
- method
- String
Metoda HTTP używana do wysyłania pliku do zasobu. Jeśli wartość null, wartość domyślna to POST dla protokołu HTTP i STOR dla protokołu FTP.
- data
- NameValueCollection
Element NameValueCollection do wysłania do zasobu.
Zwraca
Tablica Byte zawierająca treść odpowiedzi z zasobu.
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddresselementu i address
jest nieprawidłowy.
-lub-
data
to null
.
-lub-
Wystąpił błąd podczas otwierania strumienia.
-lub-
Nie było odpowiedzi z serwera hostowania zasobu.
-lub-
Wartość nagłówka Content-type
nie null
jest i nie application/x-www-form-urlencoded
jest .
Uwagi
Metoda UploadValues wysyła obiekt NameValueCollection do zasobu przy użyciu metody określonej w parametrze method
i zwraca dowolną odpowiedź z serwera. Ta metoda blokuje przekazywanie danych. Aby kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z UploadValuesAsync metod.
Content-type
Jeśli nagłówek to null
, UploadValues metoda ustawia ją na application/x-www-form-urlencoded
.
method
Jeśli parametr określa czasownik, który nie jest zrozumiały dla serwera, podstawowe klasy protokołów określają, co się dzieje.
WebException Zazwyczaj element jest zgłaszany z ustawioną właściwościąStatus, aby wskazać błąd.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych.
QueryString Jeśli właściwość nie jest pustym ciągiem, jest dołączana do address
elementu .
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla