ImageField.DataAlternateTextFormatString 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 le texte de remplacement pour chaque image dans un objet ImageField est restitué.

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

Valeur de propriété

String

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

Exemples

L’exemple de code suivant montre comment utiliser la DataAlternateTextFormatString propriété pour appliquer un format personnalisé aux valeurs de texte alternatives pour les 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="PhotoPath"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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"
            dataalternatetextfield="LastName"
            dataalternatetextformatstring="Photo: {0}" 
            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

Utilisez la DataAlternateTextFormatString propriété pour spécifier un format personnalisé pour les valeurs de texte de remplacement des images affichées dans un ImageField objet.

Notes

La chaîne de format est appliquée uniquement lorsque la DataAlternateTextField propriété est définie. Elle n’est pas appliquée lorsque la AlternateText propriété est définie.

Cela est utile lorsque vous devez modifier la valeur d’origine contenue dans le champ. Si la DataAlternateTextFormatString propriété n’est pas définie, les valeurs de texte de remplacement n’obtiennent 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 « Item Value : {0}», l’espace réservé «{0} » est remplacé par la valeur des champs spécifiés par la DataAlternateTextField 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 les deux-points (A dans l’exemple général) spécifie l’index de la valeur de champ dans une liste de paramètres de base zéro.

Notes

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

Les deux-points et les valeurs après les deux-points sont facultatifs. Le caractère après les 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 mise en forme 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 numérique.
X Affiche les valeurs numériques au format hexadécimal.

Notes

Les caractères de format ne respectent pas la casse, à l’exception de 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