Bagikan melalui

ImageField.DataAlternateTextFormatString Properti

Definisi

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

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

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

Nilai Properti

String

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

Contoh

Contoh kode berikut menunjukkan cara menggunakan DataAlternateTextFormatString properti untuk menerapkan format kustom ke nilai teks alternatif 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="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>

Keterangan

DataAlternateTextFormatString Gunakan properti untuk menentukan format kustom untuk nilai teks alternatif gambar yang ditampilkan dalam ImageField objek.

Nota

String format hanya diterapkan saat DataAlternateTextField properti diatur. Ini tidak diterapkan ketika AlternateText properti diatur.

Ini berguna ketika Anda perlu memodifikasi nilai asli yang terkandung di bidang . DataAlternateTextFormatString Jika properti tidak diatur, nilai teks alternatif 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 DataAlternateTextField 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