WebClient.UploadFile Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunggah file lokal ke sumber daya dengan URI yang ditentukan.

Overload

UploadFile(String, String)	Mengunggah file lokal yang ditentukan ke sumber daya dengan URI yang ditentukan.
UploadFile(Uri, String)	Mengunggah file lokal yang ditentukan ke sumber daya dengan URI yang ditentukan.
UploadFile(String, String, String)	Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.
UploadFile(Uri, String, String)	Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

UploadFile(String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya dengan URI yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ fileName);

public byte[] UploadFile (string address, string fileName);

member this.UploadFile : string * string -> byte[]

Public Function UploadFile (address As String, fileName As String) As Byte()

Parameter

address

String

URI sumber daya untuk menerima file. Misalnya, ftp://localhost/samplefile.txt.

fileName

String

File yang akan dikirim ke sumber daya. Misalnya, "samplefile.txt".

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

fileName null, Empty, berisi karakter yang tidak valid, atau tidak ada.

-atau-

Terjadi kesalahan saat mengunggah file.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Contoh

Contoh kode berikut mengunggah file yang ditentukan ke URI yang ditentukan menggunakan UploadFile. Respons apa pun yang dikembalikan oleh server ditampilkan di 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 fully qualified path of the file to be uploaded to the URI" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URI.
// The 'UploadFile(uriString, fileName)' method implicitly uses HTTP POST method.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::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 fully qualified path of the file to be uploaded to the URI");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);

// Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = myWebClient.UploadFile(uriString,fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}", 
    System.Text.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 fully qualified path of the file to be uploaded to the URI")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the URI.
' The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method. 
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr & "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

Contoh kode berikut menunjukkan halaman ASP.NET yang dapat menerima file yang diposting dan cocok untuk digunakan dengan metode UploadFile. Halaman harus berada di server Web. Alamatnya memberikan nilai untuk parameter address metode UploadFile.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

Keterangan

Hati

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

Metode UploadFile mengirim file lokal ke sumber daya. Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Metode ini memblokir saat mengunggah file. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadFileAsync.

Metode POST didefinisikan oleh HTTP. Jika permintaan yang mendasar tidak menggunakan HTTP dan POST tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

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.

UploadFile(Uri, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya dengan URI yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ fileName);

public byte[] UploadFile (Uri address, string fileName);

member this.UploadFile : Uri * string -> byte[]

Public Function UploadFile (address As Uri, fileName As String) As Byte()

Parameter

address

Uri

URI sumber daya untuk menerima file. Misalnya, ftp://localhost/samplefile.txt.

fileName

String

File yang akan dikirim ke sumber daya. Misalnya, "samplefile.txt".

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

fileName null, Empty, berisi karakter yang tidak valid, atau tidak ada.

-atau-

Terjadi kesalahan saat mengunggah file.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Hati

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

Metode UploadFile mengirim file lokal ke sumber daya. Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Metode ini memblokir saat mengunggah file. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadFileAsync.

Metode POST didefinisikan oleh HTTP. Jika permintaan yang mendasar tidak menggunakan HTTP dan POST tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

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.

UploadFile(String, String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::String ^ fileName);

public byte[] UploadFile (string address, string? method, string fileName);

member this.UploadFile : string * string * string -> byte[]

Public Function UploadFile (address As String, method As String, fileName As String) As Byte()

Parameter

address

String

URI sumber daya untuk menerima file.

method

String

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

fileName

String

File yang akan dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

fileName null, Empty, berisi karakter yang tidak valid, atau tidak ada.

-atau-

Terjadi kesalahan saat mengunggah file.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Contoh

Contoh kode berikut mengunggah file yang ditentukan ke URI yang ditentukan menggunakan UploadFile. Respons apa pun yang dikembalikan oleh server ditampilkan di konsol.

Console::Write( "\nPlease enter the URL to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine
    ("\nPlease enter the fully qualified path of the file to be uploaded to the URL" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URL using the HTTP 1.0 POST.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, "POST", fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ));

Console.Write("\nPlease enter the URL to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URL");
string fileName = Console.ReadLine();

Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);						
// Upload the file to the URL using the HTTP 1.0 POST.
byte[] responseArray = myWebClient.UploadFile(uriString,"POST",fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}",
    System.Text.Encoding.ASCII.GetString(responseArray));

Console.Write(ControlChars.Cr + "Please enter the URL 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 fully qualified path of the file to be uploaded to the URL")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the Url using the HTTP 1.0 POST.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, "POST", fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

Contoh kode berikut menunjukkan halaman ASP.NET yang dapat menerima file yang diposting dan cocok untuk digunakan dengan metode UploadFile. Halaman harus berada di server Web. Alamatnya memberikan nilai untuk parameter address metode UploadFile.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

Keterangan

Hati

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

Ketika alamat menentukan sumber daya HTTP, metode UploadFile mengirim file lokal ke sumber daya menggunakan metode HTTP yang ditentukan dalam parameter method dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah file. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadFileAsync.

Jika parameter method menentukan kata kerja yang tidak dipahami oleh server atau sumber daya address, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

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.

UploadFile(Uri, String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya yang ditentukan, menggunakan metode yang ditentukan.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::String ^ fileName);

public byte[] UploadFile (Uri address, string? method, string fileName);

member this.UploadFile : Uri * string * string -> byte[]

Public Function UploadFile (address As Uri, method As String, fileName As String) As Byte()

Parameter

address

Uri

URI sumber daya untuk menerima file.

method

String

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

fileName

String

File yang akan dikirim ke sumber daya.

Mengembalikan

Byte[]

Array Byte yang berisi isi respons dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, dan address tidak valid.

-atau-

fileName null, Empty, berisi karakter yang tidak valid, atau tidak ada.

-atau-

Terjadi kesalahan saat mengunggah file.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Hati

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

Ketika alamat menentukan sumber daya HTTP, metode UploadFile mengirim file lokal ke sumber daya menggunakan metode HTTP yang ditentukan dalam parameter method dan mengembalikan respons apa pun dari server. Metode ini memblokir saat mengunggah file. Untuk terus mengeksekusi sambil menunggu respons server, gunakan salah satu metode UploadFileAsync.

Jika parameter method menentukan kata kerja yang tidak dipahami oleh server atau sumber daya address, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

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.