ImageField Kelas

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili bidang yang ditampilkan sebagai gambar dalam kontrol terikat data.

public ref class ImageField : System::Web::UI::WebControls::DataControlField

public class ImageField : System.Web.UI.WebControls.DataControlField

type ImageField = class
    inherit DataControlField

Public Class ImageField
Inherits DataControlField

Warisan: Object

DataControlField
ImageField

Contoh

Contoh berikut menunjukkan cara menggunakan ImageField objek dalam GridView kontrol untuk menampilkan gambar.


<%@ 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"
            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], [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"
            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], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Keterangan

Kelas ImageField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan gambar untuk setiap rekaman yang ditampilkan. Objek ImageField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan ImageField objek sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.

Untuk menampilkan gambar, Anda harus mengikat ImageField objek ke bidang dari sumber data yang berisi URL gambar. Ini dicapai dengan mengatur DataImageUrlField properti. Nilai URL dapat diformat dengan menggunakan DataImageUrlFormatString properti . Setiap gambar juga dapat memiliki teks alternatif yang terkait dengannya. Teks ini ditampilkan ketika gambar tidak dapat dimuat, atau tidak tersedia. Browser yang mendukung fitur TipsAlat juga menampilkan teks ini sebagai TipsAlat. Anda dapat menentukan teks alternatif untuk gambar yang ditampilkan dengan menggunakan salah satu metode berikut:

AlternateText Gunakan properti untuk menentukan teks alternatif yang berlaku untuk semua gambar.
DataAlternateTextField Gunakan properti untuk mengikat bidang dari sumber data ke AlternateText properti setiap gambar. Ini memungkinkan Anda memiliki teks alternatif yang berbeda untuk setiap gambar yang ditampilkan. Saat mengikat data, Anda dapat memformat teks alternatif secara opsional dengan menggunakan DataAlternateTextFormatString properti .

Ketika nilai URL untuk gambar adalah null, gambar tidak dapat ditampilkan. Anda dapat menampilkan gambar alternatif untuk null nilai bidang dengan mengatur NullImageUrl properti . Alih-alih gambar alternatif, Anda dapat menampilkan teks alternatif dengan mengatur NullDisplayText properti .

Secara default, semua bidang yang dideklarasikan ditampilkan dalam kontrol terikat data. Anda dapat menyembunyikan ImageField objek dalam kontrol terikat data dengan mengatur Visible properti ke false.

Anda dapat mengkustomisasi ImageField bagian header dan footer objek. Untuk menampilkan keterangan di bagian header atau footer, atur HeaderText properti atau FooterText . Untuk menampilkan gambar di bagian header, bukan teks, atur HeaderImageUrl properti . Bagian header dapat disembunyikan dalam ImageField objek dengan mengatur ShowHeader properti ke false.

Nota

Beberapa kontrol terikat data (seperti GridView kontrol) hanya dapat menampilkan atau menyembunyikan seluruh bagian header kontrol. Kontrol terikat data ini tidak mendukung ShowHeader properti untuk bidang terikat data individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data, gunakan properti kontrol ShowHeader (jika tersedia).

Anda juga dapat menyesuaikan tampilan ImageField objek (warna font, warna latar belakang, dan sebagainya) dengan mengatur properti gaya untuk berbagai bagian bidang. Tabel berikut ini mencantumkan properti gaya yang berbeda.

Properti gaya	Deskripsi
ControlStyle	Pengaturan gaya untuk kontrol server Web anak objek ImageField .
FooterStyle	Pengaturan gaya untuk bagian ImageField footer objek.
HeaderStyle	Pengaturan gaya untuk bagian ImageField header objek.
ItemStyle	Pengaturan gaya untuk item data dalam ImageField objek.

Konstruktor

Nama	Deskripsi
ImageField()	Menginisialisasi instans baru dari kelas ImageField.

Bidang

Nama	Deskripsi
ThisExpression	Mewakili ekspresi "ini".

Properti

Nama	Deskripsi
AccessibleHeaderText	Mendapatkan atau mengatur teks yang dirender sebagai `AbbreviatedText` nilai properti dalam beberapa kontrol. (Diperoleh dari DataControlField)
AlternateText	Mendapatkan atau mengatur teks alternatif yang ditampilkan untuk gambar dalam ImageField objek.
Control	Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek. (Diperoleh dari DataControlField)
ControlStyle	Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek. (Diperoleh dari DataControlField)
ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai string kosong ("") dikonversi ke `null` saat nilai bidang dikembalikan dari sumber data.
DataAlternateTextField	Mendapatkan atau mengatur nama bidang dari sumber data yang berisi nilai untuk diikat ke AlternateText properti setiap gambar dalam ImageField objek.
DataAlternateTextFormatString	Mendapatkan atau mengatur string yang menentukan format di mana teks alternatif untuk setiap gambar dalam ImageField objek dirender.
DataImageUrlField	Mendapatkan atau mengatur nama bidang dari sumber data yang berisi nilai untuk diikat ke ImageUrl properti setiap gambar dalam ImageField objek.
DataImageUrlFormatString	Mendapatkan atau mengatur string yang menentukan format di mana URL untuk setiap gambar dalam objek dirender ImageField .
DesignMode	Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField)
FooterStyle	Mendapatkan atau mengatur gaya footer bidang kontrol data. (Diperoleh dari DataControlField)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data. (Diperoleh dari DataControlField)
HeaderImageUrl	Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderStyle	Mendapatkan atau mengatur gaya header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField)
InsertVisible	Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan. (Diperoleh dari DataControlField)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
ItemStyle	Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data. (Diperoleh dari DataControlField)
NullDisplayText	Mendapatkan atau mengatur teks yang akan ditampilkan dalam ImageField objek saat nilai bidang yang ditentukan oleh DataImageUrlField properti adalah `null`.
NullImageUrl	Mendapatkan atau mengatur URL ke gambar alternatif yang ditampilkan dalam ImageField objek saat nilai bidang yang ditentukan oleh DataImageUrlField properti adalah `null`.
ReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai bidang yang ditentukan oleh DataImageUrlField properti dapat dimodifikasi dalam mode edit.
ShowHeader	Mendapatkan atau mengatur nilai yang menunjukkan apakah item header bidang kontrol data dirender. (Diperoleh dari DataControlField)
SortExpression	Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data. (Diperoleh dari DataControlField)
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien. (Diperoleh dari DataControlField)
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender. (Diperoleh dari DataControlField)

Metode

Nama	Deskripsi
CloneField()	Membuat salinan duplikat dari objek -turunan saat ini DataControlField. (Diperoleh dari DataControlField)
CopyProperties(DataControlField)	Menyalin properti objek saat ini ImageField ke objek yang ditentukan.
CreateField()	Mengembalikan instans ImageField baru kelas.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengisi objek yang ditentukan IOrderedDictionary dengan nilai dari objek yang ditentukan DataControlFieldCell .
FormatImageUrlValue(Object)	Menerapkan format yang ditentukan oleh DataImageUrlFormatString properti ke nilai bidang.
GetDesignTimeValue()	Mengambil nilai yang digunakan untuk nilai bidang saat merender ImageField objek dalam perancang.
GetFormattedAlternateText(Control)	Menerapkan format yang ditentukan oleh DataAlternateTextFormatString properti ke nilai teks alternatif yang terkandung dalam objek yang ditentukan Control .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(Control, String, PropertyDescriptor)	Mengambil nilai bidang yang ditentukan dari kontrol yang ditentukan.
Initialize(Boolean, Control)	Menginisialisasi objek ImageField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menginisialisasi objek yang ditentukan DataControlFieldCell dengan tipe sel, status baris, dan indeks baris yang ditentukan.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Menginisialisasi objek yang ditentukan DataControlFieldCell dengan status baris yang ditentukan.
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari DataControlField)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDataBindField(Object, EventArgs)	Mengikat nilai bidang ke ImageField objek.
OnFieldChanged()	Menaikkan `FieldChanged` acara. (Diperoleh dari DataControlField)
SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
ToString()	Mengembalikan string yang mewakili objek ini DataControlField . (Diperoleh dari DataControlField)
TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
ValidateSupportsCallback()	Menentukan apakah kontrol yang terkandung dalam ImageField panggilan balik dukungan objek.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Mendapatkan atau mengatur skema yang terkait dengan objek ini DataControlField . (Diperoleh dari DataControlField)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan yang disimpan sebelumnya di bidang kontrol data. (Diperoleh dari DataControlField)
IStateManager.SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
IStateManager.TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?