WebClient.UploadData Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Feltölt egy adatpuffert egy erőforrásba a megadott URI-val.

Túlterhelések

Name	Description
UploadData(String, Byte[])	Feltölt egy adatpuffert egy URI által azonosított erőforrásba.
UploadData(Uri, Byte[])	Feltölt egy adatpuffert egy URI által azonosított erőforrásba.
UploadData(String, String, Byte[])	Feltölt egy adatpuffert a megadott erőforrásba a megadott módszerrel.
UploadData(Uri, String, Byte[])	Feltölt egy adatpuffert a megadott erőforrásba a megadott módszerrel.

UploadData(String, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert egy URI által azonosított erőforrásba.

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

Paraméterek

address

String

Az erőforrás URI-ja az adatok fogadásához.

data

Byte[]

Az erőforrásnak küldendő adatpuffer.

Válaszok

Byte[]

Az Byte erőforrás válaszának törzsét tartalmazó tömb.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

data az null.

-vagy-

Hiba történt az adatok küldése közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Példák

Az alábbi példakód egy, a konzolról beírt sztringet tömbzé Byte konvertál, és a tömböt a megadott kiszolgálóra alakítja a használatával UploadData. A kiszolgáló válaszai megjelennek a konzolon.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A UploadData metódus adatpuffert küld egy erőforrásnak.

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer. Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

A UploadData metódus kódolás nélkül küldi data el a kiszolgálónak a tartalmat. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadDataAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadData(Uri, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert egy URI által azonosított erőforrásba.

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

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

data

Byte[]

Az erőforrásnak küldendő adatpuffer.

Válaszok

Byte[]

Az Byte erőforrás válaszának törzsét tartalmazó tömb.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

data az null.

-vagy-

Hiba történt az adatok küldése közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A UploadData metódus adatpuffert küld egy erőforrásnak.

Ez a metódus a STOR paranccsal tölt fel egy FTP-erőforrást. HTTP-erőforrás esetén a POST metódust használja a rendszer. Ha a mögöttes kérést nem érti a kiszolgáló, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

A UploadData metódus kódolás nélkül küldi data el a kiszolgálónak a tartalmat. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadDataAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadData(String, String, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

String

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

Byte[]

Az erőforrásnak küldendő adatpuffer.

Válaszok

Byte[]

Az Byte erőforrás válaszának törzsét tartalmazó tömb.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

data az null.

-vagy-

Hiba történt az adatok feltöltése közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Példák

Az alábbi példakód egy, a konzolról beírt sztringet bájttömbzé alakítja, és a tömböt a megadott kiszolgálóra alakítja a használatával UploadData. A kiszolgáló válaszai megjelennek a konzolon.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A UploadData metódus a paraméterben method megadott HTTP-metódussal adatpuffert küld egy erőforrásnak, és a kiszolgálótól érkező válaszokat adja vissza. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadDataAsync .

A UploadData metódus kódolás nélkül küldi data el a kiszolgálónak a tartalmat.

Ha a method paraméter olyan igét ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

UploadData(Uri, String, Byte[])

Forrás:

WebClient.cs

Feltölt egy adatpuffert a megadott erőforrásba a megadott módszerrel.

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

Paraméterek

address

Uri

Az erőforrás URI-ja az adatok fogadásához.

method

String

Az adatok erőforrásba való küldéséhez használt HTTP-metódus. Null érték esetén az alapértelmezett érték a POST a http és az ftp STOR esetében.

data

Byte[]

Az erőforrásnak küldendő adatpuffer.

Válaszok

Byte[]

Az Byte erőforrás válaszának törzsét tartalmazó tömb.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

data az null.

-vagy-

Hiba történt az adatok feltöltése közben.

-vagy-

Nem érkezett válasz az erőforrást üzemeltető kiszolgálótól.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

A UploadData metódus a paraméterben method megadott HTTP-metódussal adatpuffert küld egy erőforrásnak, és a kiszolgálótól érkező válaszokat adja vissza. Ez a metódus letiltja az adatok feltöltését. Ha a kiszolgáló válaszára várva szeretné folytatni a végrehajtást, használja az egyik metódust UploadDataAsync .

A UploadData metódus kódolás nélkül küldi data el a kiszolgálónak a tartalmat.

Ha a method paraméter olyan igét ad meg, amelyet a kiszolgáló nem ért meg, a mögöttes protokollosztályok határozzák meg, hogy mi történik. A rendszer általában a WebException hibát jelző tulajdonsággal Status dob egy értéket.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.