Sdílet prostřednictvím


ImageField Třída

Definice

Představuje pole, které se zobrazí jako obrázek v ovládacím prvku vázaném na 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
Dědičnost

Příklady

Následující příklad ukazuje, jak použít ImageField objekt v ovládacím GridView prvku k zobrazení obrázku.


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

Poznámky

Třídu ImageField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení obrázku pro každý zobrazený záznam. Objekt ImageField se zobrazí odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. GridView Například ovládací prvek zobrazí ImageField objekt jako sloupec, zatímco DetailsView ovládací prvek ho zobrazí jako řádek.

Pokud chcete zobrazit obrázky, musíte vytvořit vazbu objektu ImageField na pole ze zdroje dat, který obsahuje adresu URL obrázku. Toho dosáhnete nastavením DataImageUrlField vlastnosti. Hodnotu adresy URL lze naformátovat pomocí DataImageUrlFormatString vlastnosti . Ke každému obrázku může být přidružený také alternativní text. Tento text se zobrazí, když obrázek nelze načíst nebo je nedostupný. Prohlížeče, které podporují funkci Popisy tlačítek, také zobrazují tento text jako popis. Alternativní text zobrazeného obrázku můžete zadat pomocí jedné z následujících metod:

  • AlternateText Pomocí vlastnosti určete alternativní text, který platí pro všechny obrázky.

  • Vlastnost slouží DataAlternateTextField k vytvoření vazby pole ze zdroje dat na AlternateText vlastnost každého obrázku. To vám umožní mít pro každý zobrazený obrázek jiný alternativní text. Při vytváření vazby dat můžete volitelně formátovat alternativní text pomocí DataAlternateTextFormatString vlastnosti .

Pokud je nullhodnota adresy URL obrázku , obrázek nelze zobrazit. Alternativní obrázek pro null hodnoty polí můžete zobrazit nastavením NullImageUrl vlastnosti. Místo alternativního obrázku můžete zobrazit alternativní text nastavením NullDisplayText vlastnosti.

Ve výchozím nastavení se všechna deklarovaná pole zobrazují v ovládacím prvku vázaném na data. Objekt v ovládacím prvku vázaném ImageField na data můžete skrýt nastavením Visible vlastnosti na falsehodnotu .

Oddíly záhlaví a zápatí objektu ImageField můžete přizpůsobit. Pokud chcete zobrazit titulek v oddílu záhlaví nebo zápatí, nastavte HeaderText vlastnosti nebo FooterText . Pokud chcete místo textu zobrazit obrázek v oddílu záhlaví, nastavte HeaderImageUrl vlastnost . Oddíl záhlaví může být v objektu ImageField skrytý nastavením ShowHeader vlastnosti na false.

Poznámka

Některé ovládací prvky vázané na data (například GridView ovládací prvek) můžou zobrazit nebo skrýt pouze celou část záhlaví ovládacího prvku. Tyto ovládací prvky vázané na ShowHeader data nepodporují vlastnost pro jednotlivá pole vázané na data. Pokud chcete zobrazit nebo skrýt celou část záhlaví ovládacího prvku vázaného na data, použijte vlastnost ovládacího prvku ShowHeader (pokud je k dispozici).

Můžete také přizpůsobit vzhled objektu ImageField (barvu písma, barvu pozadí atd.) nastavením vlastností stylu pro různé části pole. V následující tabulce jsou uvedeny různé vlastnosti stylu.

Vlastnost Style Description
ControlStyle Nastavení stylu podřízeného webového serveru ovládací prvky objektu ImageField .
FooterStyle Nastavení stylu pro část zápatí objektu ImageField .
HeaderStyle Nastavení stylu pro oddíl záhlaví objektu ImageField .
ItemStyle Nastavení stylu pro datové položky v objektu ImageField .

Konstruktory

ImageField()

Inicializuje novou instanci ImageField třídy.

Pole

ThisExpression

Představuje výraz "this".

Vlastnosti

AccessibleHeaderText

Získá nebo nastaví text, který je vykreslen jako AbbreviatedText hodnota vlastnosti v některých ovládacích prvcích.

(Zděděno od DataControlField)
AlternateText

Získá nebo nastaví alternativní text zobrazený pro obrázek v objektu ImageField .

Control

Získá odkaz na ovládací prvek dat, který DataControlField je přidružen objektu.

(Zděděno od DataControlField)
ControlStyle

Získá styl všech ovládacích prvků webového serveru obsažených v objektu DataControlField .

(Zděděno od DataControlField)
ConvertEmptyStringToNull

Získá nebo nastaví hodnotu určující, zda prázdné řetězcové ("") hodnoty jsou převedeny na null , když pole hodnoty jsou vráceny ze zdroje dat.

DataAlternateTextField

Získá nebo nastaví název pole ze zdroje dat, který obsahuje hodnoty pro vazbu na AlternateText vlastnost každého obrázku v objektu ImageField .

DataAlternateTextFormatString

Získá nebo nastaví řetězec, který určuje formát, ve kterém alternativní text pro každý obrázek v objektu ImageField je vykreslena.

DataImageUrlField

Získá nebo nastaví název pole ze zdroje dat, který obsahuje hodnoty pro vazbu na ImageUrl vlastnost každého obrázku v objektu ImageField .

DataImageUrlFormatString

Získá nebo nastaví řetězec, který určuje formát, ve kterém je vykreslena adresa URL pro každý obrázek v objektu ImageField .

DesignMode

Získá hodnotu označující, zda je pole ovládacích prvků dat aktuálně zobrazen v prostředí návrhu.

(Zděděno od DataControlField)
FooterStyle

Získá nebo nastaví styl zápatí pole ovládacího prvku dat.

(Zděděno od DataControlField)
FooterText

Získá nebo nastaví text, který je zobrazen v zápatí pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderImageUrl

Získá nebo nastaví adresu URL obrázku, který je zobrazen v položce záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderStyle

Získá nebo nastaví styl záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderText

Získá nebo nastaví text zobrazený v položce záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
InsertVisible

Získá hodnotu označující, zda DataControlField objekt je viditelný, když jeho nadřazený ovládací prvek vázané na data je v režimu vložení.

(Zděděno od DataControlField)
IsTrackingViewState

Získá hodnotu označující, zda DataControlField objekt ukládá změny do svého stavu zobrazení.

(Zděděno od DataControlField)
ItemStyle

Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat.

(Zděděno od DataControlField)
NullDisplayText

Získá nebo nastaví text, který se má zobrazit v objektu ImageField , když hodnota pole určená DataImageUrlField vlastností je null.

NullImageUrl

Získá nebo nastaví adresu URL na alternativní obrázek zobrazený v objektu ImageField , když hodnota pole určená DataImageUrlField vlastností je null.

ReadOnly

Získá nebo nastaví hodnotu určující, zda hodnoty pole zadané DataImageUrlField vlastností lze upravit v režimu úprav.

ShowHeader

Získá nebo nastaví hodnotu určující, zda položka záhlaví pole ovládacího prvku dat je vykreslena.

(Zděděno od DataControlField)
SortExpression

Získá nebo nastaví výraz řazení, který se používá ovládací prvek zdroje dat k řazení dat.

(Zděděno od DataControlField)
ValidateRequestMode

Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta.

(Zděděno od DataControlField)
ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč několika požadavky na stejnou stránku.

(Zděděno od DataControlField)
Visible

Získá nebo nastaví hodnotu označující, zda je vykreslena pole ovládacího prvku dat.

(Zděděno od DataControlField)

Metody

CloneField()

Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu.

(Zděděno od DataControlField)
CopyProperties(DataControlField)

Zkopíruje vlastnosti aktuálního ImageField objektu do zadaného objektu.

CreateField()

Vrátí novou instanci ImageField třídy.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Vyplní zadaný IOrderedDictionary objekt hodnotami ze zadaného DataControlFieldCell objektu.

FormatImageUrlValue(Object)

Použije formát určený DataImageUrlFormatString vlastností na hodnotu pole.

GetDesignTimeValue()

Načte hodnotu použitou pro hodnotu pole při vykreslování objektu ImageField v návrháři.

GetFormattedAlternateText(Control)

Použije formát určený DataAlternateTextFormatString vlastností na alternativní text hodnotu obsaženou v zadaném Control objektu.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
GetValue(Control, String, PropertyDescriptor)

Načte hodnotu zadaného pole ze zadaného ovládacího prvku.

Initialize(Boolean, Control)

Inicializuje ImageField objekt.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicializuje zadaný DataControlFieldCell objekt pomocí zadaného typu buňky, stavu řádku a indexu řádku.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicializuje zadaný DataControlFieldCell objekt se zadaným stavem řádku.

LoadViewState(Object)

Obnoví dříve uložený stav zobrazení zdroje dat.

(Zděděno od DataControlField)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
OnDataBindField(Object, EventArgs)

Sváže hodnotu pole s objektem ImageField .

OnFieldChanged()

FieldChanged Vyvolá událost.

(Zděděno od DataControlField)
SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od okamžiku, kdy byla stránka publikována zpět na server.

(Zděděno od DataControlField)
ToString()

Vrátí řetězec, který představuje tento DataControlField objekt.

(Zděděno od DataControlField)
TrackViewState()

Způsobí, že DataControlField objekt sleduje změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataControlField)
ValidateSupportsCallback()

Určuje, zda ovládací prvky obsažené v objektu ImageField podporují zpětné volání.

Explicitní implementace rozhraní

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu.

(Zděděno od DataControlField)
IStateManager.IsTrackingViewState

Získá hodnotu označující, zda DataControlField objekt ukládá změny do svého stavu zobrazení.

(Zděděno od DataControlField)
IStateManager.LoadViewState(Object)

Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat.

(Zděděno od DataControlField)
IStateManager.SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od okamžiku, kdy byla stránka publikována zpět na server.

(Zděděno od DataControlField)
IStateManager.TrackViewState()

Způsobí, že DataControlField objekt sleduje změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataControlField)

Platí pro

Viz také