ImageField.DataImageUrlFormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ciąg określający format renderowania adresu URL dla każdego obrazu w ImageField obiekcie.

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

Wartość właściwości

String

Ciąg określający format, w którym jest renderowany adres URL każdego obrazu w ImageField obiekcie. Wartość domyślna to pusty ciąg (""), który wskazuje, że do adresów URL nie zastosowano żadnego specjalnego formatowania.

Przykłady

Poniższy przykładowy kod pokazuje, jak za pomocą DataImageUrlFormatString właściwości zastosować niestandardowy format do wartości adresów URL obrazów w ImageField obiekcie.


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

Uwagi

DataImageUrlFormatString Użyj właściwości , aby określić niestandardowy format adresów URL obrazów wyświetlanych w ImageField obiekcie. Jest to przydatne, gdy trzeba wygenerować adres URL, na przykład gdy ImageField obiekt po prostu zawiera nazwę pliku. Jeśli właściwość nie jest ustawiona DataImageUrlFormatString , wartości adresu URL nie otrzymują żadnego specjalnego formatowania.

Ciąg formatu może być dowolnym ciągiem literału i zwykle zawiera symbol zastępczy wartości pola. Na przykład w ciągu formatu "Wartość elementu: {0}"symbol zastępczy "{0}" jest zastępowany wartością pól określonych przez DataImageUrlField właściwość. Pozostała część ciągu formatu jest wyświetlana jako tekst literału.

Uwaga

Jeśli ciąg formatu nie zawiera symbolu zastępczego, wartość pola ze źródła danych nie jest uwzględniona w końcowym tekście wyświetlanym.

Symbol zastępczy składa się z dwóch części oddzielonych dwukropkiem (":") i opakowanych w nawiasy klamrowe ("{}"), w postaci {A:Bxx}. Wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks wartości pola na liście parametrów opartych na zera.

Uwaga

Ten parametr jest częścią składni formatowania. Ponieważ w każdej komórce istnieje tylko jedna wartość pola, tę wartość można ustawić tylko na 0.

Dwukropek i wartości po dwukropku są opcjonalne. Znak po dwukropku (B w ogólnym przykładzie) określa format, w którym ma być wyświetlana wartość. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Opis
C Wyświetla wartości liczbowe w formacie waluty.
D Wyświetla wartości liczbowe w formacie dziesiętny.
E Wyświetla wartości liczbowe w formacie naukowym (wykładniczym).
F Wyświetla wartości liczbowe w stałym formacie.
G Wyświetla wartości liczbowe w formacie ogólnym.
N Wyświetla wartości liczbowe w formacie liczbowym.
X Wyświetla wartości liczbowe w formacie szesnastkowym.

Uwaga

W znakach formatu nie jest uwzględniana wielkość liter, z wyjątkiem Xznaku , który wyświetla znaki szesnastkowe w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia. Na przykład ciąg formatu "{0:F2}" wyświetla liczbę o stałym punkcie z 2 miejscami dziesiętnymi.

Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Dotyczy

Zobacz też