ImageField Sınıf

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Veriye bağlı denetimde görüntü olarak görüntülenen bir alanı temsil eder.

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

Devralma: Object

DataControlField
ImageField

Örnekler

Aşağıdaki örnekte, bir ImageField görüntüyü görüntülemek için denetimdeki bir GridView nesnenin nasıl kullanılacağı gösterilmektedir.


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

Açıklamalar

sınıfı ImageField , görüntülenen her kaydın görüntüsünü görüntülemek için veriye bağlı denetimler (ve gibi GridView DetailsView) tarafından kullanılır. ImageField Nesne, kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir ImageField nesneyi sütun olarak görüntülerken DetailsView , denetim bunu satır olarak görüntüler.

Görüntüleri görüntülemek için, bir ImageField nesneyi görüntünün URL'sini içeren bir veri kaynağından bir alana bağlamanız gerekir. Bu, özelliği ayarlanarak DataImageUrlField gerçekleştirilir. URL değeri özelliği kullanılarak DataImageUrlFormatString biçimlendirilebilir. Her resimle ilişkilendirilmiş alternatif metinler de olabilir. Bu metin, bir görüntü yüklenemediğinde veya kullanılamadığında görüntülenir. Araç İpuçları özelliğini destekleyen tarayıcılar da bu metni Araç İpucu olarak görüntüler. Aşağıdaki yöntemlerden birini kullanarak görüntülenen görüntü için alternatif metni belirtebilirsiniz:

AlternateText Özelliğini kullanarak tüm görüntüler için geçerli olan alternatif metinleri belirtin.
Veri kaynağındaki DataAlternateTextField bir alanı her görüntünün özelliğine AlternateText bağlamak için özelliğini kullanın. Bu, görüntülenen her resim için farklı alternatif metinlere sahip olmanıza olanak tanır. Verileri bağlarken, isteğe bağlı olarak özelliğini kullanarak DataAlternateTextFormatString alternatif metni biçimlendirebilirsiniz.

Bir görüntünün URL değeri olduğunda null, görüntü görüntülenemez. özelliğini ayarlayarak NullImageUrl alan değerleri için null alternatif bir görüntü görüntüleyebilirsiniz. Alternatif resim yerine, özelliğini ayarlayarak NullDisplayText alternatif metin görüntüleyebilirsiniz.

Varsayılan olarak, bildirilen tüm alanlar veriye bağlı denetimde görüntülenir. özelliğini falseolarak ayarlayarak veriye bağlı denetimdeki Visible bir ImageField nesneyi gizleyebilirsiniz.

Bir nesnenin üst bilgi ve alt bilgi bölümlerini ImageField özelleştirebilirsiniz. Üst bilgi veya alt bilgi bölümünde resim yazısı görüntülemek için sırasıyla veya FooterText özelliklerini ayarlayınHeaderText. Metin yerine üst bilgi bölümünde görüntü görüntülemek için özelliğini ayarlayın HeaderImageUrl . Üst bilgi bölümü, özelliği falseolarak ayarlanarak nesnede ImageField gizlenebilirShowHeader.

Uyarı

Bazı verilere bağlı denetimler (denetim gibi) denetimin GridView yalnızca üst bilgi bölümünün tamamını gösterebilir veya gizleyebilir. Bu veriye bağlı denetimler, tek bir veriye bağlı alanın özelliğini desteklemez ShowHeader . Veriye bağlı denetimin üst bilgi bölümünün tamamını göstermek veya gizlemek için denetimin ShowHeader özelliğini kullanın (varsa).

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin ImageField görünümünü özelleştirebilirsiniz (yazı tipi rengi, arka plan rengi vb.). Aşağıdaki tabloda farklı stil özellikleri listeılmıştır.

Style özelliği	Açıklama
ControlStyle	Nesnenin alt Web sunucusu denetimleri ImageField için stil ayarları.
FooterStyle	Nesnenin alt bilgi bölümünün ImageField stil ayarları.
HeaderStyle	Nesnenin üst bilgi bölümünün ImageField stil ayarları.
ItemStyle	Nesnedeki veri öğelerinin ImageField stil ayarları.

Oluşturucular

Name	Description
ImageField()	ImageField sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
ThisExpression	"This" ifadesini temsil eder.

Özellikler

Name	Description
AccessibleHeaderText	Bazı denetimlerde özellik değeri olarak `AbbreviatedText` işlenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
AlternateText	Nesnedeki bir resim ImageField için görüntülenen alternatif metni alır veya ayarlar.
Control	Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır. (Devralındığı yer: DataControlField)
ControlStyle	Nesnenin DataControlField içerdiği tüm Web sunucusu denetimlerinin stilini alır. (Devralındığı yer: DataControlField)
ConvertEmptyStringToNull	Alan değerleri veri kaynağından döndürüldüğünde boş dize ("") değerlerinin dönüştürülerek dönüştürülmeyeceğini `null` belirten bir değer alır veya ayarlar.
DataAlternateTextField	Bir nesnedeki her görüntünün ImageField özelliğine bağlanacak AlternateText değerleri içeren veri kaynağından alanın adını alır veya ayarlar.
DataAlternateTextFormatString	Nesnedeki ImageField her görüntü için alternatif metnin işlendiği biçimi belirten dizeyi alır veya ayarlar.
DataImageUrlField	Bir nesnedeki her görüntünün ImageField özelliğine bağlanacak ImageUrl değerleri içeren veri kaynağından alanın adını alır veya ayarlar.
DataImageUrlFormatString	Bir ImageField nesnedeki her görüntünün URL'sinin işlendiği biçimi belirten dizeyi alır veya ayarlar.
DesignMode	Bir veri denetimi alanının şu anda tasarım zamanı ortamında görüntülenip görüntülenmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
FooterStyle	Veri denetimi alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
FooterText	Veri denetimi alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderImageUrl	Veri denetimi alanının üst bilgi öğesinde görüntülenen görüntünün URL'sini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderStyle	Veri denetimi alanının üst bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderText	Veri denetimi alanının üst bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
InsertVisible	Üst veri bağlı denetimi ekleme modundayken nesnenin DataControlField görünür olup olmadığını gösteren bir değer alır. (Devralındığı yer: DataControlField)
IsTrackingViewState	Nesnenin DataControlField değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
ItemStyle	Veri denetimi alanı tarafından görüntülenen metin tabanlı içeriğin stilini alır. (Devralındığı yer: DataControlField)
NullDisplayText	Özelliği `null`tarafından DataImageUrlField belirtilen alanın değeri olduğunda nesnede ImageField görüntülenecek metni alır veya ayarlar.
NullImageUrl	özelliği `null`tarafından belirtilen alanın değeri olduğunda nesnede görüntülenen alternatif bir ImageField görüntünün URL'sini DataImageUrlField alır veya ayarlar.
ReadOnly	Özelliği tarafından DataImageUrlField belirtilen alanın değerlerinin düzenleme modunda değiştirilip değiştirilemeyeceğini belirten bir değer alır veya ayarlar.
ShowHeader	Veri denetim alanının üst bilgi öğesinin işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
SortExpression	Verileri sıralamak için bir veri kaynağı denetimi tarafından kullanılan bir sıralama ifadesi alır veya ayarlar. (Devralındığı yer: DataControlField)
ValidateRequestMode	Denetimin istemci girişini doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
ViewState	Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum DataControlField bilgileri sözlüğü alır. (Devralındığı yer: DataControlField)
Visible	Veri denetimi alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)

Yöntemler

Name	Description
CloneField()	Geçerli DataControlFieldtüretilmiş nesnenin yinelenen bir kopyasını oluşturur. (Devralındığı yer: DataControlField)
CopyProperties(DataControlField)	Geçerli ImageField nesnenin özelliklerini belirtilen nesneye kopyalar.
CreateField()	Sınıfının yeni bir örneğini ImageField döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Belirtilen nesneyi belirtilen IOrderedDictionary nesnedeki DataControlFieldCell değerlerle doldurur.
FormatImageUrlValue(Object)	özelliği tarafından DataImageUrlFormatString belirtilen biçimi bir alan değerine uygular.
GetDesignTimeValue()	Nesne tasarımcıda işlenirken ImageField alanın değeri için kullanılan değeri alır.
GetFormattedAlternateText(Control)	özelliği tarafından DataAlternateTextFormatString belirtilen biçimi, belirtilen Control nesnede bulunan alternatif metin değerine uygular.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetValue(Control, String, PropertyDescriptor)	Belirtilen alanın değerini belirtilen denetimden alır.
Initialize(Boolean, Control)	Nesnesini başlatır ImageField .
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Belirtilen nesneyi belirtilen DataControlFieldCell hücre türü, satır durumu ve satır diziniyle başlatır.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Belirtilen nesneyi belirtilen DataControlFieldCell satır durumuyla başlatır.
LoadViewState(Object)	Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDataBindField(Object, EventArgs)	Bir alanın değerini nesnesine ImageField bağlar.
OnFieldChanged()	Olayı tetikler `FieldChanged` . (Devralındığı yer: DataControlField)
SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
ToString()	Bu DataControlField nesneyi temsil eden bir dize döndürür. (Devralındığı yer: DataControlField)
TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)
ValidateSupportsCallback()	Bir ImageField nesnedeki denetimlerin geri çağırmaları destekleyip desteklemediğini belirler.

Belirtik Arabirim Kullanımları

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar. (Devralındığı yer: DataControlField)
IStateManager.IsTrackingViewState	Nesnenin DataControlField değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
IStateManager.LoadViewState(Object)	Veri denetimi alanının daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
IStateManager.SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
IStateManager.TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?