Bagikan melalui

ImageField.DataImageUrlFormatString Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur string yang menentukan format di mana URL untuk setiap gambar dalam objek dirender ImageField .

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

Nilai Properti

String

String yang menentukan format di mana URL untuk setiap gambar dalam ImageField objek dirender. Defaultnya adalah string kosong ("") , yang menunjukkan bahwa tidak ada pemformatan khusus yang diterapkan ke URL.

Contoh

Contoh kode berikut menunjukkan cara menggunakan DataImageUrlFormatString properti untuk menerapkan format kustom ke nilai URL untuk gambar dalam ImageField objek.


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

Keterangan

DataImageUrlFormatString Gunakan properti untuk menentukan format kustom untuk URL gambar yang ditampilkan dalam ImageField objek. Ini berguna ketika Anda perlu membuat URL, seperti ketika ImageField objek hanya berisi nama file. DataImageUrlFormatString Jika properti tidak diatur, nilai URL tidak mendapatkan pemformatan khusus.

String format dapat berupa string harfiah apa pun dan biasanya berisi tempat penampung untuk nilai bidang. Misalnya, dalam string format "Nilai Item: {0}", tempat penampung "{0}" diganti dengan nilai bidang yang ditentukan oleh DataImageUrlField properti . String format lainnya ditampilkan sebagai teks harfiah.

Nota

Jika string format tidak menyertakan tempat penampung, nilai bidang dari sumber data tidak disertakan dalam teks tampilan akhir.

Tempat penampung terdiri dari dua bagian yang dipisahkan oleh titik dua (":") dan dibungkus dengan kurung kurawal ("{}"), dalam bentuk {A:Bxx}. Nilai sebelum titik dua (A dalam contoh umum) menentukan indeks nilai bidang dalam daftar parameter berbasis nol.

Nota

Parameter ini adalah bagian dari sintaks pemformatan. Karena hanya ada satu nilai bidang di setiap sel, nilai ini hanya dapat diatur ke 0.

Titik dua dan nilai setelah titik dua bersifat opsional. Karakter setelah titik dua (B dalam contoh umum) menentukan format untuk menampilkan nilai. Tabel berikut mencantumkan format umum.

Format karakter Deskripsi
C Menampilkan nilai numerik dalam format mata uang.
D Menampilkan nilai numerik dalam format desimal.
E Menampilkan nilai numerik dalam format ilmiah (eksponensial).
F Menampilkan nilai numerik dalam format tetap.
G Menampilkan nilai numerik dalam format umum.
N Menampilkan nilai numerik dalam format angka.
X Menampilkan nilai numerik dalam format heksadesimal.

Nota

Karakter format tidak peka huruf besar/kecil, kecuali untuk X, yang menampilkan karakter heksadesimal dalam kasus yang ditentukan.

Nilai setelah karakter format (xx dalam contoh umum) menentukan jumlah digit signifikan atau tempat desimal yang akan ditampilkan. Misalnya, string format "{0:F2}" menampilkan angka titik tetap dengan 2 tempat desimal.

Untuk informasi selengkapnya tentang pemformatan, lihat Tipe Pemformatan.

Berlaku untuk

Lihat juga