WebClient.UploadFile Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen URI'ye sahip bir kaynağa yerel bir dosya yükler.
Aşırı Yüklemeler
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
- Kaynak:
- WebClient.cs
- 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'si. Örneğin, ftp://localhost/samplefile.txt.
- fileName
- String
Kaynağa gönderilecek dosya. Örneğin, "samplefile.txt".
Döndürülenler
Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.
Özel durumlar
ve address
birleştirilerek BaseAddressoluş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-
Üst Content-type
bilgi ile multipart
baş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ını 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
UploadFile yöntemi kaynağa 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 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.
Şunlara uygulanır
UploadFile(Uri, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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'si. Örneğin, ftp://localhost/samplefile.txt.
- fileName
- String
Kaynağa gönderilecek dosya. Örneğin, "samplefile.txt".
Döndürülenler
Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.
Özel durumlar
ve address
birleştirilerek BaseAddressoluş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-
Üst Content-type
bilgi ile multipart
başlar.
Açıklamalar
UploadFile yöntemi kaynağa 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 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.
Şunlara uygulanır
UploadFile(String, String, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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);
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'si.
- method
- String
Dosyayı kaynağa göndermek için kullanılan yöntem. ise null
, http için POST ve ftp için STOR varsayılandır.
- fileName
- String
Kaynağa gönderilecek dosya.
Döndürülenler
Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.
Özel durumlar
ve address
birleştirilerek BaseAddressoluş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-
Üst Content-type
bilgi ile multipart
baş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ını 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
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 belirtiyorsa, 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.
Şunlara uygulanır
UploadFile(Uri, String, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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);
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'si.
- method
- String
Dosyayı kaynağa göndermek için kullanılan yöntem. ise null
, http için POST ve ftp için STOR varsayılandır.
- fileName
- String
Kaynağa gönderilecek dosya.
Döndürülenler
Byte Kaynaktan gelen yanıtın gövdesini içeren bir dizi.
Özel durumlar
ve address
birleştirilerek BaseAddressoluş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-
Üst Content-type
bilgi ile multipart
başlar.
Açıklamalar
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 belirtiyorsa, 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
Not
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin