ImageField.DataImageUrlFormatString Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt de tekenreeks opgehaald of ingesteld waarmee de indeling wordt opgegeven waarin de URL voor elke afbeelding in een ImageField object wordt weergegeven.

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

Waarde van eigenschap

String

Een tekenreeks die de indeling aangeeft waarin de URL voor elke afbeelding in een ImageField object wordt weergegeven. De standaardwaarde is de lege tekenreeks ("") die aangeeft dat er geen speciale opmaak wordt toegepast op de URL's.

Voorbeelden

In de volgende voorbeeldcode ziet u hoe u de DataImageUrlFormatString eigenschap gebruikt om een aangepaste indeling toe te passen op de URL-waarden voor de afbeeldingen in een ImageField object.


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

Opmerkingen

Gebruik de DataImageUrlFormatString eigenschap om een aangepaste indeling op te geven voor de URL's van de afbeeldingen die in een ImageField object worden weergegeven. Dit is handig wanneer u een URL moet genereren, bijvoorbeeld wanneer het ImageField object gewoon de bestandsnaam bevat. Als de DataImageUrlFormatString eigenschap niet is ingesteld, krijgen de URL-waarden geen speciale opmaak.

De notatietekenreeks kan elke letterlijke tekenreeks zijn en bevat meestal een tijdelijke aanduiding voor de waarde van het veld. In de notatietekenreeks 'Itemwaarde: {0}', wordt de tijdelijke aanduiding '{0}' vervangen door de waarde van de velden die door de DataImageUrlField eigenschap zijn opgegeven. De rest van de notatietekenreeks wordt weergegeven als letterlijke tekst.

Note

Als de notatietekenreeks geen tijdelijke aanduiding bevat, wordt de waarde van het veld uit de gegevensbron niet opgenomen in de uiteindelijke weergavetekst.

De tijdelijke aanduiding bestaat uit twee delen gescheiden door een dubbele punt (":") en verpakt in accolades ("{}"), in de vorm {A:Bxx}. De waarde vóór de dubbele punt (A in het algemene voorbeeld) geeft de index van de veldwaarde op in een op nul gebaseerde lijst met parameters.

Note

Deze parameter maakt deel uit van de syntaxis van de opmaak. Omdat er slechts één veldwaarde in elke cel is, kan deze waarde alleen worden ingesteld op 0.

De dubbele punt en de waarden na de dubbele punt zijn optioneel. Het teken na de dubbele punt (B in het algemene voorbeeld) geeft de notatie op waarin de waarde moet worden weergegeven. De volgende tabel bevat de algemene notaties.

Teken opmaken Beschrijving
C Geeft numerieke waarden weer in valutanotatie.
D Geeft numerieke waarden weer in decimale notatie.
E Geeft numerieke waarden weer in wetenschappelijke (exponentiële) notatie.
F Geeft numerieke waarden weer in vaste notatie.
G Geeft numerieke waarden weer in de algemene notatie.
N Geeft numerieke waarden weer in getalnotatie.
X Geeft numerieke waarden weer in hexadecimale notatie.

Note

De notatietekens zijn niet hoofdlettergevoelig, met uitzondering van X, waarin de hexadecimale tekens worden weergegeven in het opgegeven geval.

De waarde na het notatieteken (xx in het algemene voorbeeld) geeft het aantal significante cijfers of decimalen op dat moet worden weergegeven. De notatietekenreeks '{0:F2}' geeft bijvoorbeeld een vast puntnummer weer met 2 decimalen.

Zie Opmaaktypen voor meer informatie over opmaak.

Van toepassing op

Zie ook