ImageField.DataImageUrlFormatString Propriété

  • Référence

Définition

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

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

public:
 virtual property System::String ^ DataImageUrlFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataImageUrlFormatString { get; set; }
member this.DataImageUrlFormatString : string with get, set
Public Overridable Property DataImageUrlFormatString As String

Valeur de propriété

String

Chaîne qui spécifie le format dans lequel l'URL de chaque image d'un objet ImageField est restituée. La valeur par défaut est la chaîne vide ("") qui indique qu'aucune mise en forme spéciale n'est appliquée aux URL.

Exemples

L’exemple de code suivant montre comment utiliser la DataImageUrlFormatString propriété pour appliquer un format personnalisé aux valeurs d’URL des images d’un ImageField objet.


<%@ 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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] 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="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Remarques

Utilisez la DataImageUrlFormatString propriété pour spécifier un format personnalisé pour les URL des images affichées dans un ImageField objet. Cela est utile lorsque vous devez générer une URL, par exemple lorsque l’objet ImageField contient simplement le nom de fichier. Si la DataImageUrlFormatString propriété n’est pas définie, les valeurs d’URL ne reçoivent aucune mise en forme spéciale.

La chaîne de format peut être n’importe quelle chaîne littérale et contient généralement un espace réservé pour la valeur du champ. Par exemple, dans la chaîne de format « Valeur de l’élément : « {0}, l’espace réservé «{0} » est remplacé par la valeur des champs spécifiés par la DataImageUrlField propriété. Le reste de la chaîne de format s’affiche sous forme de texte littéral.

Notes

Si la chaîne de format n’inclut pas d’espace réservé, la valeur du champ de la source de données n’est pas incluse dans le texte d’affichage final.

L’espace réservé se compose de deux parties séparées par un signe deux-points (« : ») et encapsulées dans des accolades («{} »), sous la forme {A:Bxx}. La valeur avant le signe deux-points (A dans l’exemple général) spécifie l’index de la valeur de champ dans une liste de paramètres basée sur zéro.

Notes

Ce paramètre fait partie de la syntaxe de mise en forme. Étant donné qu’il n’existe qu’une seule valeur de champ dans chaque cellule, cette valeur ne peut être définie que sur 0.

Le signe deux-points et les valeurs après le signe deux-points sont facultatifs. Le caractère après le signe deux-points (B dans l’exemple général) spécifie le format dans lequel afficher la valeur. Le tableau suivant répertorie les formats courants.

Caractère de format Description
C Affiche les valeurs numériques au format monétaire.
D Affiche les valeurs numériques au format décimal.
E Affiche les valeurs numériques au format scientifique (exponentiel).
F Affiche les valeurs numériques au format fixe.
G Affiche les valeurs numériques au format général.
N Affiche les valeurs numériques au format nombre.
X Affiche les valeurs numériques au format hexadécimal.

Notes

Les caractères de format ne respectent pas la casse, sauf pour X, qui affiche les caractères hexadécimaux dans le cas spécifié.

La valeur après le caractère de format (xx dans l’exemple général) spécifie le nombre de chiffres significatifs ou de décimales à afficher. Par exemple, la chaîne de format «{0:F2} » affiche un nombre à point fixe avec 2 décimales.

Pour plus d’informations sur la mise en forme, consultez Types de mise en forme.

S’applique à

Voir aussi