ImageField Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

DataControlField
ImageField

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