FileUpload.SaveAs(String) Metoda

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í.

Uloží obsah nahraného souboru na zadanou cestu na webovém serveru.

public:
 void SaveAs(System::String ^ filename);

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parametry

filename: String

Řetězec, který určuje úplnou cestu k umístění serveru, na kterém se má nahraný soubor uložit.

Výjimky

HttpException

filename není úplná cesta.

Příklady

Následující příklad ukazuje, jak vytvořit FileUpload ovládací prvek, který provádí kontrolu chyb. Před uložením souboru se volá metoda k ověření, HasFile že soubor k nahrání existuje. Kromě toho je volána File.Exists metoda ke kontrole, zda soubor, který má stejný název již existuje v cestě. Pokud ano, název souboru k nahrání je předponou čísla před voláním SaveAs metody. Tím zabráníte přepsání existujícího souboru.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>FileUpload.SaveAs Method Example</title>
<script runat="server">
        
    protected void  UploadButton_Click(object sender, EventArgs e)
    {
        // Before attempting to save the file, verify
        // that the FileUpload control contains a file.
        if (FileUpload1.HasFile) 
          // Call a helper method routine to save the file.
          SaveFile(FileUpload1.PostedFile);
        else
          // Notify the user that a file was not uploaded.
          UploadStatusLabel.Text = "You did not specify a file to upload.";
    }
            
      void SaveFile(HttpPostedFile file)
      {            
        // Specify the path to save the uploaded file to.
        string savePath = "c:\\temp\\uploads\\";
            
        // Get the name of the file to upload.
        string fileName = FileUpload1.FileName;
            
        // Create the path and file name to check for duplicates.
        string pathToCheck = savePath + fileName;
        
        // Create a temporary file name to use for checking duplicates.
        string tempfileName = "";
            
        // Check to see if a file already exists with the
        // same name as the file to upload.        
        if (System.IO.File.Exists(pathToCheck)) 
        {
          int counter = 2;
          while (System.IO.File.Exists(pathToCheck))
          {
            // if a file with this name already exists,
            // prefix the filename with a number.
            tempfileName = counter.ToString() + fileName;
            pathToCheck = savePath + tempfileName;
            counter ++;
          }
          
          fileName = tempfileName;
          
          // Notify the user that the file name was changed.
          UploadStatusLabel.Text = "A file with the same name already exists." + 
              "<br />Your file was saved as " + fileName;
        }
        else
        {
          // Notify the user that the file was saved successfully.
          UploadStatusLabel.Text = "Your file was uploaded successfully.";
        }

        // 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 directory.
        FileUpload1.SaveAs(savePath);
            
      }
        
</script>

</head>
<body>

    <h3>FileUpload.SaveAs Method Example</h3>

    <form id="Form1" runat="server">
   
        <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>   
         
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>FileUpload.SaveAs Method Example</title>
<script runat="server">
        
      Sub UploadButton_Click(ByVal sender As Object, ByVal e As System.EventArgs)
            
        ' Before attempting to save the file, verify
        ' that the FileUpload control contains a file.
        If (FileUpload1.HasFile) Then
          ' Call a helper method routine to save the file.
          SaveFile(FileUpload1.PostedFile)
        Else
          ' Notify the user that a file was not uploaded.
          UploadStatusLabel.Text = "You did not specify a file to upload."
        End If

      End Sub
        
      Sub SaveFile(ByVal file As HttpPostedFile)
            
        ' Specify the path to save the uploaded file to.
        Dim savePath As String = "c:\temp\uploads\"
            
        ' Get the name of the file to upload.
        Dim fileName As String = FileUpload1.FileName
            
        ' Create the path and file name to check for duplicates.
        Dim pathToCheck As String = savePath + fileName
        
        ' Create a temporary file name to use for checking duplicates.
        Dim tempfileName As String
            
        ' Check to see if a file already exists with the
        ' same name as the file to upload.        
        If (System.IO.File.Exists(pathToCheck)) Then
          Dim counter As Integer = 2
          While (System.IO.File.Exists(pathToCheck))
            ' If a file with this name already exists,
            ' prefix the filename with a number.
            tempfileName = counter.ToString() + fileName
            pathToCheck = savePath + tempfileName
            counter = counter + 1
          End While
          
          fileName = tempfileName
          
          ' Notify the user that the file name was changed.
          UploadStatusLabel.Text = "A file with the same name already exists." + "<br />" + _
                                   "Your file was saved as " + fileName
          
        Else
          
          ' Notify the user that the file was saved successfully.
          UploadStatusLabel.Text = "Your file was uploaded successfully."
          
        End If

        ' 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 directory.
        FileUpload1.SaveAs(savePath)
            
      End Sub
        
  </script>

</head>
<body>

    <h3>FileUpload.SaveAs Method Example</h3>

    <form id="Form1" runat="server">
   
        <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>   
         
    </form>

</body>
</html>

Poznámky

Metoda SaveAs uloží obsah nahraného souboru na zadanou cestu na webovém serveru.

Ovládací FileUpload prvek po výběru souboru, který se má nahrát, automaticky neuloží soubor na server. 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 a soubor nahraje. Kód, který zapíšete pro uložení zadaného souboru, by měl volat metodu SaveAs , která uloží obsah souboru na zadanou cestu na serveru. SaveAs Metoda 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, kód pro uložení souboru na server by se pak mohl zahrnout do metody zpracování událostí pro událost kliknutí.

Při volání SaveAs metody je nutné zadat úplnou cestu k adresáři na serveru, ve kterém chcete uložit nahraný soubor. Pokud v kódu aplikace explicitně nezadáte cestu, vyvolá se výjimka, HttpException když se uživatel pokusí nahrát soubor. Toto chování pomáhá udržovat soubory na serveru v bezpečí tím, že uživatelům neumožňuje zadat cestu, do které se mají ukládat soubory, které nahrávají.

Před voláním SaveAs metody byste měli použít HasFile vlastnost k ověření, že FileUpload ovládací prvek obsahuje soubor k nahrání. Pokud se HasFile vrátí true, zavolejte metodu SaveAs . Pokud se vrátí false, zobrazte uživateli zprávu, že ovládací prvek neobsahuje soubor. Pokud nezadáte kód pro zpracování chyb, abyste ověřili, že soubor existuje, pokus o uložení existujícího souboru vyvolá HttpException výjimku.

Aby volání SaveAs fungovalo, musí mít aplikace ASP.NET přístup k zápisu do adresáře na serveru. Aplikace může získat přístup k zápisu dvěma způsoby. Můžete explicitně udělit přístup k zápisu k úč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. Chcete-li získat přístup k zápisu do spuštěného adresáře aplikace, musí být AspNetHostingPermission aplikace udělena objektu s úrovní důvěryhodnosti nastavenou AspNetHostingPermissionLevel.Medium na hodnotu. Zvýšení úrovně důvěryhodnosti zvyšuje přístup aplikace k prostředkům na serveru. Všimněte si, že to není zabezpečený přístup, protože škodlivý uživatel, který získá kontrolu nad vaší aplikací, bude také schopen běžet pod touto vyšší úrovní důvěryhodnosti. Osvědčeným postupem je spustit aplikaci ASP.NET v kontextu uživatele, který má minimální oprávnění, která jsou nutná ke spuštění aplikace. Další informace o zabezpečení v aplikacích ASP.NET najdete v tématu Základní postupy zabezpečení webových aplikací a ASP.NET Úrovně důvěryhodnosti a soubory zásad.

Platí pro

Sdílet prostřednictvím