ImageField.DataAlternateTextFormatString Eigenschaft

  • Referenz

Definition

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

Ruft die Zeichenfolge ab, oder legt die Zeichenfolge fest, die das Format angibt, mit dem der alternative Text für jedes Bild in einem ImageField-Objekt gerendert wird.

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

Eigenschaftswert

String

Eine Zeichenfolge, die das Format angibt, mit dem der alternative Text für jedes Bild in einem ImageField-Objekt gerendert wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass keine besondere Formatierung auf den alternativen Text angewendet wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataAlternateTextFormatString -Eigenschaft verwendet wird, um ein benutzerdefiniertes Format auf die alternativen Textwerte für die Bilder in einem ImageField -Objekt anzuwenden.


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

Hinweise

Verwenden Sie die DataAlternateTextFormatString -Eigenschaft, um ein benutzerdefiniertes Format für die alternativen Textwerte der in einem ImageField -Objekt angezeigten Bilder anzugeben.

Hinweis

Die Formatzeichenfolge wird nur angewendet, wenn die DataAlternateTextField -Eigenschaft festgelegt ist. Sie wird nicht angewendet, wenn die AlternateText -Eigenschaft festgelegt wird.

Dies ist nützlich, wenn Sie den ursprünglichen Wert ändern müssen, der im Feld enthalten ist. Wenn die DataAlternateTextFormatString -Eigenschaft nicht festgelegt ist, erhalten die alternativen Textwerte keine spezielle Formatierung.

Die Formatzeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispielsweise wird in der Formatzeichenfolge "Item Value: {0}"" der Platzhalter "{0}" durch den Wert der felder ersetzt, die von der DataAlternateTextField -Eigenschaft angegeben werden. Der Rest der Formatzeichenfolge wird als Literaltext angezeigt.

Hinweis

Wenn die Formatzeichenfolge keinen Platzhalter enthält, ist der Wert des Felds aus der Datenquelle nicht im endgültigen Anzeigetext enthalten.

Der Platzhalter besteht aus zwei Teilen, die durch einen Doppelpunkt (":") getrennt und in geschweifte Klammern ("{}") im Format {A:Bxx}umschlossen sind. Der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) gibt den Index des Feldwerts in einer nullbasierten Liste von Parametern an.

Hinweis

Dieser Parameter ist Teil der Formatierungssyntax. Da in jeder Zelle nur ein Feldwert vorhanden ist, kann dieser Wert nur auf 0 festgelegt werden.

Der Doppelpunkt und die Werte nach dem Doppelpunkt sind optional. Das Zeichen nach dem Doppelpunkt (B im allgemeinen Beispiel) gibt das Format an, in dem der Wert angezeigt werden soll. In der folgenden Tabelle sind die gängigen Formate aufgeführt.

Formatieren von Zeichen BESCHREIBUNG
C Zeigt numerische Werte im Währungsformat an.
D Zeigt numerische Werte im Dezimalformat an.
E Zeigt numerische Werte im wissenschaftlichen (exponentiellen) Format an.
F Zeigt numerische Werte im festen Format an.
G Zeigt numerische Werte im allgemeinen Format an.
N Zeigt numerische Werte im Zahlenformat an.
X Zeigt numerische Werte im Hexadezimalformat an.

Hinweis

Bei den Formatzeichen wird die Groß-/Kleinschreibung nicht beachtet, mit Ausnahme Xvon , in dem die Hexadezimalzeichen in der angegebenen Groß-/Kleinschreibung angezeigt werden.

Der Wert nach dem Formatzeichen (im allgemeinen Beispiel xx) gibt die Anzahl der anzuzeigenden signifikanten Ziffern oder Dezimalstellen an. Die Formatzeichenfolge "{0:F2}" zeigt beispielsweise eine Festpunktzahl mit 2 Dezimalstellen an.

Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Gilt für:

Weitere Informationen