Freigeben über

ImageField.DataImageUrlFormatString Eigenschaft

  • Referenz

Definition

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

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

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

Eigenschaftswert

String

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

Beispiele

Im folgenden Beispielcode wird veranschaulicht, wie Sie die DataImageUrlFormatString Eigenschaft verwenden, um ein benutzerdefiniertes Format auf die URL-Werte 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="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>

Hinweise

Verwenden Sie die DataImageUrlFormatString Eigenschaft, um ein benutzerdefiniertes Format für die URLs der in einem ImageField Objekt angezeigten Bilder anzugeben. Dies ist nützlich, wenn Sie eine URL generieren müssen, z. B. wenn das ImageField Objekt einfach den Dateinamen enthält. Wenn die Eigenschaft nicht festgelegt ist, erhalten die DataImageUrlFormatString URL-Werte keine spezielle Formatierung.

Die Formatzeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispiel: In der Formatzeichenfolge "Elementwert: {0}", der{0} Platzhalter "" wird durch den Wert der durch die DataImageUrlField Eigenschaft angegebenen Felder ersetzt. Der Rest der Formatzeichenfolge wird als Literaltext angezeigt.

Hinweis

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

Der Platzhalter besteht aus zwei Teilen, die durch einen Doppelpunkt ("{}:") getrennt sind und in Klammern (""), in das Formular {A:Bxx}eingeschlossen 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 nur ein Feldwert in jeder Zelle 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 allgemeinen Formate aufgeführt.

Zeichen formatieren 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

Die Formatzeichen sind nicht Groß-/Kleinschreibung, außer Xfür die Hexadezimalzeichen im angegebenen Fall.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl von signifikanten Ziffern oder Dezimalstellen an, die angezeigt werden sollen. Beispielsweise zeigt die Formatzeichenfolge "{0:F2}" eine Feste Punktnummer mit 2 Dezimalstellen an.

Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Gilt für

Siehe auch