FileUpload Sınıf
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.
Kullanıcıların sunucuya yüklenecek dosyayı seçmesini sağlayan bir metin kutusu denetimi ve göz atma düğmesi görüntüler.
public ref class FileUpload : System::Web::UI::WebControls::WebControl[System.Web.UI.ControlValueProperty("FileBytes")]
[System.Web.UI.ValidationProperty("FileName")]
public class FileUpload : System.Web.UI.WebControls.WebControl[<System.Web.UI.ControlValueProperty("FileBytes")>]
[<System.Web.UI.ValidationProperty("FileName")>]
type FileUpload = class
inherit WebControlPublic Class FileUpload
Inherits WebControl- Devralma
- Öznitelikler
Örnekler
Kaynak kodu içeren bir Visual Studio Web sitesi projesi şu konuya eşlik edebilir: İndirme.
Bu bölümde aşağıdaki dört örnek yer alır:
İlk örnekte, dosyaları kodda belirtilen bir FileUpload yola kaydeden bir denetimin nasıl oluşturulacağı gösterilmektedir.
İkinci örnek, dosyaları uygulama için dosya sisteminde belirtilen bir dizine kaydeden bir FileUpload denetimin nasıl oluşturulacağını gösterir.
Üçüncü örnek, dosyaları belirtilen yola kaydeden ve karşıya yüklenebilecek dosyanın boyutunu sınırlayan bir FileUpload denetimin nasıl oluşturulacağını gösterir.
Dördüncü örnek, dosyaları belirtilen yola FileUpload kaydeden ve yalnızca .doc veya .xls dosya adı uzantılarının karşıya yüklenmesine izin veren bir denetimin nasıl oluşturulacağını gösterir.
Dikkat
Bu örnekler denetimin temel söz dizimini FileUpload gösterir, ancak dosyayı kaydetmeden önce tamamlanması gereken tüm hata denetimini göstermez. Daha eksiksiz bir örnek için bkz SaveAs. .
Aşağıdaki örnekte, dosyaları kodda belirtilen bir yola kaydeden bir FileUpload denetimin nasıl oluşturulacağı gösterilmektedir. SaveAs yöntemi, dosyayı sunucuda belirtilen yola kaydetmek için çağrılır.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void UploadButton_Click(object sender, EventArgs e)
{
// Specify the path on the server to
// save the uploaded file to.
String savePath = @"c:\temp\uploads\";
// Before attempting to perform operations
// on the file, verify that the FileUpload
// control contains a file.
if (FileUpload1.HasFile)
{
// Get the name of the file to upload.
String fileName = FileUpload1.FileName;
// Append the name of the file to upload to the path.
savePath += fileName;
// Call the SaveAs method to save the
// uploaded file to the specified path.
// This example does not perform all
// the necessary error checking.
// If a file with the same name
// already exists in the specified path,
// the uploaded file overwrites it.
FileUpload1.SaveAs(savePath);
// Notify the user of the name of the file
// was saved under.
UploadStatusLabel.Text = "Your file was saved as " + fileName;
}
else
{
// Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br /><br />
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub UploadButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
' Specify the path on the server to
' save the uploaded file to.
Dim savePath As String = "c:\temp\uploads\"
' Before attempting to perform operations
' on the file, verify that the FileUpload
' control contains a file.
If (FileUpload1.HasFile) Then
' Get the name of the file to upload.
Dim fileName As String = FileUpload1.FileName
' Append the name of the file to upload to the path.
savePath += fileName
' Call the SaveAs method to save the
' uploaded file to the specified path.
' This example does not perform all
' the necessary error checking.
' If a file with the same name
' already exists in the specified path,
' the uploaded file overwrites it.
FileUpload1.SaveAs(savePath)
' Notify the user of the name the file
' was saved under.
UploadStatusLabel.Text = "Your file was saved as " & fileName
Else
' Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br /><br />
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
Aşağıdaki örnekte, dosyaları uygulama için dosya sisteminde belirtilen bir dizine kaydeden bir FileUpload denetimin nasıl oluşturulacağı gösterilmektedir. HttpRequest.PhysicalApplicationPath özelliği, şu anda yürütülen sunucu uygulaması için kök dizinin fiziksel dosya sistemi yolunu almak için kullanılır. SaveAs yöntemi, dosyayı sunucuda belirtilen yola kaydetmek için çağrılır.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void UploadButton_Click(object sender, EventArgs e)
{
// Save the uploaded file to an "Uploads" directory
// that already exists in the file system of the
// currently executing ASP.NET application.
// Creating an "Uploads" directory isolates uploaded
// files in a separate directory. This helps prevent
// users from overwriting existing application files by
// uploading files with names like "Web.config".
string saveDir = @"\Uploads\";
// Get the physical file system path for the currently
// executing application.
string appPath = Request.PhysicalApplicationPath;
// Before attempting to save the file, verify
// that the FileUpload control contains a file.
if (FileUpload1.HasFile)
{
string savePath = appPath + saveDir +
Server.HtmlEncode(FileUpload1.FileName);
// Call the SaveAs method to save the
// uploaded file to the specified path.
// This example does not perform all
// the necessary error checking.
// If a file with the same name
// already exists in the specified path,
// the uploaded file overwrites it.
FileUpload1.SaveAs(savePath);
// Notify the user that the file was uploaded successfully.
UploadStatusLabel.Text = "Your file was uploaded successfully.";
}
else
{
// Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<h3>FileUpload Class Example: Save To Application Directory</h3>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub UploadButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
' Save the uploaded file to an "Uploads" directory
' that already exists in the file system of the
' currently executing ASP.NET application.
' Creating an "Uploads" directory isolates uploaded
' files in a separate directory. This helps prevent
' users from overwriting existing application files by
' uploading files with names like "Web.config".
Dim saveDir As String = "\Uploads\"
' Get the physical file system path for the currently
' executing application.
Dim appPath As String = Request.PhysicalApplicationPath
' Before attempting to save the file, verify
' that the FileUpload control contains a file.
If (FileUpload1.HasFile) Then
Dim savePath As String = appPath + saveDir + _
Server.HtmlEncode(FileUpload1.FileName)
' Call the SaveAs method to save the
' uploaded file to the specified path.
' This example does not perform all
' the necessary error checking.
' If a file with the same name
' already exists in the specified path,
' the uploaded file overwrites it.
FileUpload1.SaveAs(savePath)
' Notify the user that the file was uploaded successfully.
UploadStatusLabel.Text = "Your file was uploaded successfully."
Else
' Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<h3>FileUpload Class Example: Save To Application Directory</h3>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
Aşağıdaki örnekte, dosyaları kodda belirtilen bir FileUpload yola kaydeden bir denetimin nasıl oluşturulacağı gösterilmektedir. Denetim, karşıya yüklenebilecek dosyanın boyutunu 2 MB ile sınırlar. PostedFile özelliği, temel alınan ContentLength özelliğe erişmek ve dosyanın boyutunu döndürmek için kullanılır. Karşıya yüklenecek dosyanın boyutu 2 MB'tan azsa, SaveAs dosyayı sunucuda belirtilen yola kaydetmek için yöntemi çağrılır. Uygulama kodunuzda en yüksek dosya boyutu ayarını denetlemeye ek olarak, httpRuntime öğesinin özniteliğini uygulamanızın yapılandırma dosyasında izin verilen en büyük boyuta ayarlayabilirsinizmaxRequestLength.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void UploadButton_Click(object sender, EventArgs e)
{
// Specify the path on the server to
// save the uploaded file to.
string savePath = @"c:\temp\uploads\";
// Before attempting to save the file, verify
// that the FileUpload control contains a file.
if (FileUpload1.HasFile)
{
// Get the size in bytes of the file to upload.
int fileSize = FileUpload1.PostedFile.ContentLength;
// Allow only files less than 2,100,000 bytes (approximately 2 MB) to be uploaded.
if (fileSize < 2100000)
{
// Append the name of the uploaded file to the path.
savePath += Server.HtmlEncode(FileUpload1.FileName);
// Call the SaveAs method to save the
// uploaded file to the specified path.
// This example does not perform all
// the necessary error checking.
// If a file with the same name
// already exists in the specified path,
// the uploaded file overwrites it.
FileUpload1.SaveAs(savePath);
// Notify the user that the file was uploaded successfully.
UploadStatusLabel.Text = "Your file was uploaded successfully.";
}
else
{
// Notify the user why their file was not uploaded.
UploadStatusLabel.Text = "Your file was not uploaded because " +
"it exceeds the 2 MB size limit.";
}
}
else
{
// Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub UploadButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
' Specify the path on the server to
' save the uploaded file to.
Dim savePath As String = "c:\temp\uploads\"
' Before attempting to save the file, verify
' that the FileUpload control contains a file.
If (FileUpload1.HasFile) Then
' Get the size in bytes of the file to upload.
Dim fileSize As Integer = FileUpload1.PostedFile.ContentLength
' Allow only files less than 2,100,000 bytes (approximately 2 MB) to be uploaded.
If (fileSize < 2100000) Then
' Append the name of the uploaded file to the path.
savePath += Server.HtmlEncode(FileUpload1.FileName)
' Call the SaveAs method to save the
' uploaded file to the specified path.
' This example does not perform all
' the necessary error checking.
' If a file with the same name
' already exists in the specified path,
' the uploaded file overwrites it.
FileUpload1.SaveAs(savePath)
' Notify the user that the file was uploaded successfully.
UploadStatusLabel.Text = "Your file was uploaded successfully."
Else
' Notify the user why their file was not uploaded.
UploadStatusLabel.Text = "Your file was not uploaded because " + _
"it exceeds the 2 MB size limit."
End If
Else
' Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadButton"
Text="Upload file"
OnClick="UploadButton_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
Aşağıdaki örnekte, dosyaları kodda belirtilen bir FileUpload yola kaydeden bir denetimin nasıl oluşturulacağı gösterilmektedir. Bu örnek yalnızca .doc veya .xls dosya adı uzantılarına sahip dosyaların karşıya yüklenmesine izin verir. Path.GetExtension karşıya yüklenecek dosyanın uzantısını döndürmek için yöntemi çağrılır. Dosyanın .doc veya .xls dosya adı uzantısı varsa, SaveAs dosyayı sunucuda belirtilen yola kaydetmek için yöntemi çağrılır.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void UploadBtn_Click(object sender, EventArgs e)
{
// Specify the path on the server to
// save the uploaded file to.
string savePath = @"c:\temp\uploads";
// Before attempting to save the file, verify
// that the FileUpload control contains a file.
if (FileUpload1.HasFile)
{
// Get the name of the file to upload.
string fileName = Server.HtmlEncode(FileUpload1.FileName);
// Get the extension of the uploaded file.
string extension = System.IO.Path.GetExtension(fileName);
// Allow only files with .doc or .xls extensions
// to be uploaded.
if ((extension == ".doc") || (extension == ".xls"))
{
// Append the name of the file to upload to the path.
savePath += fileName;
// Call the SaveAs method to save the
// uploaded file to the specified path.
// This example does not perform all
// the necessary error checking.
// If a file with the same name
// already exists in the specified path,
// the uploaded file overwrites it.
FileUpload1.SaveAs(savePath);
// Notify the user that their file was successfully uploaded.
UploadStatusLabel.Text = "Your file was uploaded successfully.";
}
else
{
// Notify the user why their file was not uploaded.
UploadStatusLabel.Text = "Your file was not uploaded because " +
"it does not have a .doc or .xls extension.";
}
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadBtn"
Text="Upload file"
OnClick="UploadBtn_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub UploadBtn_Click(ByVal sender As Object, ByVal e As System.EventArgs)
' Specify the path on the server to
' save the uploaded file to.
Dim savePath As String = "c:\temp\uploads\"
' Before attempting to save the file, verify
' that the FileUpload control contains a file.
If (FileUpload1.HasFile) Then
' Get the name of the file to upload.
Dim fileName As String = Server.HtmlEncode(FileUpload1.FileName)
' Get the extension of the uploaded file.
Dim extension As String = System.IO.Path.GetExtension(fileName)
' Allow only files with .doc or .xls extensions
' to be uploaded.
If (extension = ".doc") Or (extension = ".xls") Then
' Append the name of the file to upload to the path.
savePath += fileName
' Call the SaveAs method to save the
' uploaded file to the specified path.
' This example does not perform all
' the necessary error checking.
' If a file with the same name
' already exists in the specified path,
' the uploaded file overwrites it.
FileUpload1.SaveAs(savePath)
' Notify the user that their file was successfully uploaded.
UploadStatusLabel.Text = "Your file was uploaded successfully."
Else
' Notify the user why their file was not uploaded.
UploadStatusLabel.Text = "Your file was not uploaded because " + _
"it does not have a .doc or .xls extension."
End If
Else
' Notify the user that a file was not uploaded.
UploadStatusLabel.Text = "You did not specify a file to upload."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FileUpload Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h4>Select a file to upload:</h4>
<asp:FileUpload id="FileUpload1"
runat="server">
</asp:FileUpload>
<br/><br/>
<asp:Button id="UploadBtn"
Text="Upload file"
OnClick="UploadBtn_Click"
runat="server">
</asp:Button>
<hr />
<asp:Label id="UploadStatusLabel"
runat="server">
</asp:Label>
</div>
</form>
</body>
</html>
Açıklamalar
Bu konuda:
Giriş
sınıfı, FileUpload kullanıcıların istemcideki bir dosyayı seçip Web sunucusuna yüklemesini sağlayan bir metin kutusu denetimi ve göz atma düğmesi görüntüler. Kullanıcı, yerel bilgisayardaki dosyanın tam yolunu (örneğin ,C:\MyFiles\TestFile.txt) denetimin metin kutusuna girerek karşıya yüklenecek dosyayı belirtir. Alternatif olarak, kullanıcı Gözat düğmesine tıklayıp dosyayı Dosya Seç iletişim kutusunda bularak dosyayı seçebilir.
FileName denetimi kullanarak FileUpload karşıya yüklenecek istemcideki bir dosyanın adını almak için özelliğini kullanın. Bu özelliğin döndürdüğü dosya adı, istemcideki dosyanın yolunu içermez.
özelliği, FileContent karşıya yüklenecek bir Stream dosyaya işaret eden bir nesne alır. Dosyanın içeriğine bayt olarak erişmek için bu özelliği kullanın. Örneğin, özelliği tarafından FileContent döndürülen nesnesini kullanarak Stream dosyanın içeriğini bayt olarak okuyabilir ve bir bayt dizisinde depolayabilirsiniz. Alternatif olarak, dosyasındaki FileBytes tüm baytları almak için özelliğini kullanabilirsiniz.
özelliği, PostedFile karşıya yüklenecek dosyanın temel nesnesini HttpPostedFile alır. Dosyadaki ek özelliklere erişmek için bu özelliği kullanabilirsiniz. ContentLength özelliği dosyanın uzunluğunu alır. özelliği dosyanın ContentType MIME içerik türünü alır. Ayrıca özelliğine, özelliğine ve SaveAs yöntemine InputStream erişmek FileName için özelliğini kullanabilirsinizPostedFile. Ancak aynı işlevsellik özelliği, FileContent özelliği ve SaveAs yöntemi tarafından FileName sağlanır.
Karşıya Yüklenen Dosyaları Kaydetme
Denetim FileUpload , kullanıcı karşıya yüklenecek dosyayı seçtikten sonra dosyayı otomatik olarak sunucuya kaydetmez. Kullanıcının belirtilen dosyayı göndermesine izin vermek için açıkça bir denetim veya mekanizma sağlamanız gerekir. Örneğin, kullanıcının dosyayı karşıya yüklemek için tıklatabileceği bir düğme sağlayabilirsiniz. Belirtilen dosyayı kaydetmek için yazdığınız kod, bir dosyanın içeriğini sunucudaki belirtilen yola kaydeden yöntemini çağırmalıdır SaveAs . Genellikle yöntemi, SaveAs sunucuya geri gönderi oluşturan bir olay için olay işleme yönteminde çağrılır. Örneğin, dosya göndermek için bir düğme sağlarsanız, dosyayı tıklama olayının olay işleme yöntemine kaydetme kodunu ekleyebilirsiniz.
Dosyayı sunucuya kaydetmek için yöntemini çağırmadan SaveAs önce, denetimin bir dosya içerdiğini HasFile doğrulamak FileUpload için özelliğini kullanın. HasFile döndürürse trueyöntemini çağırınSaveAs. döndürürse false, kullanıcıya denetimin dosya içermediğini belirten bir ileti görüntüler. Bu özellik varsayılan olarak 0 bayt içerdiğinden karşıya yüklenecek bir dosyanın var olup olmadığını belirlemek için özelliğini denetlemeyin PostedFile . Sonuç olarak, denetim boş PostedFile olsa FileUpload bile özelliği null olmayan bir değer döndürür.
Güvenlikle İlgili Dikkat Edilmesi Gerekenler
yöntemini çağırdığınızda SaveAs , karşıya yüklenen dosyanın kaydedildiği dizinin tam yolunu belirtmeniz gerekir. Uygulama kodunuzda açıkça bir yol belirtmezseniz, kullanıcı bir dosyayı karşıya yüklemeyi denediğinde bir özel durum oluşur. Bu davranış, kullanıcıların uygulamanızın dizin yapısındaki rastgele konumlara yazabilmesini engelleyerek ve hassas kök dizinlere erişimi engelleyerek sunucudaki dosyaların güvenli kalmasına yardımcı olur.
SaveAs yöntemi, karşıya yüklenen dosyayı belirtilen dizine yazar. Bu nedenle, ASP.NET uygulamasının sunucudaki dizine yazma erişimi olmalıdır. Uygulamanın yazma erişimi elde etmenin iki yolu vardır. Uygulamanın çalışmakta olduğu hesaba, karşıya yüklenen dosyaların kaydedileceği dizinde açıkça yazma erişimi vekleyebilirsiniz. Alternatif olarak, ASP.NET uygulamasına verilen güven düzeyini artırabilirsiniz. Uygulamanın yürütme dizinine yazma erişimi almak için, uygulamaya güven düzeyi değerine ayarlanmış nesne verilmelidir AspNetHostingPermissionAspNetHostingPermissionLevel.Medium . Güven düzeyini artırmak, uygulamanın sunucudaki kaynaklara erişimini artırır. Uygulamanızın denetimini alan kötü amaçlı bir kullanıcı da bu yüksek güven düzeyi altında çalışabileceğinden, bunun güvenli bir yaklaşım olmadığını unutmayın. Bir ASP.NET uygulamasını, uygulamanın çalışması için gereken en düşük ayrıcalıklara sahip bir kullanıcı bağlamında çalıştırmak en iyi yöntemdir. ASP.NET uygulamalarında güvenlik hakkında daha fazla bilgi için bkz. Web Uygulamaları için Temel Güvenlik Uygulamaları ve ASP.NET Güven Düzeyleri ve İlke Dosyaları.
Bellek Sınırlamaları
Hizmet reddi saldırılarına karşı korumanın bir yolu, denetimi kullanılarak karşıya yüklenebilecek dosyaların boyutunu sınırlamaktır FileUpload . Karşıya yüklenmesini beklediğiniz dosya türleri için uygun bir boyut sınırı ayarlamalısınız. Varsayılan boyut sınırı 4096 kilobayt (KB) veya 4 megabayttır (MB). httpRuntime öğesinin maxRequestLength özniteliğini ayarlayarak daha büyük dosyaların karşıya yüklenmesine izin vekleyebilirsiniz. Uygulamanın tamamında izin verilen en büyük dosya boyutunu artırmak için özniteliğini Web.config dosyasında ayarlayın maxRequestLength . Belirtilen bir sayfanın izin verilen dosya boyutu üst sınırını artırmak için özniteliğini Web.config öğesi içinde location ayarlayınmaxRequestLength. Bir örnek için bkz. location Öğesi (ASP.NET Ayarlar Şeması).
Büyük dosyaları karşıya yüklerken, kullanıcı aşağıdaki hata iletisini de alabilir:
aspnet_wp.exe (PID: 1520) was recycled because memory consumption exceeded 460 MB (60 percent of available RAM).
Kullanıcılarınız bu hata iletisiyle karşılaşırsa, uygulamanın Web.config dosyasının processModel öğesindeki özniteliğin değerini memoryLimit artırın. özniteliği, memoryLimit bir çalışan işleminin kullanabileceği en fazla bellek miktarını belirtir. Çalışan işlemi miktarı aşarsa memoryLimit , bunu değiştirmek için yeni bir işlem oluşturulur ve tüm geçerli istekler yeni işleme yeniden atanır.
karşıya yüklenecek dosyanın istek işlenirken geçici olarak bellekte mi yoksa sunucuda mı depolandığını denetlemek için httpRuntime öğesinin özniteliğini ayarlayınrequestLengthDiskThreshold. Bu öznitelik, giriş akışı arabelleğinin boyutunu yönetmenizi sağlar. Varsayılan değer 256 bayttır. Belirttiğiniz değer, öznitelik için maxRequestLength belirttiğiniz değeri aşmamalıdır.
UpdatePanel Denetimi ile FileUpload Denetimini Kullanma
Denetim FileUpload , kısmi sayfa işleme sırasında zaman uyumsuz geri gönderme senaryolarında değil, yalnızca geri gönderme senaryolarında kullanılacak şekilde tasarlanmıştır. Denetimin içinde bir FileUploadUpdatePanel denetim kullandığınızda, dosya panel için bir nesne olan bir PostBackTrigger denetim kullanılarak karşıya yüklenmelidir. UpdatePanel denetimler, sayfanın tamamını geri göndermeyle güncelleştirmek yerine sayfanın seçili bölgelerini güncelleştirmek için kullanılır. Daha fazla bilgi için bkz . UpdatePanel Denetimine Genel Bakış ve Kısmi Sayfa İşlemeye Genel Bakış.
Tanımlayıcı Sözdizimi
<asp:FileUpload
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Oluşturucular
| FileUpload() |
FileUpload sınıfının yeni bir örneğini başlatır. |
Özellikler
| AccessKey |
Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar. (Devralındığı yer: WebControl) |
| Adapter |
Denetim için tarayıcıya özgü bağdaştırıcıyı alır. (Devralındığı yer: Control) |
| AllowMultiple |
Karşıya yükleme için birden çok dosyanın seçilip seçilemeyeceğini belirten bir değer alır veya ayarlar. |
| AppRelativeTemplateSourceDirectory |
Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar. (Devralındığı yer: Control) |
| Attributes |
Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır. (Devralındığı yer: WebControl) |
| BackColor |
Web sunucusu denetiminin arka plan rengini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BindingContainer |
Bu denetimin veri bağlamasını içeren denetimi alır. (Devralındığı yer: Control) |
| BorderColor |
Web denetiminin kenarlık rengini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BorderStyle |
Web sunucusu denetiminin kenarlık stilini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BorderWidth |
Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
| ChildControlsCreated |
Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ClientID |
ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır. (Devralındığı yer: Control) |
| ClientIDMode |
özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar. (Devralındığı yer: Control) |
| ClientIDSeparator |
özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır. (Devralındığı yer: Control) |
| Context |
HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır. (Devralındığı yer: Control) |
| Controls |
ControlCollection Kullanıcı arabirimi hiyerarşisindeki belirtilen sunucu denetimi için alt denetimleri temsil eden bir nesnesi alır. (Devralındığı yer: Control) |
| ControlStyle |
Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ControlStyleCreated |
Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CssClass |
İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar. (Devralındığı yer: WebControl) |
| DataItemContainer |
Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control) |
| DataKeysContainer |
Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control) |
| DesignMode |
Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| Enabled |
Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableTheming |
Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableViewState |
Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip getirmek olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| Events |
Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır. (Devralındığı yer: Control) |
| FileBytes |
Bir denetim kullanılarak belirtilen bir dosyadaki bayt dizisini FileUpload alır. |
| FileContent |
Stream Denetimi kullanarak FileUpload karşıya yüklenecek dosyaya işaret eden bir nesne alır. |
| FileName |
Denetimi kullanarak FileUpload karşıya yüklenecek istemcideki bir dosyanın adını alır. |
| Font |
Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır. (Devralındığı yer: WebControl) |
| ForeColor |
Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar. (Devralındığı yer: WebControl) |
| HasAttributes |
Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır. (Devralındığı yer: WebControl) |
| HasChildViewState |
Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| HasFile |
Denetimin FileUpload dosya içerip içermediğini belirten bir değer alır. |
| HasFiles |
Karşıya dosya yüklenip yüklenmediğini gösteren bir değer alır. |
| Height |
Web sunucusu denetiminin yüksekliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
| ID |
Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar. (Devralındığı yer: Control) |
| IdSeparator |
Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır. (Devralındığı yer: Control) |
| IsChildControlStateCleared |
Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| IsEnabled |
Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: WebControl) |
| IsTrackingViewState |
Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır. (Devralındığı yer: Control) |
| IsViewStateEnabled |
Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: Control) |
| LoadViewStateByID |
Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| NamingContainer |
Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır. (Devralındığı yer: Control) |
| Page |
Sunucu denetimini içeren örneğe başvuru Page alır. (Devralındığı yer: Control) |
| Parent |
Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır. (Devralındığı yer: Control) |
| PostedFile |
Denetimi kullanılarak FileUpload karşıya yüklenen bir dosyanın temel nesnesini HttpPostedFile alır. |
| PostedFiles |
Karşıya yüklenen dosyaların koleksiyonunu alır. |
| RenderingCompatibility |
HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır. (Devralındığı yer: Control) |
| Site |
Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır. (Devralındığı yer: Control) |
| SkinID |
Denetime uygulanacak kaplamayı alır veya ayarlar. (Devralındığı yer: WebControl) |
| Style |
Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır. (Devralındığı yer: WebControl) |
| SupportsDisabledAttribute |
Denetimin özelliği |
| TabIndex |
Web sunucusu denetiminin sekme dizinini alır veya ayarlar. (Devralındığı yer: WebControl) |
| TagKey |
HtmlTextWriterTag Bu Web sunucusu denetimine karşılık gelen değeri alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| TagName |
Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| TemplateControl |
Bu denetimi içeren şablona başvuru alır veya ayarlar. (Devralındığı yer: Control) |
| TemplateSourceDirectory |
Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır. (Devralındığı yer: Control) |
| ToolTip |
Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: WebControl) |
| UniqueID |
Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır. (Devralındığı yer: Control) |
| ValidateRequestMode |
Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| ViewState |
Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır. (Devralındığı yer: Control) |
| ViewStateIgnoresCase |
Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ViewStateMode |
Bu denetimin görünüm durumu modunu alır veya ayarlar. (Devralındığı yer: Control) |
| Visible |
Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| Width |
Web sunucusu denetiminin genişliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
Yöntemler
| AddAttributesToRender(HtmlTextWriter) |
Bir denetimin HTML özniteliklerini ve stillerini FileUpload belirtilen HtmlTextWriter nesneye işlenmek üzere ekler. |
| AddedControl(Control, Int32) |
Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control . (Devralındığı yer: Control) |
| AddParsedSubObject(Object) |
Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler. (Devralındığı yer: Control) |
| ApplyStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ApplyStyleSheetSkin(Page) |
Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular. (Devralındığı yer: Control) |
| BeginRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemeye başlar. (Devralındığı yer: Control) |
| BuildProfileTree(String, Boolean) |
Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace . (Devralındığı yer: Control) |
| ClearCachedClientID() |
Önbelleğe alınan ClientID değeri olarak |
| ClearChildControlState() |
Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildViewState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar. (Devralındığı yer: Control) |
| CopyBaseAttributes(WebControl) |
Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CreateChildControls() |
ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır. (Devralındığı yer: Control) |
| CreateControlCollection() |
Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur. (Devralındığı yer: Control) |
| CreateControlStyle() |
Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| DataBind() |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar. (Devralındığı yer: Control) |
| DataBind(Boolean) |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar. (Devralındığı yer: Control) |
| DataBindChildren() |
Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar. (Devralındığı yer: Control) |
| Dispose() |
Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar. (Devralındığı yer: Control) |
| EndRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemesini sonlandırır. (Devralındığı yer: Control) |
| EnsureChildControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur. (Devralındığı yer: Control) |
| EnsureID() |
Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur. (Devralındığı yer: Control) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| FindControl(String) |
Belirtilen |
| FindControl(String, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen |
| Focus() |
Giriş odağını bir denetime ayarlar. (Devralındığı yer: Control) |
| GetDesignModeState() |
Denetim için tasarım zamanı verilerini alır. (Devralındığı yer: Control) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetRouteUrl(Object) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(RouteValueDictionary) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, Object) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| GetUniqueIDRelativeTo(Control) |
Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür. (Devralındığı yer: Control) |
| HasControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. (Devralındığı yer: Control) |
| HasEvents() |
Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür. (Devralındığı yer: Control) |
| IsLiteralContent() |
Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler. (Devralındığı yer: Control) |
| LoadControlState(Object) |
yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler. (Devralındığı yer: Control) |
| LoadViewState(Object) |
yöntemiyle SaveViewState() kaydedilmiş önceki bir istekten görünüm durumu bilgilerini geri yükler. (Devralındığı yer: WebControl) |
| MapPathSecure(String) |
Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır. (Devralındığı yer: Control) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MergeStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler. (Devralındığı yer: Control) |
| OnDataBinding(EventArgs) |
Olayı tetikler DataBinding . (Devralındığı yer: Control) |
| OnInit(EventArgs) |
Olayı tetikler Init . (Devralındığı yer: Control) |
| OnLoad(EventArgs) |
Olayı tetikler Load . (Devralındığı yer: Control) |
| OnPreRender(EventArgs) |
Denetim için olayı tetikler PreRenderFileUpload . |
| OnUnload(EventArgs) |
Olayı tetikler Unload . (Devralındığı yer: Control) |
| OpenFile(String) |
Stream Bir dosyayı okumak için kullanılan alır. (Devralındığı yer: Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar. (Devralındığı yer: Control) |
| RemovedControl(Control) |
Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control . (Devralındığı yer: Control) |
| Render(HtmlTextWriter) |
FileUpload Denetim içeriğini belirtilen HtmlTextWriter nesneye gönderir ve istemcide işlenmek üzere içeriği yazar. |
| RenderBeginTag(HtmlTextWriter) |
Denetimin HTML açma etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| RenderChildren(HtmlTextWriter) |
Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar. (Devralındığı yer: Control) |
| RenderContents(HtmlTextWriter) |
Denetimin içeriğini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| RenderControl(HtmlTextWriter) |
Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar. (Devralındığı yer: Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter . (Devralındığı yer: Control) |
| RenderEndTag(HtmlTextWriter) |
Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ResolveAdapter() |
Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır. (Devralındığı yer: Control) |
| ResolveClientUrl(String) |
Tarayıcı tarafından kullanılabilecek bir URL alır. (Devralındığı yer: Control) |
| ResolveUrl(String) |
URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür. (Devralındığı yer: Control) |
| SaveAs(String) |
Karşıya yüklenen dosyanın içeriğini Web sunucusunda belirtilen yola kaydeder. |
| SaveControlState() |
Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder. (Devralındığı yer: Control) |
| SaveViewState() |
Yöntemi çağrıldıktan sonra TrackViewState() değiştirilen tüm durumları kaydeder. (Devralındığı yer: WebControl) |
| SetDesignModeState(IDictionary) |
Denetim için tasarım zamanı verilerini ayarlar. (Devralındığı yer: Control) |
| SetRenderMethodDelegate(RenderMethod) |
Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object) |
İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object, Object) |
İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
| TrackViewState() |
Denetimin, nesnenin ViewState özelliğinde depolanabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur. (Devralındığı yer: WebControl) |
Ekinlikler
| DataBinding |
Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir. (Devralındığı yer: Control) |
| Disposed |
ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir. (Devralındığı yer: Control) |
| Init |
Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır. (Devralındığı yer: Control) |
| Load |
Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir. (Devralındığı yer: Control) |
| PreRender |
Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir. (Devralındığı yer: Control) |
| Unload |
Sunucu denetimi bellekten kaldırıldığında gerçekleşir. (Devralındığı yer: Control) |
Belirtik Arabirim Kullanımları
Uzantı Metotları
| FindDataSourceControl(Control) |
Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür. |
| FindFieldTemplate(Control, String) |
Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür. |
| FindMetaTable(Control) |
İçeren veri denetimi için metatablo nesnesini döndürür. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
Ç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. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin