WebClient.UploadFile Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Belirtilen URI'ye sahip bir kaynağa yerel dosya yükler.

Aşırı Yüklemeler

Name	Description
UploadFile(String, String)	Belirtilen yerel dosyayı belirtilen URI'ye sahip bir kaynağa yükler.
UploadFile(Uri, String)	Belirtilen yerel dosyayı belirtilen URI'ye sahip bir kaynağa yükler.
UploadFile(String, String, String)	Belirtilen yerel dosyayı belirtilen yöntemi kullanarak belirtilen kaynağa yükler.
UploadFile(Uri, String, String)	Belirtilen yerel dosyayı belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

UploadFile(String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı belirtilen URI'ye sahip bir kaynağa yükler.

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

Parametreler

address

String

Dosyayı alacak kaynağın URI'sini. Örneğin, ftp://localhost/samplefile.txt.

fileName

String

Kaynağa gönderilecek dosya. Örneğin, "samplefile.txt".

Döndürülenler

Byte[]

Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

ve birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileName is null, is Empty, geçersiz karakterler içeriyor veya yok.

-veya-

Dosya karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

-veya-

Content-type Üst bilgi ile multipartbaşlar.

Örnekler

Aşağıdaki kod örneği, kullanarak UploadFilebelirtilen dosyayı belirtilen URI'ye yükler. Sunucu tarafından döndürülen tüm yanıtlar konsolda görüntülenir.

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

Aşağıdaki kod örneği, postalanan dosyaları kabul edebilen ve yöntemiyle UploadFile kullanıma uygun bir ASP.NET sayfası gösterir. Sayfa bir Web sunucusunda bulunmalıdır. Adresi, yönteminin address parametresinin UploadFile değerini sağlar.

<%@ 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>

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi kaynağa UploadFile yerel bir dosya gönderir. Bu yöntem bir FTP kaynağını karşıya yüklemek için STOR komutunu kullanır. BIR HTTP kaynağı için POST yöntemi kullanılır.

Bu yöntem dosyayı karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini UploadFileAsync kullanın.

POST yöntemi HTTP tarafından tanımlanır. Temel alınan istek HTTP kullanmıyorsa ve POST sunucu tarafından anlaşılmıyorsa, ne olduğunu temel alınan protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

UploadFile(Uri, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı belirtilen URI'ye sahip bir kaynağa yükler.

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

Parametreler

address

Uri

Dosyayı alacak kaynağın URI'sini. Örneğin, ftp://localhost/samplefile.txt.

fileName

String

Kaynağa gönderilecek dosya. Örneğin, "samplefile.txt".

Döndürülenler

Byte[]

Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

ve birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileName is null, is Empty, geçersiz karakterler içeriyor veya yok.

-veya-

Dosya karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

-veya-

Content-type Üst bilgi ile multipartbaşlar.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi kaynağa UploadFile yerel bir dosya gönderir. Bu yöntem bir FTP kaynağını karşıya yüklemek için STOR komutunu kullanır. BIR HTTP kaynağı için POST yöntemi kullanılır.

Bu yöntem dosyayı karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini UploadFileAsync kullanın.

POST yöntemi HTTP tarafından tanımlanır. Temel alınan istek HTTP kullanmıyorsa ve POST sunucu tarafından anlaşılmıyorsa, ne olduğunu temel alınan protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

UploadFile(String, String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

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

Parametreler

address

String

Dosyayı alacak kaynağın URI'sini.

method

String

Dosyayı kaynağa göndermek için kullanılan yöntem. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

fileName

String

Kaynağa gönderilecek dosya.

Döndürülenler

Byte[]

Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

ve birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileName is null, is Empty, geçersiz karakterler içeriyor veya yok.

-veya-

Dosya karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

-veya-

Content-type Üst bilgi ile multipartbaşlar.

Örnekler

Aşağıdaki kod örneği, kullanarak UploadFilebelirtilen dosyayı belirtilen URI'ye yükler. Sunucu tarafından döndürülen tüm yanıtlar konsolda görüntülenir.

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

Aşağıdaki kod örneği, postalanan dosyaları kabul edebilen ve yöntemiyle UploadFile kullanıma uygun bir ASP.NET sayfası gösterir. Sayfa bir Web sunucusunda bulunmalıdır. Adresi, yönteminin address parametresinin UploadFile değerini sağlar.

<%@ 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>

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Adres bir HTTP kaynağı belirttiğinde UploadFile , yöntemi parametresinde method belirtilen HTTP yöntemini kullanarak kaynağa yerel bir dosya gönderir ve sunucudan herhangi bir yanıt döndürür. Bu yöntem dosyayı karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini UploadFileAsync kullanın.

method parametresi sunucu veya address kaynak tarafından anlaşılmayan bir fiil belirtirse, ne olduğunu temel protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

UploadFile(Uri, String, String)

Kaynak:

WebClient.cs

Belirtilen yerel dosyayı belirtilen yöntemi kullanarak belirtilen kaynağa yükler.

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

Parametreler

address

Uri

Dosyayı alacak kaynağın URI'sini.

method

String

Dosyayı kaynağa göndermek için kullanılan yöntem. ise null, varsayılan değer http için POST ve ftp için STOR'dır.

fileName

String

Kaynağa gönderilecek dosya.

Döndürülenler

Byte[]

Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

ve birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileName is null, is Empty, geçersiz karakterler içeriyor veya yok.

-veya-

Dosya karşıya yüklenirken bir hata oluştu.

-veya-

Kaynağı barındıran sunucudan yanıt alınmadı.

-veya-

Content-type Üst bilgi ile multipartbaşlar.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

Adres bir HTTP kaynağı belirttiğinde UploadFile , yöntemi parametresinde method belirtilen HTTP yöntemini kullanarak kaynağa yerel bir dosya gönderir ve sunucudan herhangi bir yanıt döndürür. Bu yöntem dosyayı karşıya yüklerken engeller. Sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini UploadFileAsync kullanın.

method parametresi sunucu veya address kaynak tarafından anlaşılmayan bir fiil belirtirse, ne olduğunu temel protokol sınıfları belirler. Genellikle, hata belirtmek Status için özelliği ayarlanmış bir WebException oluşturulur.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.