WebClient.UploadValues Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Laddar upp en namn-/värdesamling till en resurs med angiven URI.
Överlagringar
| Name | Description |
|---|---|
| UploadValues(String, NameValueCollection) |
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n. |
| UploadValues(Uri, NameValueCollection) |
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n. |
| UploadValues(String, String, NameValueCollection) |
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. |
| UploadValues(Uri, String, NameValueCollection) |
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden. |
UploadValues(String, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n.
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()
Parametrar
- address
- String
Resursens URI för att ta emot samlingen.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Returer
En Byte matris som innehåller svarets brödtext från resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
data är null.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
Ett fel uppstod när strömmen öppnades.
-eller-
Rubriken Content-type är inte null eller "application/x-www-form-urlencoded".
Exempel
I följande kodexempel samlas information från användaren (namn, ålder och adress) och värdena skickas till servern med hjälp av UploadValues. Alla svar från servern visas i konsolen.
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))
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden UploadValues skickar en NameValueCollection till en server. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadValuesAsync metoderna.
Om den underliggande begäran inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
Om rubriken Innehållstyp är nullanger UploadValues metoden den till "application/x-www-form-urlencoded".
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
UploadValues(Uri, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n.
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()
Parametrar
- address
- Uri
Resursens URI för att ta emot samlingen.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Returer
En Byte matris som innehåller svarets brödtext från resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
data är null.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
Ett fel uppstod när strömmen öppnades.
-eller-
Rubriken Content-type är inte null eller "application/x-www-form-urlencoded".
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden UploadValues skickar en NameValueCollection till en server. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadValuesAsync metoderna.
Om den underliggande begäran inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
Om rubriken Innehållstyp är nullanger UploadValues metoden den till "application/x-www-form-urlencoded".
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder STOR-kommandot för att ladda upp en FTP-resurs. För en HTTP-resurs används POST-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
UploadValues(String, String, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden.
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()
Parametrar
- address
- String
Resursens URI för att ta emot samlingen.
- method
- String
HTTP-metoden som används för att skicka filen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Returer
En Byte matris som innehåller svarets brödtext från resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
data är null.
-eller-
Ett fel uppstod när strömmen öppnades.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
Rubrikvärdet Content-type är inte null och är inte application/x-www-form-urlencoded.
Exempel
I följande kodexempel samlas information från användaren (namn, ålder och adress) och värdena skickas till servern med hjälp av UploadValues. Alla svar från servern visas i konsolen.
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))
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden UploadValues skickar en NameValueCollection till en resurs med hjälp av den metod som anges i parametern method och returnerar alla svar från servern. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadValuesAsync metoderna.
Content-type Om rubriken är nullanger UploadValues metoden den till application/x-www-form-urlencoded.
Om parametern method anger ett verb som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
Gäller för
UploadValues(Uri, String, NameValueCollection)
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
- Källa:
- WebClient.cs
Laddar upp den angivna namn-/värdesamlingen till den resurs som identifieras av den angivna URI:n med den angivna metoden.
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()
Parametrar
- address
- Uri
Resursens URI för att ta emot samlingen.
- method
- String
HTTP-metoden som används för att skicka filen till resursen. Om värdet är null är standardinställningen POST för http och STOR för ftp.
- data
- NameValueCollection
Att NameValueCollection skicka till resursen.
Returer
En Byte matris som innehåller svarets brödtext från resursen.
Undantag
Den URI som skapas genom att kombinera BaseAddressoch address är ogiltig.
-eller-
data är null.
-eller-
Ett fel uppstod när strömmen öppnades.
-eller-
Det fanns inget svar från servern som var värd för resursen.
-eller-
Rubrikvärdet Content-type är inte null och är inte application/x-www-form-urlencoded.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Metoden UploadValues skickar en NameValueCollection till en resurs med hjälp av den metod som anges i parametern method och returnerar alla svar från servern. Den här metoden blockerar när data laddas upp. Om du vill fortsätta köra i väntan på serverns svar använder du någon av UploadValuesAsync metoderna.
Content-type Om rubriken är nullanger UploadValues metoden den till application/x-www-form-urlencoded.
Om parametern method anger ett verb som inte förstås av servern avgör de underliggande protokollklasserna vad som händer. Vanligtvis genereras en WebException med egenskapen Status inställd för att indikera felet.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.