ImageField.DataAlternateTextFormatString Eigenschap

Definitie

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

Hiermee haalt u de tekenreeks op waarmee de indeling wordt opgegeven waarin de alternatieve tekst voor elke afbeelding in een ImageField object wordt weergegeven.

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

Waarde van eigenschap

String

Een tekenreeks die de indeling aangeeft waarin de alternatieve tekst voor elke afbeelding in een ImageField object wordt weergegeven. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat er nu speciale opmaak wordt toegepast op de alternatieve tekst.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de DataAlternateTextFormatString eigenschap gebruikt om een aangepaste notatie toe te passen op de alternatieve tekstwaarden 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="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>

Opmerkingen

Gebruik de DataAlternateTextFormatString eigenschap om een aangepaste notatie op te geven voor de alternatieve tekstwaarden van de afbeeldingen die in een ImageField object worden weergegeven.

Note

De notatietekenreeks wordt alleen toegepast wanneer de DataAlternateTextField eigenschap is ingesteld. Deze wordt niet toegepast wanneer de AlternateText eigenschap is ingesteld.

Dit is handig wanneer u de oorspronkelijke waarde in het veld moet wijzigen. Als de DataAlternateTextFormatString eigenschap niet is ingesteld, krijgen de alternatieve tekstwaarden 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 DataAlternateTextField 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