WebClient.UploadData Methode

Definitie

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

Uploadt een gegevensbuffer naar een resource met de opgegeven URI.

Overloads

Name Description
UploadData(String, Byte[])

Uploadt een gegevensbuffer naar een resource die wordt geïdentificeerd door een URI.
UploadData(Uri, Byte[])

Uploadt een gegevensbuffer naar een resource die wordt geïdentificeerd door een URI.
UploadData(String, String, Byte[])

Uploadt een gegevensbuffer naar de opgegeven resource met behulp van de opgegeven methode.
UploadData(Uri, String, Byte[])

Uploadt een gegevensbuffer naar de opgegeven resource met behulp van de opgegeven methode.

UploadData(String, Byte[])

Uploadt een gegevensbuffer naar een resource die wordt geïdentificeerd door een URI.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData(string address, byte[] data);
member this.UploadData : string * byte[] -> byte[]
Public Function UploadData (address As String, data As Byte()) As Byte()

Parameters

address
String

De URI van de resource om de gegevens te ontvangen.

data
Byte[]

De gegevensbuffer die naar de resource moet worden verzonden.

Retouren

Byte[]

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

Uitzonderingen

ArgumentNullException

De address 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 verzenden van de gegevens.

– of –

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

Voorbeelden

In het volgende codevoorbeeld wordt een tekenreeks die vanuit de console is ingevoerd, geconverteerd naar een Byte matrix en wordt de matrix met behulp van UploadDatade opgegeven server naar de opgegeven server geplaatst. Elk antwoord van de server wordt weergegeven in 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;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
// Apply ASCII Encoding to obtain the String* as a Byte array.
array<Byte>^ postArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

//UploadData implicitly sets HTTP POST as the request method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, postArray );

// Decode and display the response.
Console::WriteLine( "\nResponse received was: {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();
    Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
    string postData = Console.ReadLine();
    // Apply ASCII Encoding to obtain the string as a byte array.
    byte[] postArray = Encoding.ASCII.GetBytes(postData);
    Console.WriteLine("Uploading to {0} ...",  uriString);							
 myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

    //UploadData implicitly sets HTTP POST as the request method.
    byte[] responseArray = myWebClient.UploadData(uriString,postArray);

    // Decode and display the response.
    Console.WriteLine("\nResponse received was :{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()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
' Apply ASCII Encoding to obtain the string as a byte array.
Dim postArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' UploadData implicitly sets HTTP POST as the request method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, postArray)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{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 UploadData methode verzendt een gegevensbuffer naar een resource.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt. 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.

De UploadData methode verzendt de inhoud van data de server zonder deze te coderen. 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 UploadDataAsync server.

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

UploadData(Uri, Byte[])

Uploadt een gegevensbuffer naar een resource die wordt geïdentificeerd door een URI.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, cli::array <System::Byte> ^ data);
public byte[] UploadData(Uri address, byte[] data);
member this.UploadData : Uri * byte[] -> byte[]
Public Function UploadData (address As Uri, data As Byte()) As Byte()

Parameters

address
Uri

De URI van de resource om de gegevens te ontvangen.

data
Byte[]

De gegevensbuffer die naar de resource moet worden verzonden.

Retouren

Byte[]

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

Uitzonderingen

ArgumentNullException

De address 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 verzenden van de gegevens.

– of –

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

Opmerkingen

Caution

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

De UploadData methode verzendt een gegevensbuffer naar een resource.

Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt. 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.

De UploadData methode verzendt de inhoud van data de server zonder deze te coderen. 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 UploadDataAsync server.

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

UploadData(String, String, Byte[])

Uploadt een gegevensbuffer naar de opgegeven resource met behulp van de opgegeven methode.

public:
 cli::array <System::Byte> ^ UploadData(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData(string address, string method, byte[] data);
member this.UploadData : string * string * byte[] -> byte[]
Public Function UploadData (address As String, method As String, data As Byte()) As Byte()

Parameters

address
String

De URI van de resource om de gegevens te ontvangen.

method
String

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

data
Byte[]

De gegevensbuffer die naar de resource moet worden verzonden.

Retouren

Byte[]

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

Uitzonderingen

ArgumentNullException

De address 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 uploaden van de gegevens.

– of –

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

Voorbeelden

In het volgende codevoorbeeld wordt een tekenreeks die vanuit de console is ingevoerd, geconverteerd naar een bytematrix en wordt de matrix met behulp van UploadDatade opgegeven server geplaatst. Elk antwoord van de server wordt weergegeven in de console.

String^ uriString;
Console::Write( "\nPlease enter the URI to post data to {for example, http://www.contoso.com}: " );
uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the data to be posted to the URI {0}:", uriString );
String^ postData = Console::ReadLine();
myWebClient->Headers->Add( "Content-Type", "application/x-www-form-urlencoded" );

// Displays the headers in the request
Console::Write( "Resulting Request Headers: ");
Console::WriteLine(myWebClient->Headers);

// Apply ASCII Encoding to obtain the String^ as a Byte array.
array<Byte>^ byteArray = Encoding::ASCII->GetBytes( postData );
Console::WriteLine( "Uploading to {0} ...", uriString );
// Upload the input String* using the HTTP 1.0 POST method.
array<Byte>^responseArray = myWebClient->UploadData( uriString, "POST", byteArray );
// Decode and display the response.
Console::WriteLine( "\nResponse received was {0}",
   Encoding::ASCII->GetString( responseArray ) );

   string uriString;
       Console.Write("\nPlease enter the URI to post data to {for example, http://www.contoso.com} : ");
       uriString = Console.ReadLine();

       // Create a new WebClient instance.
       WebClient myWebClient = new WebClient();
       Console.WriteLine("\nPlease enter the data to be posted to the URI {0}:",uriString);
       string postData = Console.ReadLine();
       myWebClient.Headers.Add("Content-Type","application/x-www-form-urlencoded");

 // Display the headers in the request
       Console.Write("Resulting Request Headers: ");
       Console.WriteLine(myWebClient.Headers.ToString());
       
       // Apply ASCII Encoding to obtain the string as a byte array.

       byte[] byteArray = Encoding.ASCII.GetBytes(postData);
       Console.WriteLine("Uploading to {0} ...",  uriString);						
       // Upload the input string using the HTTP 1.0 POST method.
       byte[] responseArray = myWebClient.UploadData(uriString,"POST",byteArray);
       
       // Decode and display the response.
       Console.WriteLine("\nResponse received was {0}",
       Encoding.ASCII.GetString(responseArray));
                 

Dim uriString As String
Console.Write(ControlChars.Cr + "Please enter the URI to post data to{for example, http://www.contoso.com} : ")
uriString = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the URI {0}:", uriString)
Dim postData As String = Console.ReadLine()
myWebClient.Headers.Add("Content-Type", "application/x-www-form-urlencoded")

' Display the headers in the request
Console.Write("Resulting Request Headers: ")
Console.Writeline(myWebClient.Headers.ToString())

' Apply ASCII Encoding to obtain the string as a byte array.
Dim byteArray As Byte() = Encoding.ASCII.GetBytes(postData)
Console.WriteLine("Uploading to {0} ...", uriString)
' Upload the input string using the HTTP 1.0 POST method.
Dim responseArray As Byte() = myWebClient.UploadData(uriString, "POST", byteArray)
' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response received was :{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 UploadData methode verzendt een gegevensbuffer naar een resource met behulp van de HTTP-methode die is opgegeven in de method parameter en retourneert eventuele reacties 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 UploadDataAsync server.

De UploadData methode verzendt de inhoud van data de server zonder deze te coderen.

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

UploadData(Uri, String, Byte[])

Uploadt een gegevensbuffer naar de opgegeven resource met behulp van de opgegeven methode.

public:
 cli::array <System::Byte> ^ UploadData(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public byte[] UploadData(Uri address, string method, byte[] data);
member this.UploadData : Uri * string * byte[] -> byte[]
Public Function UploadData (address As Uri, method As String, data As Byte()) As Byte()

Parameters

address
Uri

De URI van de resource om de gegevens te ontvangen.

method
String

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

data
Byte[]

De gegevensbuffer die naar de resource moet worden verzonden.

Retouren

Byte[]

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

Uitzonderingen

ArgumentNullException

De address 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 uploaden van de gegevens.

– of –

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

Opmerkingen

Caution

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

De UploadData methode verzendt een gegevensbuffer naar een resource met behulp van de HTTP-methode die is opgegeven in de method parameter en retourneert eventuele reacties 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 UploadDataAsync server.

De UploadData methode verzendt de inhoud van data de server zonder deze te coderen.

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