WebClient.UploadValues Methode

Definitie

Naamruimte:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Uploadt een naam/waardeverzameling naar een resource met de opgegeven URI.

Overloads

Name Description
UploadValues(String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI.
UploadValues(Uri, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI.
UploadValues(String, String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI, met behulp van de opgegeven methode.
UploadValues(Uri, String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI, met behulp van de opgegeven methode.

UploadValues(String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven 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()

Parameters

address
String

De URI van de resource om de verzameling te ontvangen.

data
NameValueCollection

De NameValueCollection te verzenden naar de resource.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

data is null.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

Er is een fout opgetreden tijdens het openen van de stream.

– of –

De Content-type header is niet null of 'application/x-www-form-urlencoded'.

Voorbeelden

Het volgende codevoorbeeld verzamelt gegevens van de gebruiker (naam, leeftijd en adres) en plaatst de waarden op de server met behulp van UploadValues. Elk antwoord van de server wordt weergegeven op de console.

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))

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadValues methode verzendt een NameValueCollection naar een server. Deze methode blokkeert tijdens het uploaden van de gegevens. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadValuesAsync server.

Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de header Inhoudstype is null, wordt deze door de UploadValues methode ingesteld op 'application/x-www-form-urlencoded'.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadValues(Uri, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven 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()

Parameters

address
Uri

De URI van de resource om de verzameling te ontvangen.

data
NameValueCollection

De NameValueCollection te verzenden naar de resource.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

data is null.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

Er is een fout opgetreden tijdens het openen van de stream.

– of –

De Content-type header is niet null of 'application/x-www-form-urlencoded'.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadValues methode verzendt een NameValueCollection naar een server. Deze methode blokkeert tijdens het uploaden van de gegevens. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadValuesAsync server.

Als de onderliggende aanvraag niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de header Inhoudstype is null, wordt deze door de UploadValues methode ingesteld op 'application/x-www-form-urlencoded'.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadValues(String, String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI, met behulp van de opgegeven methode.

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);
member this.UploadValues : string * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As String, method As String, data As NameValueCollection) As Byte()

Parameters

address
String

De URI van de resource om de verzameling te ontvangen.

method
String

De HTTP-methode die wordt gebruikt om het bestand naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.

data
NameValueCollection

De NameValueCollection te verzenden naar de resource.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

data is null.

– of –

Er is een fout opgetreden tijdens het openen van de stream.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type headerwaarde is niet null en is niet application/x-www-form-urlencoded.

Voorbeelden

Het volgende codevoorbeeld verzamelt gegevens van de gebruiker (naam, leeftijd en adres) en plaatst de waarden op de server met behulp van UploadValues. Elk antwoord van de server wordt weergegeven op de console.

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))

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadValues methode verzendt een NameValueCollection naar een resource met behulp van de methode die is opgegeven in de method parameter en retourneert een antwoord van de server. Deze methode blokkeert tijdens het uploaden van de gegevens. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadValuesAsync server.

Als de Content-type header is null, wordt deze door de UploadValues methode ingesteld op application/x-www-form-urlencoded.

Als de method parameter een werkwoord opgeeft dat niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadValues(Uri, String, NameValueCollection)

Uploadt de opgegeven naam/waardeverzameling naar de resource die is geïdentificeerd door de opgegeven URI, met behulp van de opgegeven methode.

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);
member this.UploadValues : Uri * string * System.Collections.Specialized.NameValueCollection -> byte[]
Public Function UploadValues (address As Uri, method As String, data As NameValueCollection) As Byte()

Parameters

address
Uri

De URI van de resource om de verzameling te ontvangen.

method
String

De HTTP-methode die wordt gebruikt om het bestand naar de resource te verzenden. Als null is, is de standaardwaarde POST voor http en STOR voor FTP.

data
NameValueCollection

De NameValueCollection te verzenden naar de resource.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De data parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

data is null.

– of –

Er is een fout opgetreden tijdens het openen van de stream.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type headerwaarde is niet null en is niet application/x-www-form-urlencoded.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadValues methode verzendt een NameValueCollection naar een resource met behulp van de methode die is opgegeven in de method parameter en retourneert een antwoord van de server. Deze methode blokkeert tijdens het uploaden van de gegevens. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadValuesAsync server.

Als de Content-type header is null, wordt deze door de UploadValues methode ingesteld op application/x-www-form-urlencoded.

Als de method parameter een werkwoord opgeeft dat niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op