Bagikan melalui

WebClient.UploadString Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.WebClient.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Mengunggah string yang ditentukan ke sumber daya yang ditentukan.

Overload

UploadString(String, String)

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST.
UploadString(Uri, String)

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST.
UploadString(String, String, String)

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
UploadString(Uri, String, String)

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

UploadString(String, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ data);
public string UploadString (string address, string data);
member this.UploadString : string * string -> string
Public Function UploadString (address As String, data As String) As String

Parameter

address
String

URI sumber daya untuk menerima string. Untuk sumber daya Http, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti skrip atau halaman ASP.

data
String

String yang akan diunggah.

Mengembalikan

String

String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Contoh

Contoh kode berikut menunjukkan panggilan metode ini.

void UploadString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   WebClient^ client = gcnew WebClient;

   // Optionally specify an encoding for uploading and downloading strings.
   client->Encoding = System::Text::Encoding::UTF8;

   // Upload the data.
   String^ reply = client->UploadString( address, data );

   // Disply the server's response.
   Console::WriteLine( reply );
}

public static void UploadString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    WebClient client = new WebClient();
    // Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8;
    // Upload the data.
    string reply = client.UploadString(address, data);
    // Display the server's response.
    Console.WriteLine(reply);
}

Public Shared Sub UploadString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim client As WebClient = New WebClient()
    '  Optionally specify an encoding for uploading and downloading strings.
    client.Encoding = System.Text.Encoding.UTF8
    '  Upload the data.
    Dim reply As String = client.UploadString(address, data)
    '  Disply the server's response.
    Console.WriteLine(reply)
End Sub

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode UploadStringAsync.

Jika properti BaseAddress bukan string kosong (""), dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadString(Uri, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode POST.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ data);
public string UploadString (Uri address, string data);
member this.UploadString : Uri * string -> string
Public Function UploadString (address As Uri, data As String) As String

Parameter

address
Uri

URI sumber daya untuk menerima string. Untuk sumber daya Http, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti skrip atau halaman ASP.

data
String

String yang akan diunggah.

Mengembalikan

String

String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode UploadStringAsync.

Jika properti BaseAddress bukan string kosong (""), dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadString(String, String, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

public:
 System::String ^ UploadString(System::String ^ address, System::String ^ method, System::String ^ data);
public string UploadString (string address, string? method, string data);
public string UploadString (string address, string method, string data);
member this.UploadString : string * string * string -> string
Public Function UploadString (address As String, method As String, data As String) As String

Parameter

address
String

URI sumber daya untuk menerima string. URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode method.

method
String

Metode HTTP yang digunakan untuk mengirim string ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
String

String yang akan diunggah.

Mengembalikan

String

String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

method tidak dapat digunakan untuk mengirim isi.

Contoh

Contoh kode berikut menunjukkan panggilan metode ini.

void PostString( String^ address )
{
   String^ data = "Time = 12:00am temperature = 50";
   String^ method = "POST";
   WebClient^ client = gcnew WebClient;
   String^ reply = client->UploadString( address, method, data );
   Console::WriteLine( reply );
}

public static void PostString(string address)
{
    string data = "Time = 12:00am temperature = 50";
    string method = "POST";
    WebClient client = new WebClient();
    string reply = client.UploadString(address, method, data);

    Console.WriteLine(reply);
}

Public Shared Sub PostString(ByVal address As String)

    Dim data As String = "Time = 12:00am temperature = 50"
    Dim method As String = "POST"
    Dim client As WebClient = New WebClient()
    Dim reply As String = client.UploadString(address, method, data)

    Console.WriteLine(reply)
End Sub

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode UploadStringAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk

UploadString(Uri, String, String)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah string yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

public:
 System::String ^ UploadString(Uri ^ address, System::String ^ method, System::String ^ data);
public string UploadString (Uri address, string? method, string data);
public string UploadString (Uri address, string method, string data);
member this.UploadString : Uri * string * string -> string
Public Function UploadString (address As Uri, method As String, data As String) As String

Parameter

address
Uri

URI sumber daya untuk menerima string. URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode method.

method
String

Metode HTTP yang digunakan untuk mengirim string ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
String

String yang akan diunggah.

Mengembalikan

String

String yang berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

method tidak dapat digunakan untuk mengirim isi.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode UploadStringAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk