FileUpload Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geeft een besturingselement voor een tekstvak en een bladerknop weer waarmee gebruikers een bestand kunnen selecteren dat naar de server moet worden geüpload.
public ref class FileUpload : System::Web::UI::WebControls::WebControl[System.Web.UI.ControlValueProperty("FileBytes")]
[System.Web.UI.ValidationProperty("FileName")]
public class FileUpload : System.Web.UI.WebControls.WebControl[<System.Web.UI.ControlValueProperty("FileBytes")>]
[<System.Web.UI.ValidationProperty("FileName")>]
type FileUpload = class
inherit WebControlPublic Class FileUpload
Inherits WebControl- Overname
- Kenmerken
Voorbeelden
Deze sectie bevat de volgende vier voorbeelden:
- In het eerste voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een pad dat is opgegeven in code.
- In het tweede voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een opgegeven map in het bestandssysteem voor de toepassing.
- In het derde voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een opgegeven pad en hoe u de grootte van het bestand beperkt dat kan worden geüpload.
- In het vierde voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen op een opgegeven pad en alleen bestanden met de .doc of .xls bestandsextensies kunnen worden geüpload.
Caution
In deze voorbeelden wordt de basissyntaxis voor het FileUpload besturingselement gedemonstreerd, maar niet alle benodigde foutcontrole die moet worden voltooid voordat u het bestand opslaat. Zie voor een completer voorbeeld SaveAs.
In het volgende voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een pad dat is opgegeven in code. De SaveAs methode wordt aangeroepen om het bestand op te slaan in het opgegeven pad op de server.
<%@ 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>
In het volgende voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een opgegeven map in het bestandssysteem voor de toepassing. De HttpRequest.PhysicalApplicationPath eigenschap wordt gebruikt om het pad van het fysieke bestandssysteem van de hoofdmap op te halen voor de servertoepassing die momenteel wordt uitgevoerd. De SaveAs methode wordt aangeroepen om het bestand op te slaan in het opgegeven pad op de server.
<%@ 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>
In het volgende voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een pad dat is opgegeven in de code. Het besturingselement beperkt de grootte van het bestand dat kan worden geüpload naar 2 MB. De PostedFile eigenschap wordt gebruikt voor toegang tot de onderliggende ContentLength eigenschap en retourneert de grootte van het bestand. Als de grootte van het te uploaden bestand kleiner is dan 2 MB, wordt de SaveAs methode aangeroepen om het bestand op te slaan in het opgegeven pad op de server. Naast het controleren op de maximale bestandsgrootte in uw toepassingscode, kunt u het maxRequestLength kenmerk van het httpRuntime-element instellen op een maximale toegestane grootte in het configuratiebestand voor uw toepassing.
<%@ 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>
In het volgende voorbeeld ziet u hoe u een FileUpload besturingselement maakt waarmee bestanden worden opgeslagen in een pad dat is opgegeven in de code. In dit voorbeeld kunnen alleen bestanden met de .doc of .xls bestandsnaamextensies worden geüpload. De Path.GetExtension methode wordt aangeroepen om de extensie van het bestand te retourneren die moet worden geüpload. Als het bestand een .doc of .xls bestandsnaamextensie heeft, wordt de SaveAs methode aangeroepen om het bestand op te slaan in het opgegeven pad op de server.
<%@ 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>
Opmerkingen
In dit artcile:
- Introduction
- Geüploade bestanden opslaan
- Beveiligingsoverwegingen
- Geheugenbeperkingen
- Het Besturingselement FileUpload gebruiken met het besturingselement UpdatePanel
- Declaratieve syntaxis
Introductie
In FileUpload de klasse wordt een tekstvak en een bladerknop weergegeven waarmee gebruikers een bestand op de client kunnen selecteren en naar de webserver kunnen uploaden. De gebruiker geeft het bestand op dat moet worden geüpload door het volledige pad van het bestand op de lokale computer (bijvoorbeeld C:\MyFiles\TestFile.txt) in het tekstvak van het besturingselement in te voeren. De gebruiker kan het bestand ook selecteren door op de knop Bladeren te klikken en het vervolgens te zoeken in het dialoogvenster Bestand kiezen .
Gebruik de FileName eigenschap om de naam van een bestand op een client op te halen om te uploaden met behulp van het FileUpload besturingselement. De bestandsnaam die door deze eigenschap wordt geretourneerd, bevat niet het pad van het bestand op de client.
De FileContent eigenschap haalt een Stream object op dat verwijst naar een bestand dat moet worden geüpload. Gebruik deze eigenschap om toegang te krijgen tot de inhoud van het bestand als bytes. U kunt bijvoorbeeld het Stream object gebruiken dat door de FileContent eigenschap wordt geretourneerd om de inhoud van het bestand als bytes te lezen en op te slaan in een bytematrix. U kunt de FileBytes eigenschap ook gebruiken om alle bytes in het bestand op te halen.
Met de PostedFile eigenschap wordt het onderliggende HttpPostedFile object opgehaald dat het bestand moet uploaden. U kunt deze eigenschap gebruiken voor toegang tot aanvullende eigenschappen in het bestand. De ContentLength eigenschap haalt de lengte van het bestand op. De ContentType eigenschap haalt het MIME-inhoudstype van het bestand op. Daarnaast kunt u de PostedFile eigenschap gebruiken om toegang te krijgen tot de FileName eigenschap, de InputStream eigenschap en de SaveAs methode. Dezelfde functionaliteit wordt echter geleverd door de FileName eigenschap, de FileContent eigenschap en de SaveAs methode.
Geüploade bestanden opslaan
Het FileUpload besturingselement slaat een bestand niet automatisch op de server op nadat de gebruiker het te uploaden bestand heeft geselecteerd. U moet expliciet een besturingselement of mechanisme opgeven waarmee de gebruiker het opgegeven bestand kan verzenden. U kunt bijvoorbeeld een knop opgeven waarop de gebruiker klikt om het bestand te uploaden. De code die u schrijft om het opgegeven bestand op te slaan, moet de SaveAs methode aanroepen, waardoor de inhoud van een bestand wordt opgeslagen in een opgegeven pad op de server. Normaal gesproken wordt de SaveAs methode aangeroepen in een gebeurtenisafhandelingsmethode voor een gebeurtenis die een postback naar de server genereert. Als u bijvoorbeeld een knop opgeeft om een bestand in te dienen, kunt u de code opnemen om het bestand op te slaan in de methode voor gebeurtenisafhandeling voor de klikgebeurtenis.
Voordat u de SaveAs methode aanroept om het bestand op te slaan op de server, gebruikt u de HasFile eigenschap om te controleren of het FileUpload besturingselement een bestand bevat. Als de HasFile retourneert true, roept u de methode aan SaveAs . Als dit wordt geretourneerd false, geeft u een bericht weer aan de gebruiker die aangeeft dat het besturingselement geen bestand bevat. Controleer de PostedFile eigenschap niet om te bepalen of er een bestand bestaat dat moet worden geüpload, omdat deze eigenschap standaard 0 bytes bevat. Als gevolg hiervan retourneert de FileUpload eigenschap, zelfs wanneer het PostedFile besturingselement leeg is, een niet-null-waarde.
Beveiligingsoverwegingen
Wanneer u de SaveAs methode aanroept, moet u het volledige pad van de map opgeven waarin het geüploade bestand moet worden opgeslagen. Als u niet expliciet een pad in uw toepassingscode opgeeft, wordt er een uitzondering gegenereerd wanneer een gebruiker probeert een bestand te uploaden. Dit gedrag helpt de bestanden op de server veilig te houden door te voorkomen dat gebruikers naar willekeurige locaties in de mapstructuur van uw toepassing kunnen schrijven en de toegang tot gevoelige hoofdmappen kunnen voorkomen.
De SaveAs methode schrijft het geüploade bestand naar de opgegeven map. Daarom moet de ASP.NET-toepassing schrijftoegang hebben tot de map op de server. Er zijn twee manieren waarop de toepassing schrijftoegang kan krijgen. U kunt schrijftoegang expliciet verlenen aan het account waaronder de toepassing wordt uitgevoerd, in de map waarin de geüploade bestanden worden opgeslagen. U kunt ook het vertrouwensniveau verhogen dat wordt verleend aan de ASP.NET-toepassing. Als u schrijftoegang wilt krijgen tot de uitvoermap voor de toepassing, moet aan de toepassing het AspNetHostingPermission object worden verleend, waarbij het vertrouwensniveau is ingesteld op de AspNetHostingPermissionLevel.Medium waarde. Het verhogen van het vertrouwensniveau verhoogt de toegang van de toepassing tot resources op de server. Houd er rekening mee dat dit geen veilige benadering is, omdat een kwaadwillende gebruiker die de controle over uw toepassing krijgt, ook kan worden uitgevoerd onder dit hogere vertrouwensniveau. Het is een best practice om een ASP.NET toepassing uit te voeren in de context van een gebruiker met de minimale bevoegdheden die nodig zijn om de toepassing uit te voeren. Zie Basic Security Practices for Web Applications and ASP.NET Trust Levels and Policy Files voor meer informatie over beveiliging in ASP.NET toepassingen.
Geheugenbeperkingen
Een manier om denial of service-aanvallen te voorkomen, is door de grootte van de bestanden te beperken die kunnen worden geüpload met behulp van het FileUpload besturingselement. U moet een groottelimiet instellen die geschikt is voor de typen bestanden die u verwacht te uploaden. De standaardgroottelimiet is 4096 kilobytes (KB) of 4 MB (megabytes). U kunt toestaan dat grotere bestanden worden geüpload door het maxRequestLength kenmerk van het httpRuntime-element in te stellen. Als u de maximale toegestane bestandsgrootte voor de hele toepassing wilt vergroten, stelt u het maxRequestLength kenmerk in het Web.config-bestand in. Als u de maximaal toegestane bestandsgrootte voor een opgegeven pagina wilt vergroten, stelt u het kenmerk maxRequestLength in het element location in Web.configin. Zie location-element (ASP.NET Settings Schema) voor een voorbeeld.
Bij het uploaden van grote bestanden kan een gebruiker ook het volgende foutbericht ontvangen:
aspnet_wp.exe (PID: 1520) was recycled because memory consumption exceeded 460 MB (60 percent of available RAM).
Als uw gebruikers dit foutbericht tegenkomen, verhoogt u de waarde van het memoryLimit kenmerk in het processModel van het element het Web.config-bestand voor de toepassing. Het memoryLimit kenmerk geeft de maximale hoeveelheid geheugen op die een werkproces kan gebruiken. Als het werkproces de memoryLimit hoeveelheid overschrijdt, wordt er een nieuw proces gemaakt om het te vervangen en worden alle huidige aanvragen opnieuw toegewezen aan het nieuwe proces.
Als u wilt bepalen of het bestand dat moet worden geüpload, tijdelijk is opgeslagen in het geheugen of op de server terwijl de aanvraag wordt verwerkt, stelt u het requestLengthDiskThreshold kenmerk van het httpRuntime-element in. Met dit kenmerk kunt u de grootte van de invoerstroombuffer beheren. De standaardwaarde is 256 bytes. De waarde die u opgeeft, mag niet groter zijn dan de waarde die u voor het maxRequestLength kenmerk opgeeft.
Het Besturingselement FileUpload gebruiken met het besturingselement UpdatePanel
Het FileUpload besturingselement is ontworpen om alleen te worden gebruikt in postback-scenario's en niet in asynchrone postbackscenario's tijdens het weergeven van gedeeltelijke pagina's. Wanneer u een FileUpload besturingselement in een UpdatePanel besturingselement gebruikt, moet het bestand worden geüpload met behulp van een besturingselement dat een PostBackTrigger object voor het deelvenster is. UpdatePanel besturingselementen worden gebruikt om geselecteerde regio's van een pagina bij te werken in plaats van de hele pagina bij te werken met een terugpost. Zie Overzicht van UpdatePanel-besturingselementen en Partial-Page Rendering voor meer informatie.
Declaratieve syntaxis
<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"
/>
Constructors
| Name | Description |
|---|---|
| FileUpload() |
Initialiseert een nieuw exemplaar van de FileUpload klasse. |
Eigenschappen
| Name | Description |
|---|---|
| AccessKey |
Hiermee haalt u de toegangssleutel op waarmee u snel naar het webserverbeheer kunt navigeren. (Overgenomen van WebControl) |
| Adapter |
Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control) |
| AllowMultiple |
Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of meerdere bestanden kunnen worden geselecteerd voor uploaden. |
| AppRelativeTemplateSourceDirectory |
Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control) |
| Attributes |
Hiermee haalt u de verzameling willekeurige kenmerken (alleen voor rendering) op die niet overeenkomen met eigenschappen in het besturingselement. (Overgenomen van WebControl) |
| BackColor |
Hiermee haalt u de achtergrondkleur van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| BindingContainer |
Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control) |
| BorderColor |
Hiermee haalt u de randkleur van het web besturingselement op of stelt u deze in. (Overgenomen van WebControl) |
| BorderStyle |
Hiermee haalt u de randstijl van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| BorderWidth |
Hiermee haalt u de randbreedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| ChildControlsCreated |
Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control) |
| ClientID |
Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET. (Overgenomen van Control) |
| ClientIDMode |
Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren. (Overgenomen van Control) |
| ClientIDSeparator |
Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control) |
| Context |
Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control) |
| Controls |
Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van Control) |
| ControlStyle |
Hiermee haalt u de stijl van het besturingselement webserver op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ControlStyleCreated |
Hiermee wordt een waarde opgehaald die aangeeft of er een Style object is gemaakt voor de ControlStyle eigenschap. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| CssClass |
Hiermee wordt de CSS-klasse (Cascading Style Sheet) opgehaald of ingesteld die wordt weergegeven door het webserverbeheer op de client. (Overgenomen van WebControl) |
| DataItemContainer |
Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control) |
| DataKeysContainer |
Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control) |
| DesignMode |
Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control) |
| Enabled |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement webserver is ingeschakeld. (Overgenomen van WebControl) |
| EnableTheming |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement. (Overgenomen van WebControl) |
| EnableViewState |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control) |
| Events |
Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control) |
| FileBytes |
Hiermee haalt u een matrix op van de bytes in een bestand dat is opgegeven met behulp van een FileUpload besturingselement. |
| FileContent |
Hiermee haalt u een Stream object op dat naar een bestand verwijst om te uploaden met behulp van het FileUpload besturingselement. |
| FileName |
Hiermee haalt u de naam van een bestand op een client op om te uploaden met behulp van het FileUpload besturingselement. |
| Font |
Hiermee haalt u de lettertype-eigenschappen op die zijn gekoppeld aan het besturingselement webserver. (Overgenomen van WebControl) |
| ForeColor |
Hiermee haalt u de voorgrondkleur (meestal de kleur van de tekst) van het webserverbesturingselement op of stelt u deze in. (Overgenomen van WebControl) |
| HasAttributes |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement kenmerken heeft ingesteld. (Overgenomen van WebControl) |
| HasChildViewState |
Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control) |
| HasFile |
Hiermee wordt een waarde opgehaald die aangeeft of het FileUpload besturingselement een bestand bevat. |
| HasFiles |
Hiermee wordt een waarde opgehaald die aangeeft of bestanden zijn geüpload. |
| Height |
Hiermee haalt u de hoogte van het webserverbeheer op of stelt u deze in. (Overgenomen van WebControl) |
| ID |
Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control) |
| IdSeparator |
Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control) |
| IsChildControlStateCleared |
Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control) |
| IsEnabled |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement is ingeschakeld. (Overgenomen van WebControl) |
| IsTrackingViewState |
Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control) |
| IsViewStateEnabled |
Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control) |
| LoadViewStateByID |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control) |
| NamingContainer |
Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control) |
| Page |
Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control) |
| Parent |
Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control) |
| PostedFile |
Hiermee haalt u het onderliggende HttpPostedFile object op voor een bestand dat wordt geüpload met behulp van het FileUpload besturingselement. |
| PostedFiles |
Hiermee haalt u de verzameling geüploade bestanden op. |
| RenderingCompatibility |
Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control) |
| Site |
Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control) |
| SkinID |
Hiermee wordt de huid op de controle toegepast of ingesteld. (Overgenomen van WebControl) |
| Style |
Hiermee haalt u een verzameling tekstkenmerken op die worden weergegeven als een stijlkenmerk op de buitenste tag van het besturingselement webserver. (Overgenomen van WebControl) |
| SupportsDisabledAttribute |
Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het |
| TabIndex |
Hiermee haalt u de tabindex van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
| TagKey |
Hiermee haalt u de HtmlTextWriterTag waarde op die overeenkomt met dit besturingselement van de webserver. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| TagName |
Hiermee haalt u de naam van het besturingselementlabel op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| TemplateControl |
Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control) |
| TemplateSourceDirectory |
Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control) |
| ToolTip |
Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven wanneer de muisaanwijzer boven het besturingselement webserver beweegt. (Overgenomen van WebControl) |
| UniqueID |
Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control) |
| ValidateRequestMode |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control) |
| ViewState |
Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control) |
| ViewStateIgnoresCase |
Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control) |
| ViewStateMode |
Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control) |
| Visible |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een serverbesturing wordt weergegeven als gebruikersinterface op de pagina. (Overgenomen van Control) |
| Width |
Hiermee haalt u de breedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl) |
Methoden
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Hiermee worden de HTML-kenmerken en -stijlen van een FileUpload besturingselement toegevoegd om aan het opgegeven HtmlTextWriter object weer te geven. |
| AddedControl(Control, Int32) |
Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control) |
| AddParsedSubObject(Object) |
Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control) |
| ApplyStyle(Style) |
Kopieert eventuele niet-lege elementen van de opgegeven stijl naar het web besturingselement, en overschrijft eventuele bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ApplyStyleSheetSkin(Page) |
De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van Control) |
| BeginRenderTracing(TextWriter, Object) |
Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control) |
| BuildProfileTree(String, Boolean) |
Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control) |
| ClearCachedClientID() |
Hiermee stelt u de waarde in de cache in ClientID op |
| ClearChildControlState() |
Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearChildState() |
Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearChildViewState() |
Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| ClearEffectiveClientIDMode() |
Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control) |
| CopyBaseAttributes(WebControl) |
Kopieert de eigenschappen die niet zijn ingekapseld door het Style object van het opgegeven webserverbesturingselement naar het webserverbesturingselement waaruit deze methode wordt aangeroepen. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| CreateChildControls() |
Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control) |
| CreateControlCollection() |
Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van Control) |
| CreateControlStyle() |
Hiermee maakt u het stijlobject dat intern door de WebControl klasse wordt gebruikt om alle stijlgerelateerde eigenschappen te implementeren. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| DataBind() |
Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control) |
| DataBind(Boolean) |
Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control) |
| DataBindChildren() |
Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control) |
| Dispose() |
Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control) |
| EndRenderTracing(TextWriter, Object) |
Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control) |
| EnsureChildControls() |
Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control) |
| EnsureID() |
Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| FindControl(String, Int32) |
Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven |
| FindControl(String) |
Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven |
| Focus() |
Hiermee stelt u de invoerfocus in op een besturingselement. (Overgenomen van Control) |
| GetDesignModeState() |
Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetRouteUrl(Object) |
Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control) |
| GetRouteUrl(RouteValueDictionary) |
Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control) |
| GetRouteUrl(String, Object) |
Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| GetUniqueIDRelativeTo(Control) |
Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control) |
| HasControls() |
Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van Control) |
| HasEvents() |
Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control) |
| IsLiteralContent() |
Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control) |
| LoadControlState(Object) |
Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control) |
| LoadViewState(Object) |
Hiermee herstelt u informatie over de weergavestatus van een vorige aanvraag die is opgeslagen met de SaveViewState() methode. (Overgenomen van WebControl) |
| MapPathSecure(String) |
Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MergeStyle(Style) |
Kopieert niet-lege elementen van de opgegeven stijl naar het webbesturing, maar overschrijft geen bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control) |
| OnDataBinding(EventArgs) |
Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnInit(EventArgs) |
Hiermee wordt de Init gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnLoad(EventArgs) |
Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control) |
| OnPreRender(EventArgs) |
Hiermee wordt de PreRender gebeurtenis voor het FileUpload besturingselement gegenereerd. |
| OnUnload(EventArgs) |
Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control) |
| OpenFile(String) |
Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control) |
| RemovedControl(Control) |
Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control) |
| Render(HtmlTextWriter) |
Hiermee wordt de inhoud van het FileUpload besturingselement verzonden naar het opgegeven HtmlTextWriter object, waarmee de inhoud op de client wordt weergegeven. |
| RenderBeginTag(HtmlTextWriter) |
Geeft de HTML-openingstag van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| RenderChildren(HtmlTextWriter) |
Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control) |
| RenderContents(HtmlTextWriter) |
Geeft de inhoud van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control) |
| RenderControl(HtmlTextWriter) |
Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van Control) |
| RenderEndTag(HtmlTextWriter) |
Geeft de HTML-slottag van het besturingselement weer in de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl) |
| ResolveAdapter() |
Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control) |
| ResolveClientUrl(String) |
Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control) |
| ResolveUrl(String) |
Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control) |
| SaveAs(String) |
Slaat de inhoud van een geüpload bestand op naar een opgegeven pad op de webserver. |
| SaveControlState() |
Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control) |
| SaveViewState() |
Hiermee wordt een status opgeslagen die is gewijzigd nadat de TrackViewState() methode is aangeroepen. (Overgenomen van WebControl) |
| SetDesignModeState(IDictionary) |
Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control) |
| SetRenderMethodDelegate(RenderMethod) |
Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control) |
| SetTraceData(Object, Object, Object) |
Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control) |
| SetTraceData(Object, Object) |
Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| TrackViewState() |
Hiermee zorgt u ervoor dat het besturingselement wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het object. (Overgenomen van WebControl) |
gebeurtenis
| Name | Description |
|---|---|
| DataBinding |
Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control) |
| Disposed |
Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control) |
| Init |
Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control) |
| Load |
Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control) |
| PreRender |
Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control) |
| Unload |
Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Hiermee haalt u een kenmerk van het webbeheer op met de opgegeven naam. (Overgenomen van WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Hiermee stelt u een kenmerk van het webbeheer in op de opgegeven naam en waarde. (Overgenomen van WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control) |
| IControlDesignerAccessor.UserData |
Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control) |
| IDataBindingsAccessor.DataBindings |
Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control) |
| IDataBindingsAccessor.HasDataBindings |
Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control) |
| IExpressionsAccessor.Expressions |
Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control) |
| IExpressionsAccessor.HasExpressions |
Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control) |
Extensiemethoden
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement. |
| FindFieldTemplate(Control, String) |
Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement. |
| FindMetaTable(Control) |
Retourneert het metatable-object voor het bevattende gegevensbeheer. |
