FileUpload.SaveAs(String) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Speichert den Inhalt einer hochgeladenen Datei auf dem Webserver unter einem angegebenen Pfad.

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

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

Parameter

filename: String

Eine Zeichenfolge, die den vollständigen Pfad des Speicherorts auf dem Server angibt, an dem die hochgeladene Datei gespeichert werden soll.

Ausnahmen

HttpException

filename ist kein vollständiger Pfad.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie ein FileUpload Steuerelement erstellen, das eine Fehlerüberprüfung durchführt. Bevor die Datei gespeichert wird, wird die HasFile -Methode aufgerufen, um zu überprüfen, ob eine hochzuladende Datei vorhanden ist. Darüber hinaus wird die File.Exists -Methode aufgerufen, um zu überprüfen, ob eine Datei mit demselben Namen bereits im Pfad vorhanden ist. Wenn dies der Fall ist, wird dem Namen der hochzuladenden Datei eine Zahl vorangestellt, bevor die SaveAs Methode aufgerufen wird. Dadurch wird verhindert, dass die vorhandene Datei überschrieben wird.

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

Hinweise

Die SaveAs -Methode speichert den Inhalt einer hochgeladenen Datei in einem angegebenen Pfad auf dem Webserver.

Das FileUpload Steuerelement speichert eine Datei nicht automatisch auf dem Server, nachdem der Benutzer die datei zum Hochladen ausgewählt hat. Sie müssen explizit ein Steuerelement oder einen Mechanismus bereitstellen, damit der Benutzer die angegebene Datei übermitteln kann. Sie können beispielsweise eine Schaltfläche bereitstellen, auf die der Benutzer klickt, um die Datei hochzuladen. Der Code, den Sie zum Speichern der angegebenen Datei schreiben, sollte die SaveAs -Methode aufrufen, die den Inhalt einer Datei in einem angegebenen Pfad auf dem Server speichert. In der Regel wird die SaveAs -Methode in einer Ereignisbehandlungsmethode für ein Ereignis aufgerufen, das einen Post zurück an den Server auslöst. Wenn Sie beispielsweise eine Schaltfläche zum Übermitteln einer Datei bereitstellen, könnte der Code zum Speichern der Datei auf dem Server in die Ereignisbehandlungsmethode für das Click-Ereignis eingeschlossen werden.

Wenn Sie die SaveAs -Methode aufrufen, müssen Sie den vollständigen Pfad des Verzeichnisses auf dem Server angeben, in dem die hochgeladene Datei gespeichert werden soll. Wenn Sie im Anwendungscode nicht explizit einen Pfad angeben, wird eine HttpException Ausnahme ausgelöst, wenn ein Benutzer versucht, eine Datei hochzuladen. Dieses Verhalten trägt dazu bei, die Dateien auf dem Server zu schützen, da Benutzer keinen Pfad angeben können, in dem die hochgeladenen Dateien gespeichert werden sollen.

Bevor Sie die SaveAs -Methode aufrufen, sollten Sie die HasFile -Eigenschaft verwenden, um zu überprüfen, ob das FileUpload Steuerelement eine datei enthält, die hochgeladen werden soll. Wenn zurückgegeben wird HasFiletrue, rufen Sie die -Methode auf SaveAs . Wenn es zurückgibt false, wird dem Benutzer eine Meldung angezeigt, die angibt, dass das Steuerelement keine Datei enthält. Wenn Sie keinen Fehlerbehandlungscode bereitstellen, um zu überprüfen, ob eine Datei vorhanden ist, wird beim Versuch, eine nicht vorhandene Datei zu speichern, eine HttpException Ausnahme ausgelöst.

Damit ein Aufruf von funktioniert SaveAs , muss die ASP.NET-Anwendung Schreibzugriff auf das Verzeichnis auf dem Server haben. Es gibt zwei Möglichkeiten, wie die Anwendung Schreibzugriff erhalten kann. Sie können explizit Schreibzugriff auf das Konto gewähren, unter dem die Anwendung ausgeführt wird, in dem Verzeichnis, in dem die hochgeladenen Dateien gespeichert werden. Alternativ können Sie die Vertrauensebene erhöhen, die der ASP.NET-Anwendung gewährt wird. Um Schreibzugriff auf das ausführende Verzeichnis für die Anwendung zu erhalten, muss der Anwendung das AspNetHostingPermission Objekt gewährt werden, bei dem die Vertrauensebene auf den AspNetHostingPermissionLevel.Medium Wert festgelegt ist. Das Erhöhen der Vertrauenswürdigkeit erhöht den Zugriff der Anwendung auf Ressourcen auf dem Server. Beachten Sie, dass dies kein sicherer Ansatz ist, da ein böswilliger Benutzer, der die Kontrolle über Ihre Anwendung erhält, auch unter dieser höheren Vertrauensstufe ausgeführt werden kann. Es empfiehlt sich, eine ASP.NET-Anwendung im Kontext eines Benutzers auszuführen, der über die Mindestberechtigungen verfügt, die für die Ausführung der Anwendung erforderlich sind. Weitere Informationen zur Sicherheit in ASP.NET Anwendungen finden Sie unter Grundlegende Sicherheitsmethoden für Webanwendungen und ASP.NET Vertrauensebenen und Richtliniendateien.

Gilt für: