Cette documentation est archivée et n’est pas conservée.

ImageField, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente un champ qui s'affiche en tant qu'image dans un contrôle lié aux données.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class ImageField : DataControlField
public class ImageField extends DataControlField
public class ImageField extends DataControlField

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

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

  • Utilisez la propriété AlternateText pour spécifier le texte de remplacement qui s'applique à toutes les images.

  • Utilisez la propriété DataAlternateTextField pour lier un champ d'une source de données à la propriété AlternateText de chaque image. Cela vous permet d'avoir un texte de remplacement différent pour chaque image affichée. Lorsque vous liez des données, vous pouvez mettre le texte de remplacement en forme en utilisant la propriété DataAlternateTextFormatString.

Lorsque la valeur d'URL d'une image est référence Null (Nothing en Visual Basic), l'image ne peut pas être affichée. Vous pouvez afficher une image de remplacement pour les valeurs de champ référence Null (Nothing en Visual Basic) en définissant la propriété NullImageUrl. Plutôt qu'une image de remplacement, vous pouvez afficher le texte de remplacement en définissant la propriété NullDisplayText.

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

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

RemarqueRemarque

Certains contrôles liés aux données (tels que le contrôle GridView) peuvent afficher ou masquer entièrement la section d'en-tête du contrôle. Ces contrôles liés aux données ne prennent pas en charge la propriété ShowHeader pour un champ individuel 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é ShowHeader du contrôle (le cas échéant).

Vous pouvez également personnaliser l'apparence de l'objet ImageField (couleur de police, couleur d'arrière-plan, etc.) en définissant les propriétés de style des différentes parties du champ. Le tableau suivant énumère les différentes propriétés de style.

Propriété de style

Description

ControlStyle

Paramètres de style des contrôles serveur Web enfants de l'objet ImageField.

FooterStyle

Paramètres de style de la section de 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 des éléments de données de l'objet ImageField.

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


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

<html>
  <body>
    <form 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>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.ImageField

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: