ImageField Třída

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 použití ImageField objektu 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 zobrazuje 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.

Chcete-li zobrazit obrázky, musíte svázat ImageField objekt s polem ze zdroje dat, který obsahuje adresu URL obrázku. Toho lze dosáhnout nastavením DataImageUrlField vlastnosti. Hodnotu adresy URL lze naformátovat pomocí DataImageUrlFormatString vlastnosti. Každý obrázek může mít také přidružený alternativní text. Tento text se zobrazí, když obrázek nelze načíst nebo není k dispozici. Prohlížeče, které podporují funkci Popisy tlačítek, zobrazí tento text také jako popis. Alternativní text zobrazeného obrázku můžete zadat jedním z následujících způsobů:

AlternateText Pomocí vlastnosti můžete zadat alternativní text, který platí pro všechny obrázky.
Vlastnost slouží k vytvoření vazby DataAlternateTextField pole ze zdroje dat na vlastnost každého obrázku AlternateText . 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ě naformátovat alternativní text pomocí DataAlternateTextFormatString vlastnosti.

Pokud je nullhodnota adresy URL obrázku , nelze obrázek zobrazit. Alternativní obrázek hodnot null polí můžete zobrazit nastavením NullImageUrl vlastnosti. Místo alternativního obrázku můžete alternativní text zobrazit 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 ImageField prvku vázaném 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. Chcete-li zobrazit titulek v oddílu záhlaví nebo zápatí, nastavte HeaderText příslušné FooterText vlastnosti. 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 celý oddíl 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 celý oddíl záhlaví ovládacího prvku vázaného na data, použijte vlastnost ovládacího prvku ShowHeader (pokud je k dispozici).

Vzhled objektu ImageField (barva písma, barva pozadí atd.) můžete také přizpůsobit nastavením vlastností stylu pro různé části pole. Následující tabulka uvádí různé vlastnosti stylu.

Vlastnost Style	Description
ControlStyle	Nastavení stylu podřízených ovládacích prvků webového serveru objektu ImageField .
FooterStyle	Nastavení stylu pro oddíl zápatí objektu ImageField .
HeaderStyle	Nastavení stylu pro oddíl záhlaví objektu ImageField .
ItemStyle	Nastavení stylu datových položek v objektu ImageField .

Konstruktory

Name	Description
ImageField()	Inicializuje novou instanci ImageField třídy.

Pole

Name	Description
ThisExpression	Představuje výraz "this".

Vlastnosti

Name	Description
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, ke kterému DataControlField je objekt přidružen. (Zděděno od DataControlField)
ControlStyle	Získá styl všech ovládacích prvků webového serveru obsažené objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu označující, zda jsou hodnoty prázdného řetězce ("") převedeny na `null` při vrácení hodnot polí ze zdroje dat.
DataAlternateTextField	Získá nebo nastaví název pole ze zdroje dat, který obsahuje hodnoty pro vytvoření vazby 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 je vykreslen alternativní text pro každý obrázek v objektu ImageField .
DataImageUrlField	Získá nebo nastaví název pole ze zdroje dat, který obsahuje hodnoty pro vytvoření vazby 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 adresa URL pro každý obrázek v objektu ImageField vykreslena.
DesignMode	Získá hodnotu označující, zda pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (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í položky pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderImageUrl	Získá nebo nastaví adresu URL obrázku, který se zobrazí 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, který je zobrazen v záhlaví položky pole ovládacího prvku dat. (Zděděno od DataControlField)
InsertVisible	Získá hodnotu určující, zda DataControlField objekt je viditelný, když nadřazený ovládací prvek vázané na data je v režimu vložení. (Zděděno od DataControlField)
IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho 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 určené DataImageUrlField vlastností lze upravit v režimu úprav.
ShowHeader	Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který 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říč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
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čuje, zda je zadaný objekt roven 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í ImageField objektu 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í funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (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 se zadaným typem buňky, stavem řádku a indexem řá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 Object. (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Vytvoří vazbu hodnoty pole na ImageField objekt.
OnFieldChanged()	`FieldChanged` Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslá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 bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků 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í

Name	Description
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 určující, zda DataControlField objekt ukládá změny do jeho 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 doby, kdy byla stránka odeslána zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?