ImageField Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ImageField, classe

 

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)

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

public class ImageField : DataControlField

NomDescription
System_CAPS_pubmethodImageField()

Initialise une nouvelle instance de la classe ImageField.

NomDescription
System_CAPS_pubpropertyAccessibleHeaderText

Obtient ou définit le texte affiché en tant que le AbbreviatedText valeur de propriété dans des contrôles.(Hérité de DataControlField.)

System_CAPS_pubpropertyAlternateText

Obtient ou définit le texte de remplacement affiché pour une image dans le ImageField objet.

System_CAPS_protpropertyControl

Obtient une référence au contrôle de données qui le DataControlField objet est associé.(Hérité de DataControlField.)

System_CAPS_pubpropertyControlStyle

Obtient le style des contrôles serveur Web contenus dans le DataControlField objet.(Hérité de DataControlField.)

System_CAPS_pubpropertyConvertEmptyStringToNull

Obtient ou définit une valeur qui indique si une chaîne vide (« ») sont converties en null lorsque les valeurs de champ sont retournées à partir de la source de données.

System_CAPS_pubpropertyDataAlternateTextField

Obtient ou définit le nom du champ de la source de données qui contient les valeurs à lier à la AlternateText propriété de chaque image dans un ImageField objet.

System_CAPS_pubpropertyDataAlternateTextFormatString

Obtient ou définit la chaîne qui spécifie le format dans lequel le texte de remplacement pour chaque image dans un ImageField objet rendu.

System_CAPS_pubpropertyDataImageUrlField

Obtient ou définit le nom du champ de la source de données qui contient les valeurs à lier à la ImageUrl propriété de chaque image dans un ImageField objet.

System_CAPS_pubpropertyDataImageUrlFormatString

Obtient ou définit la chaîne qui spécifie le format dans lequel l'URL de chaque image d'un ImageField objet rendu.

System_CAPS_protpropertyDesignMode

Obtient une valeur qui indique si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.(Hérité de DataControlField.)

System_CAPS_pubpropertyFooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyFooterText

Obtient ou définit le texte qui est affiché dans l'élément de pied de page d'un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderImageUrl

Obtient ou définit l'URL d'une image qui est affichée dans l'élément d'en-tête d'un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyHeaderText

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.)

System_CAPS_pubpropertyInsertVisible

Obtient une valeur indiquant si le DataControlField objet est visible lorsque son contrôle lié aux données de parent est en mode insertion.(Hérité de DataControlField.)

System_CAPS_protpropertyIsTrackingViewState

Obtient une valeur indiquant si le DataControlField objet enregistre les modifications apportées à son état d'affichage.(Hérité de DataControlField.)

System_CAPS_pubpropertyItemStyle

Obtient le style de tout contenu basé sur le texte affiché par un champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubpropertyNullDisplayText

Obtient ou définit le texte à afficher dans un ImageField de l'objet lorsque la valeur du champ spécifié par le DataImageUrlField propriété est null.

System_CAPS_pubpropertyNullImageUrl

Obtient ou définit l'URL vers une image de remplacement affichée dans un ImageField de l'objet lorsque la valeur du champ spécifié par le DataImageUrlField propriété est null.

System_CAPS_pubpropertyReadOnly

Obtient ou définit une valeur indiquant si les valeurs du champ spécifié par le DataImageUrlField propriété peut être modifiée en mode édition.

System_CAPS_pubpropertyShowHeader

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 restitué.(Hérité de DataControlField.)

System_CAPS_pubpropertySortExpression

Obtient ou définit une expression de tri qui est utilisée par un contrôle de source de données pour trier les données.(Hérité de DataControlField.)

System_CAPS_protpropertyValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.(Hérité de DataControlField.)

System_CAPS_protpropertyViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et restaurer l'état d'affichage d'un DataControlField objet entre plusieurs demandes de la même page.(Hérité de DataControlField.)

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur indiquant si un champ de données de contrôle est restitué.(Hérité de DataControlField.)

NomDescription
System_CAPS_protmethodCloneField()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Crée une copie de l'utilisateur actuel DataControlField-objet dérivé.(Hérité de DataControlField.)

System_CAPS_protmethodCopyProperties(DataControlField)

Copie les propriétés de l'utilisateur actuel ImageField objet à l'objet spécifié.(Remplace DataControlField.CopyProperties(DataControlField).)

System_CAPS_protmethodCreateField()

Retourne une nouvelle instance de la classe ImageField.(Remplace DataControlField.CreateField().)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)
System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_protmethodFormatImageUrlValue(Object)

Applique le format spécifié par le DataImageUrlFormatString propriété à une valeur de champ.

System_CAPS_protmethodGetDesignTimeValue()

Récupère la valeur utilisée pour la valeur d'un champ lors du rendu du ImageField objet dans un concepteur.

System_CAPS_protmethodGetFormattedAlternateText(Control)

Applique le format spécifié par la DataAlternateTextFormatString à la valeur de texte de remplacement contenue dans la propriété Control objet.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodGetValue(Control, String, PropertyDescriptor)

Récupère la valeur du champ spécifié du contrôle spécifié.

System_CAPS_pubmethodInitialize(Boolean, Control)

Initialise le ImageField objet.(Remplace DataControlField.Initialize(Boolean, Control).)

System_CAPS_pubmethodInitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialise le spécifié DataControlFieldCell objet avec le type de cellule spécifié, l'état de ligne et les index de ligne.(Remplace DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)

System_CAPS_protmethodInitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialise le spécifié DataControlFieldCell objet avec l'état spécifié.

System_CAPS_protmethodLoadViewState(Object)

Restaure la vue de source de données enregistré précédemment l'état d'affichage.(Hérité de DataControlField.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnDataBindField(Object, EventArgs)

Lie la valeur d'un champ à la ImageField objet.

System_CAPS_protmethodOnFieldChanged()

Déclenche l'événement FieldChanged.(Hérité de DataControlField.)

System_CAPS_protmethodSaveViewState()

Enregistre les modifications apportées à la DataControlField état d'affichage depuis la publication de la page sur le serveur.(Hérité de DataControlField.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente ce DataControlField objet.(Hérité de DataControlField.)

System_CAPS_protmethodTrackViewState()

Provoque la DataControlField objet à suivre les modifications apportées à son état d’affichage afin qu’ils puissent être stockées dans le contrôle ViewState propriété et être persistantes entre les demandes pour la même page.(Hérité de DataControlField.)

System_CAPS_pubmethodValidateSupportsCallback()

Détermine si les contrôles contenus dans un ImageField des rappels de prise en charge de l'objet.(Remplace DataControlField.ValidateSupportsCallback().)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticThisExpression

Représente l’expression « this ».

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Restaure l'état d'affichage enregistré précédemment du champ de contrôle de données.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Enregistre les modifications apportées à la DataControlField état d'affichage depuis la publication de la page sur le serveur.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Provoque la DataControlField objet à suivre les modifications apportées à son état d'affichage afin qu'ils puissent être stockées dans le contrôle ViewState propriété et être persistantes entre les demandes pour la même page.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient ou définit le schéma associé à ce DataControlField objet.(Hérité de DataControlField.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient une valeur indiquant si le DataControlField objet enregistre les modifications apportées à son état d'affichage.(Hérité de DataControlField.)

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é. Le ImageField objet est affiché différemment selon le contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle qui affiche un ImageField objet sous la forme d'une colonne, tandis que le DetailsView contrôle l'affiche comme une ligne.

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

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

  • Utilisez le DataAlternateTextField propriété à lier un champ d'une source de données pour le 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 de l'URL d'une image est null, une image ne peut pas être affichée. Vous pouvez afficher une image de remplacement pour null les valeurs des champs en définissant le NullImageUrl propriété. Au lieu d'une image de remplacement, vous pouvez afficher le texte de remplacement en définissant le 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 le Visible propriété false.

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

System_CAPS_noteRemarque

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement l'intégralité de l'en-tête du contrôle. Ces contrôles liés aux données ne gèrent pas la ShowHeader propriété pour un champ lié aux données. Pour afficher ou masquer l'intégralité de l'en-tête d'un contrôle lié aux données, utilisez le contrôle ShowHeader propriété (si disponible).

Vous pouvez également personnaliser l'apparence de la ImageField objet (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.

Propriété de style

Description

ControlStyle

Les paramètres de style des contrôles serveur Web enfants de le ImageField objet.

FooterStyle

Les paramètres de style pour la section de pied de page de la ImageField objet.

HeaderStyle

Les paramètres de style pour la section d'en-tête de la ImageField objet.

ItemStyle

Les paramètres de style pour les éléments de données dans le ImageField objet.

L'exemple suivant montre comment utiliser un ImageField de l'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>

.NET Framework
Disponible depuis 2.0

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

Retour au début
Afficher:
© 2016 Microsoft