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 halaman skrip atau ASP.

data
String

String yang akan diunggah.

Mengembalikan

String

yang String berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

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

Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan terus mengeksekusi sambil menunggu respons server, gunakan salah UploadStringAsync 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.

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

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

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 halaman skrip atau ASP.

data
String

String yang akan diunggah.

Mengembalikan

String

yang String berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan terus mengeksekusi sambil menunggu respons server, gunakan salah UploadStringAsync 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.

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

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

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 method metode .

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

yang String berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

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

Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan terus mengeksekusi sambil menunggu respons server, gunakan salah UploadStringAsync 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

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 method metode .

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

Yang String berisi respons yang dikirim oleh server.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya data adalah null.

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

Sebelum mengunggah string, metode ini mengonversinya menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Metode ini memblokir saat string ditransmisikan. Untuk mengirim string dan terus mengeksekusi sambil menunggu respons server, gunakan salah UploadStringAsync 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