WebClient.UploadData Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengunggah buffer data ke sumber daya dengan URI yang ditentukan.
Overload
UploadData(String, Byte[]) |
Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI. |
UploadData(Uri, Byte[]) |
Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI. |
UploadData(String, String, Byte[]) |
Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan. |
UploadData(Uri, String, Byte[]) |
Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan. |
UploadData(String, Byte[])
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunggah buffer data ke sumber daya yang diidentifikasi oleh 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()
Parameter
- address
- String
URI sumber daya untuk menerima data.
- data
- Byte[]
Buffer data untuk dikirim ke sumber daya.
Mengembalikan
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress, dan address
tidak valid.
-atau-
data
adalah null
.
-atau-
Terjadi kesalahan saat mengirim data.
-atau-
Tidak ada respons dari server yang menghosting sumber daya.
Contoh
Contoh kode berikut mengonversi string yang dimasukkan dari konsol ke Byte array dan memposting array ke server yang ditentukan menggunakan UploadData. Respons apa pun dari server ditampilkan ke konsol.
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))
Keterangan
Metode mengirimkan UploadData buffer data ke sumber daya.
Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan. Jika permintaan yang mendasar tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.
Metode UploadData mengirimkan konten data
ke server tanpa mengodekannya. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadDataAsync satu metode.
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
UploadData(Uri, Byte[])
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunggah buffer data ke sumber daya yang diidentifikasi oleh 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()
Parameter
- address
- Uri
URI sumber daya untuk menerima data.
- data
- Byte[]
Buffer data untuk dikirim ke sumber daya.
Mengembalikan
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress, dan address
tidak valid.
-atau-
data
adalah null
.
-atau-
Terjadi kesalahan saat mengirim data.
-atau-
Tidak ada respons dari server yang menghosting sumber daya.
Keterangan
Metode mengirimkan UploadData buffer data ke sumber daya.
Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan. Jika permintaan yang mendasar tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.
Metode UploadData mengirimkan konten data
ke server tanpa mengodekannya. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadDataAsync satu metode.
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
UploadData(String, String, Byte[])
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
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);
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()
Parameter
- address
- String
URI sumber daya untuk menerima data.
- method
- String
Metode HTTP yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.
- data
- Byte[]
Buffer data untuk dikirim ke sumber daya.
Mengembalikan
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress, dan address
tidak valid.
-atau-
data
adalah null
.
-atau-
Terjadi kesalahan saat mengunggah data.
-atau-
Tidak ada respons dari server yang menghosting sumber daya.
Contoh
Contoh kode berikut mengonversi string yang dimasukkan dari konsol menjadi array byte dan memposting array ke server yang ditentukan menggunakan UploadData. Respons apa pun dari server ditampilkan ke konsol.
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))
Keterangan
Metode mengirim UploadData buffer data ke sumber daya menggunakan metode HTTP yang ditentukan dalam method
parameter , dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadDataAsync satu metode.
Metode UploadData mengirimkan konten data
ke server tanpa mengodekannya.
method
Jika parameter menentukan kata kerja yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
UploadData(Uri, String, Byte[])
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunggah buffer data ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
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);
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()
Parameter
- address
- Uri
URI sumber daya untuk menerima data.
- method
- String
Metode HTTP yang digunakan untuk mengirim data ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.
- data
- Byte[]
Buffer data untuk dikirim ke sumber daya.
Mengembalikan
Array Byte yang berisi isi respons dari sumber daya.
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress, dan address
tidak valid.
-atau-
data
adalah null
.
-atau-
Terjadi kesalahan saat mengunggah data.
-atau-
Tidak ada respons dari server yang menghosting sumber daya.
Keterangan
Metode UploadData mengirim buffer data ke sumber daya menggunakan metode HTTP yang ditentukan dalam method
parameter , dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah data. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah UploadDataAsync satu metode .
Metode UploadData mengirimkan konten data
ke server tanpa mengodekannya.
method
Jika parameter menentukan kata kerja yang tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang Status diatur untuk menunjukkan kesalahan.
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk