FileUpload Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zobrazí ovládací prvek textového pole a tlačítko pro procházení, které uživatelům umožňuje vybrat soubor, který se má nahrát na server.

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

Dědičnost: Object

Control

WebControl
FileUpload

Atributy: ControlValuePropertyAttribute ValidationPropertyAttribute

Příklady

Projekt webu sady Visual Studio se zdrojovým kódem je k dispozici pro toto téma: Stáhnout.

Tato část obsahuje následující čtyři příklady:

První příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do cesty, která je zadána v kódu.
Druhý příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do zadaného adresáře v systému souborů pro aplikaci.
Třetí příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do zadané cesty a omezuje velikost souboru, který lze nahrát.
Čtvrtý příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do zadané cesty a umožňuje nahrávat pouze soubory, které mají přípony .doc nebo .xls.

Upozornění

Tyto příklady ukazují základní syntaxi FileUpload ovládacího prvku, ale neukazují všechny nezbytné kontroly chyb, které by měly být dokončeny před uložením souboru. Úplnější příklad najdete v tématu SaveAs.

Následující příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do cesty, která je zadána v kódu. Volá se SaveAs metoda pro uložení souboru do zadané cesty na serveru.

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

Následující příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který ukládá soubory do zadaného adresáře v systému souborů pro aplikaci. Vlastnost HttpRequest.PhysicalApplicationPath se používá k získání fyzické cesty systému souborů kořenového adresáře pro aktuálně spuštěnou serverovou aplikaci. Metoda SaveAs je volána k uložení souboru do zadané cesty na serveru.

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

Následující příklad ukazuje, jak vytvořit ovládací prvek FileUpload , který ukládá soubory do cesty, která je zadána v kódu. Ovládací prvek omezuje velikost souboru, který se dá nahrát, na 2 MB. Vlastnost PostedFile se používá pro přístup k podkladové ContentLength vlastnosti a vrácení velikosti souboru. Pokud je velikost souboru k nahrání menší než 2 MB, SaveAs je volána metoda pro uložení souboru do zadané cesty na serveru. Kromě kontroly nastavení maximální velikosti souboru v kódu aplikace můžete nastavit maxRequestLength atribut elementu httpRuntime na maximální povolenou velikost v konfiguračním souboru pro vaši aplikaci.

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

Následující příklad ukazuje, jak vytvořit ovládací prvek FileUpload , který ukládá soubory do cesty, která je zadána v kódu. Tento příklad umožňuje nahrávat jenom soubory s příponou .doc nebo .xls názvů souborů. Volá se Path.GetExtension metoda, která vrátí příponu souboru, který se má nahrát. Pokud má soubor příponu názvu souboru .doc nebo .xls, SaveAs je volána metoda pro uložení souboru do zadané cesty na serveru.

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

Poznámky

V tomto tématu:

Úvod
Ukládání nahraných souborů
Aspekty zabezpečení
Omezení paměti
Použití ovládacího prvku FileUpload s ovládacím prvku UpdatePanel
Deklarativní syntaxe

Úvod

Třída FileUpload zobrazí ovládací prvek textového pole a tlačítko pro procházení, které uživatelům umožňuje vybrat soubor v klientovi a nahrát ho na webový server. Uživatel určí soubor, který se má nahrát, zadáním úplné cesty k souboru v místním počítači (například C:\MyFiles\TestFile.txt) do textového pole ovládacího prvku. Uživatel může soubor vybrat tak, že klikne na tlačítko Procházet a pak ho najde v dialogovém okně Zvolit soubor .

FileName Pomocí vlastnosti získáte název souboru v klientovi, který se má nahrát, pomocí FileUpload ovládacího prvku. Název souboru, který tato vlastnost vrací, nezahrnuje cestu k souboru v klientovi.

Vlastnost FileContent získá Stream objekt, který odkazuje na soubor k nahrání. Tato vlastnost slouží k přístupu k obsahu souboru jako k bajtům. Můžete například použít Stream objekt vrácený FileContent vlastností ke čtení obsahu souboru jako bajtů a jejich uložení do pole bajtů. Případně můžete použít FileBytes vlastnost k načtení všech bajtů v souboru.

Vlastnost PostedFile získá základní HttpPostedFile objekt pro soubor k nahrání. Tuto vlastnost můžete použít pro přístup k dalším vlastnostem souboru. Vlastnost ContentLength získá délku souboru. Vlastnost ContentType získá typ obsahu MIME souboru. Kromě toho můžete vlastnost použít PostedFile pro přístup FileName k vlastnosti, InputStream vlastnosti a SaveAs metodě. Stejné funkce však poskytuje FileName vlastnost, FileContent vlastnost a SaveAs metoda.

Ukládání nahraných souborů

Ovládací FileUpload prvek automaticky neuloží soubor na server poté, co uživatel vybere soubor k nahrání. Musíte explicitně zadat ovládací prvek nebo mechanismus, který uživateli umožní odeslat zadaný soubor. Můžete například zadat tlačítko, na které uživatel klikne, aby soubor nahrál. Kód, který napíšete k uložení zadaného souboru, by měl volat metodu SaveAs , která uloží obsah souboru do zadané cesty na serveru. Metoda SaveAs se obvykle volá v metodě zpracování událostí pro událost, která vyvolá příspěvek zpět na server. Pokud například zadáte tlačítko pro odeslání souboru, můžete zahrnout kód pro uložení souboru do metody zpracování událostí pro událost click.

Před voláním SaveAs metody pro uložení souboru na server pomocí HasFile vlastnosti ověřte, že FileUpload ovládací prvek obsahuje soubor. Pokud vrátí HasFiletrue, zavolejte metodu SaveAs . Pokud vrátí false, zobrazí uživateli zprávu oznamující, že ovládací prvek neobsahuje soubor. Nekontrolujte PostedFile vlastnost a určete, jestli soubor, který se má nahrát, existuje, protože ve výchozím nastavení tato vlastnost obsahuje 0 bajtů. Výsledkem je, že i když FileUpload je ovládací prvek prázdný, PostedFile vrátí vlastnost hodnotu, která není null.

Aspekty zabezpečení

Při volání SaveAs metody je nutné zadat úplnou cestu k adresáři, do kterého chcete uložit nahraný soubor. Pokud v kódu aplikace explicitně nezadáte cestu, při pokusu uživatele o nahrání souboru dojde k výjimce. Toto chování pomáhá udržovat soubory na serveru zabezpečené tím, že brání uživatelům v zápisu do libovolných umístění v adresářové struktuře vaší aplikace a také brání přístupu k citlivým kořenovým adresářům.

Metoda SaveAs zapíše nahraný soubor do zadaného adresáře. Proto ASP.NET aplikace musí mít přístup k zápisu do adresáře na serveru. Existují dva způsoby, jak může aplikace získat přístup k zápisu. Přístup k zápisu můžete explicitně udělit účtu, pod kterým je aplikace spuštěná, v adresáři, ve kterém budou nahrané soubory uloženy. Případně můžete zvýšit úroveň důvěryhodnosti, která je udělena ASP.NET aplikaci. Pokud chcete získat přístup k zápisu do prováděcího adresáře aplikace, musí být aplikace udělena objektu AspNetHostingPermission s úrovní důvěryhodnosti nastavenou AspNetHostingPermissionLevel.Medium na hodnotu. Zvýšením úrovně důvěryhodnosti se zvýší přístup aplikace k prostředkům na serveru. Upozorňujeme, že se nejedná o zabezpečený přístup, protože uživatel se zlými úmysly, který získá kontrolu nad vaší aplikací, bude moct běžet i v rámci této vyšší úrovně důvěryhodnosti. Osvědčeným postupem je spustit aplikaci ASP.NET v kontextu uživatele s minimálními oprávněními potřebnými ke spuštění aplikace. Další informace o zabezpečení v aplikacích ASP.NET najdete v tématu Základní postupy zabezpečení pro webové aplikace a ASP.NET úrovně důvěryhodnosti a soubory zásad.

Omezení paměti

Jedním ze způsobů, jak se chránit před útoky na odepření služby, je omezit velikost souborů, které se dají nahrát pomocí FileUpload ovládacího prvku. Měli byste nastavit limit velikosti, který je vhodný pro typy souborů, které očekáváte, že se budou nahrávat. Výchozí limit velikosti je 4096 kilobajtů (kB) nebo 4 megabajty (MB). Můžete povolit nahrávání větších souborů nastavením maxRequestLength atributu elementu httpRuntime . Pokud chcete zvětšit maximální povolenou velikost souboru pro celou aplikaci, nastavte maxRequestLength atribut v souboru Web.config. Pokud chcete zvětšit maximální povolenou velikost souboru pro zadanou stránku, nastavte maxRequestLength atribut uvnitř elementu location v Web.config. Příklad najdete v tématu location – element (ASP.NET schéma nastavení).

Při nahrávání velkých souborů se uživateli může zobrazit také následující chybová zpráva:

aspnet_wp.exe (PID: 1520) was recycled because memory consumption exceeded 460 MB (60 percent of available RAM).

Pokud se uživatelům zobrazí tato chybová zpráva, zvyšte hodnotu atributu memoryLimit v processModel elementu Web.config souboru pro aplikaci. Atribut memoryLimit určuje maximální velikost paměti, kterou může pracovní proces použít. Pokud pracovní proces překročí tuto částku memoryLimit , vytvoří se nový proces, který ho nahradí, a všechny aktuální požadavky se znovu přiřadí k novému procesu.

Chcete-li určit, zda je soubor k odeslání dočasně uložen v paměti nebo na serveru během zpracování požadavku, nastavte requestLengthDiskThreshold atribut elementu httpRuntime . Tento atribut umožňuje spravovat velikost vyrovnávací paměti vstupního streamu. Výchozí hodnota je 256 bajtů. Hodnota, kterou zadáte, by neměla překročit hodnotu, kterou zadáte pro maxRequestLength atribut.

Použití ovládacího prvku FileUpload s ovládacím prvku UpdatePanel

Ovládací FileUpload prvek je navržen tak, aby se používal pouze ve scénářích postbacku, a ne v asynchronních scénářích zpětného vrácení během vykreslování částečné stránky. Pokud použijete ovládací prvek FileUpload uvnitř ovládacího UpdatePanel prvku, musí být soubor nahrán pomocí ovládacího prvku, který je objektem PostBackTrigger pro panel. UpdatePanel ovládací prvky se používají k aktualizaci vybraných oblastí stránky místo aktualizace celé stránky pomocí zpětného odeslání. Další informace najdete v tématu Přehled ovládacího prvku UpdatePanel a Přehled vykreslování částečné stránky.

Deklarativní syntaxe

<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"  
/>

Konstruktory

FileUpload()

Inicializuje novou instanci FileUpload třídy .

Vlastnosti

AccessKey	Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl)
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AllowMultiple	Získá nebo nastaví hodnotu, která určuje, zda lze pro odeslání vybrat více souborů.
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control)
Attributes	Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl)
BackColor	Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl)
BindingContainer	Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control)
BorderColor	Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl)
BorderStyle	Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
BorderWidth	Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control)
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control)
ClientIDSeparator	Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti. (Zděděno od Control)
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control)
ControlStyle	Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlStyleCreated	Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
CssClass	Získá nebo nastaví kaskádové šablony stylů (CSS) třídy vykreslené ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl)
DataItemContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control)
DesignMode	Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control)
Enabled	Získá nebo nastaví hodnotu označující, zda je povolen ovládací prvek webového serveru. (Zděděno od WebControl)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od WebControl)
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta. (Zděděno od Control)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
FileBytes	Získá pole bajtů v souboru, který je určen pomocí ovládacího prvku FileUpload .
FileContent	Stream Získá objekt, který odkazuje na soubor k nahrání pomocí FileUpload ovládacího prvku .
FileName	Získá název souboru v klientovi k nahrání pomocí FileUpload ovládacího prvku .
Font	Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl)
ForeColor	Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl)
HasAttributes	Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl)
HasChildViewState	Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control)
HasFile	Získá hodnotu označující, zda FileUpload ovládací prvek obsahuje soubor.
HasFiles	Získá hodnotu, která označuje, zda byly odeslány nějaké soubory.
Height	Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl)
ID	Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
IsChildControlStateCleared	Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control)
IsEnabled	Získá hodnotu označující, zda je povolen ovládací prvek. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control)
PostedFile	Získá podkladový HttpPostedFile objekt pro soubor, který je odeslán pomocí FileUpload ovládacího prvku.
PostedFiles	Získá kolekci nahraných souborů.
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control)
Site	Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví vzhled pro použití ovládacího prvku. (Zděděno od WebControl)
Style	Získá kolekci textových atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která označuje, zda má ovládací prvek nastavit `disabled` atribut vykresleného elementu HTML na "zakázáno", pokud je vlastnost ovládacího prvku IsEnabled je `false`. (Zděděno od WebControl)
TabIndex	Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl)
TagKey	HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
TagName	Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek. (Zděděno od Control)
ToolTip	Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru. (Zděděno od WebControl)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control)
ValidateRequestMode	Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control)
Width	Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)	Přidá atributy HTML a styly FileUpload ovládacího prvku pro vykreslení do zadaného HtmlTextWriter objektu.
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní ovládací prvek serveru, že byl analyzován prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control)
ApplyStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na `null`. (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
CopyBaseAttributes(WebControl)	Zkopíruje vlastnosti neza zapouzdřené objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
CreateChildControls()	Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control)
CreateControlCollection()	Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control)
CreateControlStyle()	Vytvoří objekt stylu, který je interně používán třídou k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
DataBind()	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslovaných dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindControl(String)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného `id` parametru. (Zděděno od Control)
FindControl(String, Int32)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným `id` a celočíselným číslem zadaným v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat. (Zděděno od Control)
Focus()	Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
IsLiteralContent()	Určuje, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control)
LoadViewState(Object)	Obnoví informace o stavu zobrazení z předchozího požadavku, který byl uložen s metodou SaveViewState() . (Zděděno od WebControl)
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MergeStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Init Vyvolá událost. (Zděděno od Control)
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost pro ovládací FileUpload prvek.
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá zvyk ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control)
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	FileUpload Odešle obsah ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit na klientovi.
RenderBeginTag(HtmlTextWriter)	Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí obsah ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
RenderControl(HtmlTextWriter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
ResolveAdapter()	Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control)
SaveAs(String)	Uloží obsah nahraného souboru do zadané cesty na webovém serveru.
SaveControlState()	Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží všechny stavy, které byly změněny po vyvolání TrackViewState() metody. (Zděděno od WebControl)
SetDesignModeState(IDictionary)	Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí, že ovládací prvek sleduje změny stavu zobrazení, aby mohly být uloženy ve vlastnosti objektu ViewState . (Zděděno od WebControl)

Událost

DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control)
Disposed	Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
Unload	Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

IAttributeAccessor.GetAttribute(String)	Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)	Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl)
IControlBuilderAccessor.ControlBuilder	Popis tohoto člena najdete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena najdete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena najdete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena najdete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena najdete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena najdete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena najdete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena najdete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena najdete v tématu AddParsedSubObject(Object). (Zděděno od Control)

Metody rozšíření

FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.

Platí pro

Viz také

SaveAs(String)

Sdílet prostřednictvím