FileUpload Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Affiche un contrôle de zone de texte et un bouton Parcourir qui permet aux utilisateurs de sélectionner un fichier à charger sur le serveur.
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- Héritage
- Attributs
Exemples
Cette section contient les quatre exemples suivants :
- Le premier exemple montre comment créer un FileUpload contrôle qui enregistre des fichiers dans un chemin d’accès spécifié dans le code.
- Le deuxième exemple montre comment créer un FileUpload contrôle qui enregistre des fichiers dans un répertoire spécifié dans le système de fichiers de l’application.
- Le troisième exemple montre comment créer un FileUpload contrôle qui enregistre les fichiers dans un chemin d’accès spécifié et limite la taille du fichier qui peut être chargé.
- Le quatrième exemple montre comment créer un FileUpload contrôle qui enregistre les fichiers dans un chemin d’accès spécifié et autorise uniquement les fichiers qui ont les extensions de nom de fichier .doc ou .xls à charger.
Avertissement
Ces exemples illustrent la syntaxe de base du FileUpload contrôle, mais ils n’illustrent pas toutes les vérifications d’erreur nécessaires qui doivent être effectuées avant d’enregistrer le fichier. Pour obtenir un exemple plus complet, consultez SaveAs.
L’exemple suivant montre comment créer un FileUpload contrôle qui enregistre des fichiers dans un chemin d’accès spécifié dans le code. La SaveAs méthode est appelée pour enregistrer le fichier dans le chemin d’accès spécifié sur le serveur.
<%@ 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>
L’exemple suivant montre comment créer un FileUpload contrôle qui enregistre des fichiers dans un répertoire spécifié dans le système de fichiers de l’application. La HttpRequest.PhysicalApplicationPath propriété est utilisée pour obtenir le chemin du système de fichiers physique du répertoire racine pour l’application serveur en cours d’exécution. La SaveAs méthode est appelée pour enregistrer le fichier dans le chemin d’accès spécifié sur le serveur.
<%@ 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>
L’exemple suivant montre comment créer un FileUpload contrôle qui enregistre les fichiers dans un chemin d’accès spécifié dans le code. Le contrôle limite la taille du fichier qui peut être chargée sur 2 Mo. La PostedFile propriété est utilisée pour accéder à la propriété sous-jacente ContentLength et retourner la taille du fichier. Si la taille du fichier à charger est inférieure à 2 Mo, la SaveAs méthode est appelée pour enregistrer le fichier dans le chemin d’accès spécifié sur le serveur. Outre la vérification du paramètre de taille de fichier maximale dans le code de votre application, vous pouvez définir l’attribut maxRequestLength de l’élément httpRuntime sur une taille maximale autorisée dans le fichier de configuration de votre application.
<%@ 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>
L’exemple suivant montre comment créer un FileUpload contrôle qui enregistre les fichiers dans un chemin d’accès spécifié dans le code. Cet exemple autorise uniquement les fichiers qui ont les extensions de nom de fichier .doc ou .xls à charger. La Path.GetExtension méthode est appelée pour retourner l’extension du fichier à charger. Si le fichier a une extension de nom de fichier .doc ou .xls, la SaveAs méthode est appelée pour enregistrer le fichier dans le chemin d’accès spécifié sur le serveur.
<%@ 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>
Remarques
Dans cet artcile :
- Introduction
- Enregistrement de fichiers chargés
- Considérations de sécurité
- Limitations de la mémoire
- Utilisation du contrôle FileUpload avec le contrôle UpdatePanel
- Syntaxe déclarative
Présentation
La FileUpload classe affiche un contrôle de zone de texte et un bouton Parcourir qui permet aux utilisateurs de sélectionner un fichier sur le client et de le charger sur le serveur web. L’utilisateur spécifie le fichier à charger en entrant le chemin d’accès complet du fichier sur l’ordinateur local (par exemple, C:\MyFiles\TestFile.txt) dans la zone de texte du contrôle. Vous pouvez également sélectionner le fichier en cliquant sur le bouton Parcourir , puis en le localisant dans la boîte de dialogue Choisir un fichier .
Utilisez la FileName propriété pour obtenir le nom d’un fichier sur un client à charger à l’aide du FileUpload contrôle. Le nom de fichier retourné par cette propriété n’inclut pas le chemin d’accès du fichier sur le client.
La FileContent propriété obtient un Stream objet qui pointe vers un fichier à charger. Utilisez cette propriété pour accéder au contenu du fichier sous forme d’octets. Par exemple, vous pouvez utiliser l’objet Stream retourné par la FileContent propriété pour lire le contenu du fichier sous forme d’octets et les stocker dans un tableau d’octets. Vous pouvez également utiliser la FileBytes propriété pour récupérer tous les octets du fichier.
La PostedFile propriété obtient l’objet sous-jacent HttpPostedFile du fichier à charger. Vous pouvez utiliser cette propriété pour accéder à des propriétés supplémentaires sur le fichier. La ContentLength propriété obtient la longueur du fichier. La ContentType propriété obtient le type de contenu MIME du fichier. En outre, vous pouvez utiliser la PostedFile propriété pour accéder à la FileName propriété, à la InputStream propriété et à la SaveAs méthode. Toutefois, la même fonctionnalité est fournie par la propriété, la FileNameFileContent propriété et la SaveAs méthode.
Enregistrement de fichiers chargés
Le FileUpload contrôle n’enregistre pas automatiquement un fichier sur le serveur une fois que l’utilisateur sélectionne le fichier à charger. Vous devez fournir explicitement un contrôle ou un mécanisme pour permettre à l’utilisateur d’envoyer le fichier spécifié. Par exemple, vous pouvez fournir un bouton que l’utilisateur clique pour charger le fichier. Le code que vous écrivez pour enregistrer le fichier spécifié doit appeler la SaveAs méthode, qui enregistre le contenu d’un fichier dans un chemin d’accès spécifié sur le serveur. En règle générale, la SaveAs méthode est appelée dans une méthode de gestion des événements pour un événement qui déclenche une publication sur le serveur. Par exemple, si vous fournissez un bouton pour envoyer un fichier, vous pouvez inclure le code permettant d’enregistrer le fichier dans la méthode de gestion des événements pour l’événement Click.
Avant d’appeler la SaveAs méthode pour enregistrer le fichier sur le serveur, utilisez la HasFile propriété pour vérifier que le FileUpload contrôle contient un fichier. Si le HasFile retour est retourné true, appelez la SaveAs méthode. Si elle retourne false, affichez un message à l’utilisateur indiquant que le contrôle ne contient pas de fichier. Ne vérifiez pas la PostedFile propriété pour déterminer si un fichier à charger existe, car, par défaut, cette propriété contient 0 octets. Par conséquent, même lorsque le FileUpload contrôle est vide, la PostedFile propriété retourne une valeur non null.
Considérations relatives à la sécurité
Lorsque vous appelez la SaveAs méthode, vous devez spécifier le chemin d’accès complet du répertoire dans lequel enregistrer le fichier chargé. Si vous ne spécifiez pas explicitement de chemin d’accès dans votre code d’application, une exception est levée lorsqu’un utilisateur tente de charger un fichier. Ce comportement permet de sécuriser les fichiers sur le serveur en empêchant les utilisateurs d’écrire dans des emplacements arbitraires dans la structure de répertoires de votre application, ainsi que d’empêcher l’accès aux répertoires racines sensibles.
La SaveAs méthode écrit le fichier chargé dans le répertoire spécifié. Par conséquent, l’application ASP.NET doit avoir un accès en écriture au répertoire sur le serveur. Il existe deux façons pour l’application d’obtenir un accès en écriture. Vous pouvez accorder explicitement l’accès en écriture au compte sous lequel l’application s’exécute, dans le répertoire dans lequel les fichiers chargés seront enregistrés. Vous pouvez également augmenter le niveau de confiance accordé à l’application ASP.NET. Pour obtenir l’accès en écriture au répertoire en cours d’exécution pour l’application, l’application doit recevoir l’objet AspNetHostingPermission avec le niveau d’approbation défini sur la AspNetHostingPermissionLevel.Medium valeur. L’augmentation du niveau de confiance augmente l’accès de l’application aux ressources sur le serveur. Notez qu’il ne s’agit pas d’une approche sécurisée, car un utilisateur malveillant qui obtient le contrôle de votre application pourra également s’exécuter sous ce niveau de confiance supérieur. Il est recommandé d’exécuter une application ASP.NET dans le contexte d’un utilisateur disposant des privilèges minimaux requis pour que l’application s’exécute. Pour plus d’informations sur la sécurité dans les applications ASP.NET, consultez Pratiques de sécurité de base pour les applications web et ASP.NET niveaux de confiance et fichiers de stratégie.
Limitations de la mémoire
Une façon de se protéger contre les attaques par déni de service consiste à limiter la taille des fichiers qui peuvent être chargés à l’aide du FileUpload contrôle. Vous devez définir une limite de taille appropriée pour les types de fichiers que vous prévoyez de charger. La limite de taille par défaut est de 4 096 kilo-octets (Ko) ou de 4 mégaoctets (Mo). Vous pouvez autoriser le chargement de fichiers plus volumineux en définissant l’attribut maxRequestLength de l’élément httpRuntime . Pour augmenter la taille maximale autorisée du fichier pour l’ensemble de l’application, définissez l’attribut maxRequestLength dans le fichier Web.config. Pour augmenter la taille maximale autorisée du fichier pour une page spécifiée, définissez l’attribut maxRequestLength à l’intérieur de l’élément location dans Web.config. Pour obtenir un exemple, consultez location, élément (ASP.NET Schema Settings).
Lors du chargement de fichiers volumineux, un utilisateur peut également recevoir le message d’erreur suivant :
aspnet_wp.exe (PID: 1520) was recycled because memory consumption exceeded 460 MB (60 percent of available RAM).
Si vos utilisateurs rencontrent ce message d’erreur, augmentez la valeur de l’attribut memoryLimit dans le processModel de l’élément du fichier Web.config de l’application. L’attribut memoryLimit spécifie la quantité maximale de mémoire qu’un processus worker peut utiliser. Si le processus de travail dépasse le memoryLimit montant, un nouveau processus est créé pour le remplacer et toutes les demandes actuelles sont réaffectées au nouveau processus.
Pour déterminer si le fichier à charger est temporairement stocké en mémoire ou sur le serveur pendant le traitement de la requête, définissez l’attribut requestLengthDiskThreshold de l’élément httpRuntime . Cet attribut vous permet de gérer la taille de la mémoire tampon de flux d’entrée. La valeur par défaut est de 256 octets. La valeur que vous spécifiez ne doit pas dépasser la valeur que vous spécifiez pour l’attribut maxRequestLength .
Utilisation du contrôle FileUpload avec le contrôle UpdatePanel
Le FileUpload contrôle est conçu pour être utilisé uniquement dans les scénarios de publication différée et non dans les scénarios de publication asynchrones pendant le rendu de page partielle. Lorsque vous utilisez un FileUpload contrôle à l’intérieur d’un UpdatePanel contrôle, le fichier doit être chargé à l’aide d’un contrôle qui est un PostBackTrigger objet pour le panneau. UpdatePanel les contrôles sont utilisés pour mettre à jour les régions sélectionnées d’une page au lieu de mettre à jour toute la page avec une publication. Pour plus d’informations, consultez UpdatePanel Control Overview et Partial-Page Rendering Overview.
Syntaxe déclarative
<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"
/>
Constructeurs
| Nom | Description |
|---|---|
| FileUpload() |
Initialise une nouvelle instance de la classe FileUpload. |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web. (Hérité de WebControl) |
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AllowMultiple |
Obtient ou définit une valeur qui spécifie si plusieurs fichiers peuvent être sélectionnés pour le chargement. |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| Attributes |
Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle. (Hérité de WebControl) |
| BackColor |
Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web. (Hérité de WebControl) |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| BorderColor |
Obtient ou définit la couleur de bordure du contrôle Web. (Hérité de WebControl) |
| BorderStyle |
Obtient ou définit le style de bordure du contrôle serveur Web. (Hérité de WebControl) |
| BorderWidth |
Obtient ou définit la largeur de bordure du contrôle serveur Web. (Hérité de WebControl) |
| ChildControlsCreated |
Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (Hérité de Control) |
| Context |
Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection objet qui représente les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control) |
| ControlStyle |
Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ControlStyleCreated |
Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CssClass |
Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client. (Hérité de WebControl) |
| DataItemContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| Enabled |
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé. (Hérité de WebControl) |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle. (Hérité de WebControl) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| FileBytes |
Obtient un tableau des octets d’un fichier spécifié à l’aide d’un FileUpload contrôle. |
| FileContent |
Obtient un Stream objet qui pointe vers un fichier à charger à l’aide du FileUpload contrôle. |
| FileName |
Obtient le nom d’un fichier sur un client à charger à l’aide du FileUpload contrôle. |
| Font |
Obtient les propriétés de police associées au contrôle serveur Web. (Hérité de WebControl) |
| ForeColor |
Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web. (Hérité de WebControl) |
| HasAttributes |
Obtient une valeur indiquant si le contrôle a des attributs définis. (Hérité de WebControl) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| HasFile |
Obtient une valeur indiquant si le FileUpload contrôle contient un fichier. |
| HasFiles |
Obtient une valeur qui indique si des fichiers ont été chargés. |
| Height |
Obtient ou définit la hauteur du contrôle serveur Web. (Hérité de WebControl) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsEnabled |
Obtient une valeur indiquant si le contrôle est activé. (Hérité de WebControl) |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage. (Hérité de Control) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle. (Hérité de Control) |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| Page |
Obtient une référence à l’instance Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page. (Hérité de Control) |
| PostedFile |
Obtient l’objet sous-jacent HttpPostedFile d’un fichier chargé à l’aide du FileUpload contrôle. |
| PostedFiles |
Obtient la collection de fichiers chargés. |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de WebControl) |
| Style |
Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web. (Hérité de WebControl) |
| SupportsDisabledAttribute |
Obtient une valeur qui indique si le contrôle doit définir l’attribut |
| TabIndex |
Obtient ou définit l’index de tabulation du contrôle serveur Web. (Hérité de WebControl) |
| TagKey |
Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| TagName |
Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| ToolTip |
Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web. (Hérité de WebControl) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses. (Hérité de Control) |
| ViewState |
Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d’état d’affichage de ce contrôle. (Hérité de Control) |
| Visible |
Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page. (Hérité de Control) |
| Width |
Obtient ou définit la largeur du contrôle serveur Web. (Hérité de WebControl) |
Méthodes
| Nom | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Ajoute les attributs HTML et les styles d’un FileUpload contrôle à afficher sur l’objet spécifié HtmlTextWriter . |
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control . (Hérité de Control) |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| CopyBaseAttributes(WebControl) |
Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| CreateChildControls() |
Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur. (Hérité de Control) |
| CreateControlStyle() |
Crée l’objet de style utilisé en interne par la WebControl classe pour implémenter toutes les propriétés associées au style. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding . (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire. (Hérité de Control) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié. (Hérité de Control) |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (Hérité de Control) |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage à partir d’une requête précédente enregistrée avec la SaveViewState() méthode. (Hérité de WebControl) |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| MergeStyle(Style) |
Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Déclenche l’événement Init. (Hérité de Control) |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l’événement PreRender pour le FileUpload contrôle. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Envoie le contenu du FileUpload contrôle à l’objet spécifié HtmlTextWriter , qui écrit le contenu à afficher sur le client. |
| RenderBeginTag(HtmlTextWriter) |
Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderContents(HtmlTextWriter) |
Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| RenderEndTag(HtmlTextWriter) |
Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles. (Hérité de WebControl) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL utilisable sur le client demandeur. (Hérité de Control) |
| SaveAs(String) |
Enregistre le contenu d’un fichier chargé dans un chemin d’accès spécifié sur le serveur Web. |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre tout état modifié après l’appel de la TrackViewState() méthode. (Hérité de WebControl) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
| TrackViewState() |
Provoque le suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété de l’objet ViewState . (Hérité de WebControl) |
Événements
| Nom | Description |
|---|---|
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| Disposed |
Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l’objet Page . (Hérité de Control) |
| PreRender |
Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control) |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtient un attribut du contrôle Web avec le nom spécifié. (Hérité de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Définit un attribut du contrôle Web sur le nom et la valeur spécifiés. (Hérité de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
Méthodes d’extension
| Nom | Description |
|---|---|
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
