ImageField.DataImageUrlFormatString 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 dell'URL di ciascuna immagine di un oggetto ImageField.

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

Valore della proprietà

String

Stringa che specifica il formato per il rendering dell'URL di ciascuna immagine di un oggetto ImageField. Il valore predefinito è una stringa vuota (""), a indicare che agli URL non è stata applicata alcuna formattazione speciale.

Esempio

Il codice di esempio seguente illustra come usare la DataImageUrlFormatString proprietà per applicare un formato personalizzato ai valori URL 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="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>

Commenti

Utilizzare la DataImageUrlFormatString proprietà per specificare un formato personalizzato per gli URL delle immagini visualizzate in un ImageField oggetto . Ciò è utile quando è necessario generare un URL, ad esempio quando l'oggetto ImageField contiene semplicemente il nome del file. Se la DataImageUrlFormatString proprietà non è impostata, i valori URL 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 DataImageUrlField 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 viene 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 in base zero di parametri.

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 numerico.
X Visualizza i valori numerici in formato esadecimale.

Nota

I caratteri di formato non fanno 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