FileUpload Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Ö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özat 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 WebControl

Public Class FileUpload
Inherits WebControl

Devralma: Object

Control

WebControl
FileUpload

Öznitelikler: ControlValuePropertyAttribute ValidationPropertyAttribute

Örnekler

Kaynak kodu içeren bir Visual Studio Web sitesi projesi şu konuya eşlik edebilir: İndir.

Bu bölümde aşağıdaki dört örnek yer alır:

İlk örnekte, dosyaları kodda belirtilen bir yola kaydeden bir FileUpload denetimin nasıl oluşturulacağı gösterilmektedir.
İkinci örnekte, uygulama için dosya sisteminde belirtilen dizine dosya kaydeden bir FileUpload denetimin nasıl oluşturulacağı gösterilmektedir.
Üçü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ü örnekte, dosyaları belirtilen yola kaydeden ve yalnızca .doc veya .xls dosya adı uzantılarına sahip dosyaların karşıya yüklenmesine izin veren bir FileUpload denetimin nasıl oluşturulacağı gösterilmektedir.

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ının kök dizininin 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üklenebilen 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 küçükse, SaveAs dosyayı sunucuda belirtilen yola kaydetmek için yöntemi çağrılır. Uygulama kodunuzda en büyük 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ş
Karşıya Yüklenen Dosyaları Kaydetme
Güvenlikle İlgili Dikkat Edilmesi Gerekenler
Bellek Sınırlamaları
UpdatePanel Denetimi ile FileUpload Denetimini Kullanma
Tanımlayıcı Sözdizimi

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 denetimini 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 dosyayı işaret eden bir nesne alır Stream . 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ğinePostedFile, InputStream özelliğine ve SaveAs yöntemine erişmek FileName için özelliğini kullanabilirsiniz. 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

Kullanıcı FileUpload karşıya yüklenecek dosyayı seçtikten sonra denetim dosyayı sunucuya otomatik olarak 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 FileUpload bir dosya içerdiğini HasFile doğrulamak 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üleyin. Bu özellik varsayılan olarak 0 bayt içerdiğinden karşıya yüklenecek bir dosyanın mevcut olup olmadığını belirlemek için özelliğini denetlemeyin PostedFile . Sonuç olarak, denetim boş PostedFile olsa FileUpload bile özellik 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 ve hassas kök dizinlere erişimi engelleyerek sunucudaki dosyaların güvenli kalmasına yardımcı olur.

yöntemi, SaveAs 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 altında çalıştığı 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 AspNetHostingPermission AspNetHostingPermissionLevel.Medium . Güven düzeyini artırmak, uygulamanın sunucudaki kaynaklara erişimini artırır. Uygulamanızın denetimini ele geçiren kötü amaçlı bir kullanıcı da bu daha 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 uygulamadır. 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ürlerine 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 en büyük dosya boyutunu artırmak için özniteliğini maxRequestLengthlocation Web.config öğesi içinde ayarlayın. Ö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ğinin değerini memoryLimit artırın. özniteliği, memoryLimit bir çalışan işleminin kullanabileceği en yüksek 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 FileUpload UpdatePanel denetim kullandığınızda, dosya panelin nesnesi 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 dosya 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 uygulanmayacağı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 FileUpload belirtilen bir dosyadaki bayt dizisini 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 `false`olduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını `disabled` belirten bir değer alır. (Devralındığı yer: WebControl)
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 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 gösteren 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)	Belirtilen HtmlTextWriter nesneye işlenmek üzere bir FileUpload denetimin HTML özniteliklerini ve stillerini 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 `null`ayarlar. (Devralındığı yer: Control)
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()	Stille ilgili tüm özellikleri uygulamak için sınıf tarafından WebControl 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 `id` parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar. (Devralındığı yer: Control)
FindControl(String, Int32)	Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen `id` bir tamsayı ile bir sunucu denetimi arar ve bu da `pathOffset` aramaya yardımcı olur. Yöntemin bu sürümünü FindControl geçersiz kılmamalısınız. (Devralındığı yer: Control)
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)	Denetimin PreRender olayını tetikler FileUpload .
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ı

IAttributeAccessor.GetAttribute(String)	Belirtilen ada sahip Web denetiminin özniteliğini alır. (Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)	Web denetiminin özniteliğini belirtilen ada ve değere ayarlar. (Devralındığı yer: WebControl)
IControlBuilderAccessor.ControlBuilder	Bu üyenin açıklaması için bkz ControlBuilder. . (Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()	Bu üyenin açıklaması için bkz GetDesignModeState(). . (Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). . (Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Bu üyenin açıklaması için bkz SetOwnerControl(Control). . (Devralındığı yer: Control)
IControlDesignerAccessor.UserData	Bu üyenin açıklaması için bkz UserData. . (Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings	Bu üyenin açıklaması için bkz DataBindings. . (Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings	Bu üyenin açıklaması için bkz HasDataBindings. . (Devralındığı yer: Control)
IExpressionsAccessor.Expressions	Bu üyenin açıklaması için bkz Expressions. . (Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions	Bu üyenin açıklaması için bkz HasExpressions. . (Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)	Bu üyenin açıklaması için bkz AddParsedSubObject(Object). . (Devralındığı yer: Control)

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.

SaveAs(String)

Aracılığıyla paylaş