ImageField.DataAlternateTextFormatString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la stringa che specifica il formato per il rendering del testo alternativo di ciascuna immagine di un oggetto ImageField.

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

Valore della proprietà

String

Stringa che specifica il formato per il rendering del testo alternativo di ciascuna immagine di un oggetto ImageField. Il valore predefinito è una stringa vuota (""), a indicare che al valore di campo non è stata applicata alcuna formattazione speciale.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la DataAlternateTextFormatString proprietà per applicare un formato personalizzato ai valori di testo alternativi per le immagini in un ImageField oggetto.


<%@ 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>

Commenti

Utilizzare la DataAlternateTextFormatString proprietà per specificare un formato personalizzato per i valori di testo alternativi delle immagini visualizzate in un ImageField oggetto.

Nota

La stringa di formato viene applicata solo quando la DataAlternateTextField proprietà è impostata. Non viene applicato quando la AlternateText proprietà è impostata.

Ciò è utile quando è necessario modificare il valore originale contenuto nel campo. Se la DataAlternateTextFormatString proprietà non è impostata, i valori di testo alternativi non ottengono alcuna formattazione speciale.

La stringa di formato può essere qualsiasi stringa letterale e in genere contiene un segnaposto per il valore del campo. Ad esempio, nella stringa di formato "Valore elemento: {0}", il segnaposto "{0}" viene sostituito con il valore dei campi specificati dalla DataAlternateTextField proprietà . Il resto della stringa di formato viene visualizzato come testo letterale.

Nota

Se la stringa di formato non include un segnaposto, il valore del campo dall'origine dati non è incluso nel testo di visualizzazione finale.

Il segnaposto è costituito da due parti separate da due punti (":") e racchiuse tra parentesi graffe ("{}"), nel formato {A:Bxx}. Il valore prima dei due punti (A nell'esempio generale) specifica l'indice del valore del campo in un elenco di parametri basato su zero.

Nota

Questo parametro fa parte della sintassi di formattazione. Poiché in ogni cella è presente un solo valore di campo, questo valore può essere impostato solo su 0.

I due punti e i valori dopo i due punti sono facoltativi. Il carattere dopo i due punti (B nell'esempio generale) specifica il formato in cui visualizzare il valore. Nella tabella seguente sono elencati i formati comuni.

Formato carattere Descrizione
C Visualizza i valori numerici in formato valuta.
D Visualizza i valori numerici in formato decimale.
E Visualizza i valori numerici in formato scientifico (esponenziale).
F Visualizza i valori numerici in formato fisso.
G Visualizza i valori numerici in formato generale.
N Visualizza i valori numerici in formato numero.
X Visualizza valori numerici in formato esadecimale.

Nota

I caratteri di formato non sono distinzione tra maiuscole e minuscole, ad eccezione Xdi , che visualizza i caratteri esadecimali nel caso specificato.

Il valore dopo il carattere di formato (xx nell'esempio generale) specifica il numero di cifre significative o cifre decimali da visualizzare. Ad esempio, la stringa di formato "{0:F2}" visualizza un numero a virgola fissa con 2 cifre decimali.

Per altre informazioni sulla formattazione, vedere Formattazione dei tipi.

Si applica a

Vedi anche