ImageField Classe

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Représente un champ affiché sous forme d’image dans un contrôle lié aux données.

public ref class ImageField : System::Web::UI::WebControls::DataControlField

public class ImageField : System.Web.UI.WebControls.DataControlField

type ImageField = class
    inherit DataControlField

Public Class ImageField
Inherits DataControlField

Héritage: Object

DataControlField
ImageField

Exemples

L’exemple suivant montre comment utiliser un ImageField objet dans un GridView contrôle pour afficher une image.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </columns>
        
      </asp:gridview>
          
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ImageField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="PhotoPath"
            alternatetext="Employee Photo"
            nulldisplaytext="No image on file."
            headertext="Photo"  
            readonly="true"/>
          <asp:boundfield datafield="FirstName"
            headertext="First Name"/>
          <asp:boundfield datafield="LastName"
            headertext="Last Name"/>
        
        </columns>
        
      </asp:gridview>
          
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Remarques

La ImageField classe est utilisée par les contrôles liés aux données (tels que GridView et DetailsView) pour afficher une image pour chaque enregistrement affiché. L’objet ImageField est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un ImageField objet sous forme de colonne, tandis que le DetailsView contrôle l’affiche sous forme de ligne.

Pour afficher des images, vous devez lier un ImageField objet à un champ à partir d’une source de données qui contient l’URL d’une image. Pour ce faire, définissez la DataImageUrlField propriété. La valeur d’URL peut être mise en forme à l’aide de la DataImageUrlFormatString propriété. Chaque image peut également avoir un texte de remplacement associé à celui-ci. Ce texte s’affiche lorsqu’une image ne peut pas être chargée ou n’est pas disponible. Les navigateurs qui prennent en charge la fonctionnalité Info-bulle affichent également ce texte en tant qu’info-bulle. Vous pouvez spécifier le texte de remplacement d’une image affichée à l’aide de l’une des méthodes suivantes :

Utilisez la propriété pour spécifier un AlternateText texte de remplacement qui s’applique à toutes les images.
Utilisez la DataAlternateTextField propriété pour lier un champ d’une source de données à la AlternateText propriété de chaque image. Cela vous permet d’avoir un texte de remplacement différent pour chaque image affichée. Lors de la liaison de données, vous pouvez éventuellement mettre en forme le texte de remplacement à l’aide de la DataAlternateTextFormatString propriété.

Lorsque la valeur d’URL d’une image est null, une image ne peut pas être affichée. Vous pouvez afficher une autre image pour null les valeurs de champ en définissant la NullImageUrl propriété. Au lieu d’une autre image, vous pouvez afficher du texte de remplacement en définissant la NullDisplayText propriété.

Par défaut, tous les champs déclarés sont affichés dans un contrôle lié aux données. Vous pouvez masquer un ImageField objet dans un contrôle lié aux données en définissant la Visible propriété falsesur .

Vous pouvez personnaliser les sections d’en-tête et de pied de page d’un ImageField objet. Pour afficher une légende dans la section en-tête ou pied de page, définissez respectivement les propriétés ou FooterText l’en-têteHeaderText. Pour afficher une image dans la section d’en-tête au lieu de texte, définissez la HeaderImageUrl propriété. La section d’en-tête peut être masquée dans l’objet ImageField en définissant la ShowHeader propriété sur false.

Note

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété pour un champ lié aux données. Pour afficher ou masquer l’intégralité de la section d’en-tête d’un contrôle lié aux données, utilisez la propriété du ShowHeader contrôle (le cas échéant).

Vous pouvez également personnaliser l’apparence de l’objet ImageField (couleur de police, couleur d’arrière-plan, et ainsi de suite) en définissant les propriétés de style pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Style, propriété	Description
ControlStyle	Paramètres de style pour les contrôles de serveur Web enfant de l’objet ImageField .
FooterStyle	Paramètres de style de la section pied de page de l’objet ImageField .
HeaderStyle	Paramètres de style de la section d’en-tête de l’objet ImageField .
ItemStyle	Paramètres de style pour les éléments de données de l’objet ImageField .

Constructeurs

Nom	Description
ImageField()	Initialise une nouvelle instance de la classe ImageField.

Champs

Nom	Description
ThisExpression	Représente l’expression « this ».

Propriétés

Nom	Description
AccessibleHeaderText	Obtient ou définit le `AbbreviatedText` texte qui est rendu en tant que valeur de propriété dans certains contrôles. (Hérité de DataControlField)
AlternateText	Obtient ou définit le texte de remplacement affiché pour une image dans l’objet ImageField .
Control	Obtient une référence au contrôle de données auquel l’objet DataControlField est associé. (Hérité de DataControlField)
ControlStyle	Obtient le style de tous les contrôles de serveur Web contenus par l’objet DataControlField . (Hérité de DataControlField)
ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si les valeurs de chaîne vide (« ») sont converties `null` lorsque les valeurs de champ sont retournées à partir de la source de données.
DataAlternateTextField	Obtient ou définit le nom du champ à partir de la source de données qui contient les valeurs à lier à la AlternateText propriété de chaque image d’un ImageField objet.
DataAlternateTextFormatString	Obtient ou définit la chaîne qui spécifie le format dans lequel le texte de remplacement de chaque image d’un ImageField objet est affiché.
DataImageUrlField	Obtient ou définit le nom du champ à partir de la source de données qui contient les valeurs à lier à la ImageUrl propriété de chaque image d’un ImageField objet.
DataImageUrlFormatString	Obtient ou définit la chaîne qui spécifie le format dans lequel l’URL de chaque image d’un ImageField objet est affichée.
DesignMode	Obtient une valeur indiquant si un champ de contrôle de données est actuellement consulté dans un environnement au moment du design. (Hérité de DataControlField)
FooterStyle	Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField)
FooterText	Obtient ou définit le texte affiché dans l’élément de pied de page d’un champ de contrôle de données. (Hérité de DataControlField)
HeaderImageUrl	Obtient ou définit l’URL d’une image affichée dans l’élément d’en-tête d’un champ de contrôle de données. (Hérité de DataControlField)
HeaderStyle	Obtient ou définit le style de l’en-tête du champ de contrôle de données. (Hérité de DataControlField)
HeaderText	Obtient ou définit le texte affiché dans l’élément d’en-tête d’un champ de contrôle de données. (Hérité de DataControlField)
InsertVisible	Obtient une valeur indiquant si l’objet DataControlField est visible lorsque son contrôle parent lié aux données est en mode d’insertion. (Hérité de DataControlField)
IsTrackingViewState	Obtient une valeur indiquant si l’objet DataControlField enregistre les modifications apportées à son état d’affichage. (Hérité de DataControlField)
ItemStyle	Obtient le style d’un contenu textuel affiché par un champ de contrôle de données. (Hérité de DataControlField)
NullDisplayText	Obtient ou définit le texte à afficher dans un ImageField objet lorsque la valeur du champ spécifié par la DataImageUrlField propriété est `null`.
NullImageUrl	Obtient ou définit l’URL d’une autre image affichée dans un ImageField objet lorsque la valeur du champ spécifié par la DataImageUrlField propriété est `null`.
ReadOnly	Obtient ou définit une valeur indiquant si les valeurs du champ spécifié par la DataImageUrlField propriété peuvent être modifiées en mode édition.
ShowHeader	Obtient ou définit une valeur indiquant si l’élément d’en-tête d’un champ de contrôle de données est rendu. (Hérité de DataControlField)
SortExpression	Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier les données. (Hérité de DataControlField)
ValidateRequestMode	Obtient ou définit une valeur qui spécifie si le contrôle valide l’entrée du client. (Hérité de DataControlField)
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un DataControlField objet sur plusieurs requêtes pour la même page. (Hérité de DataControlField)
Visible	Obtient ou définit une valeur indiquant si un champ de contrôle de données est rendu. (Hérité de DataControlField)

Méthodes

Nom	Description
CloneField()	Crée une copie en double de l’objet dérivé actuel DataControlField. (Hérité de DataControlField)
CopyProperties(DataControlField)	Copie les propriétés de l’objet actif ImageField vers l’objet spécifié.
CreateField()	Retourne une nouvelle instance de la ImageField classe.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Remplit l’objet spécifié IOrderedDictionary avec les valeurs de l’objet spécifié DataControlFieldCell .
FormatImageUrlValue(Object)	Applique le format spécifié par la DataImageUrlFormatString propriété à une valeur de champ.
GetDesignTimeValue()	Récupère la valeur utilisée pour la valeur d’un champ lors du rendu de l’objet ImageField dans un concepteur.
GetFormattedAlternateText(Control)	Applique le format spécifié par la DataAlternateTextFormatString propriété à la valeur de texte de remplacement contenue dans l’objet spécifié Control .
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValue(Control, String, PropertyDescriptor)	Récupère la valeur du champ spécifié à partir du contrôle spécifié.
Initialize(Boolean, Control)	Initialise l'objet ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialise l’objet spécifié DataControlFieldCell avec le type de cellule, l’état de ligne et l’index de ligne spécifiés.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialise l’objet spécifié DataControlFieldCell avec l’état de ligne spécifié.
LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré de la vue de source de données. (Hérité de DataControlField)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDataBindField(Object, EventArgs)	Lie la valeur d’un champ à l’objet ImageField .
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
ToString()	Retourne une chaîne qui représente cet DataControlField objet. (Hérité de DataControlField)
TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)
ValidateSupportsCallback()	Détermine si les contrôles contenus dans un ImageField objet prennent en charge les rappels.

Implémentations d’interfaces explicites

Nom	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet DataControlField objet. (Hérité de DataControlField)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l’objet DataControlField enregistre les modifications apportées à son état d’affichage. (Hérité de DataControlField)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré du champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?