Udostępnij za pośrednictwem


ImageField Klasa

Definicja

Reprezentuje pole, które jest wyświetlane jako obraz w kontrolce powiązanej z danymi.

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
Dziedziczenie

Przykłady

W poniższym przykładzie pokazano, jak używać ImageField obiektu w kontrolce GridView do wyświetlania obrazu.


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

Uwagi

Klasa ImageField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView) do wyświetlania obrazu dla każdego wyświetlanego rekordu. Obiekt ImageField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używana. Na przykład kontrolka GridView wyświetla ImageField obiekt jako kolumnę, a kontrolka DetailsView wyświetla ją jako wiersz.

Aby wyświetlić obrazy, należy powiązać ImageField obiekt z polem ze źródła danych zawierającego adres URL obrazu. Jest to realizowane przez ustawienie DataImageUrlField właściwości. Wartość adresu URL można sformatować przy użyciu DataImageUrlFormatString właściwości . Każdy obraz może również mieć skojarzony alternatywny tekst. Ten tekst jest wyświetlany, gdy nie można załadować obrazu lub jest niedostępny. Przeglądarki, które obsługują funkcję Etykietki narzędzi, również wyświetlają ten tekst jako etykietkę narzędzia. Alternatywny tekst wyświetlanego obrazu można określić przy użyciu jednej z następujących metod:

  • AlternateText Użyj właściwości , aby określić tekst alternatywny, który ma zastosowanie do wszystkich obrazów.

  • DataAlternateTextField Użyj właściwości , aby powiązać pole ze źródła danych z AlternateText właściwością każdego obrazu. Dzięki temu można mieć inny tekst alternatywny dla każdego wyświetlanego obrazu. W przypadku powiązania danych można opcjonalnie sformatować tekst alternatywny przy użyciu DataAlternateTextFormatString właściwości .

Gdy wartość adresu URL obrazu to null, nie można wyświetlić obrazu. Możesz wyświetlić alternatywny obraz dla null wartości pól, ustawiając NullImageUrl właściwość. Zamiast alternatywnego obrazu można wyświetlić tekst alternatywny, ustawiając NullDisplayText właściwość .

Domyślnie wszystkie zadeklarowane pola są wyświetlane w kontrolce powiązanej z danymi. Obiekt można ukryć ImageField w kontrolce powiązanej z danymi, ustawiając Visible właściwość na false.

Możesz dostosować sekcje nagłówka i stopki ImageField obiektu. Aby wyświetlić podpis w sekcji nagłówka lub stopki, ustaw HeaderText odpowiednio właściwości lub FooterText . Aby wyświetlić obraz w sekcji nagłówka zamiast tekstu, ustaw HeaderImageUrl właściwość . Sekcja nagłówka może być ukryta ImageField w obiekcie, ustawiając ShowHeader właściwość na false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą wyświetlać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego z danymi. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi, użyj właściwości kontrolki ShowHeader (jeśli jest dostępna).

Możesz również dostosować wygląd ImageField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.

Właściwość Stylu Opis
ControlStyle Ustawienia stylu podrzędnego serwera sieci Web steruje obiektem ImageField .
FooterStyle Ustawienia stylu sekcji ImageField stopki obiektu.
HeaderStyle Ustawienia stylu sekcji nagłówka ImageField obiektu.
ItemStyle Ustawienia stylu elementów danych w ImageField obiekcie.

Konstruktory

ImageField()

Inicjuje nowe wystąpienie klasy ImageField.

Pola

ThisExpression

Reprezentuje wyrażenie "this".

Właściwości

AccessibleHeaderText

Pobiera lub ustawia tekst renderowany jako AbbreviatedText wartość właściwości w niektórych kontrolkach.

(Odziedziczone po DataControlField)
AlternateText

Pobiera lub ustawia alternatywny tekst wyświetlany dla obrazu w ImageField obiekcie.

Control

Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem.

(Odziedziczone po DataControlField)
ControlStyle

Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie.

(Odziedziczone po DataControlField)
ConvertEmptyStringToNull

Pobiera lub ustawia wartość wskazującą, czy wartości ciągu pustego ("") są konwertowane na null wartość, gdy wartości pól są zwracane ze źródła danych.

DataAlternateTextField

Pobiera lub ustawia nazwę pola ze źródła danych zawierającego wartości powiązane AlternateText z właściwością ImageField każdego obrazu w obiekcie.

DataAlternateTextFormatString

Pobiera lub ustawia ciąg określający format, w którym jest renderowany tekst alternatywny dla każdego obrazu w ImageField obiekcie.

DataImageUrlField

Pobiera lub ustawia nazwę pola ze źródła danych zawierającego wartości powiązane ImageUrl z właściwością ImageField każdego obrazu w obiekcie.

DataImageUrlFormatString

Pobiera lub ustawia ciąg określający format, w którym adres URL dla każdego obrazu w ImageField obiekcie jest renderowany.

DesignMode

Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania.

(Odziedziczone po DataControlField)
FooterStyle

Pobiera lub ustawia styl stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
FooterText

Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderImageUrl

Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderStyle

Pobiera lub ustawia styl nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderText

Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
InsertVisible

Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka powiązana z danymi jest w trybie wstawiania.

(Odziedziczone po DataControlField)
IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
ItemStyle

Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych.

(Odziedziczone po DataControlField)
NullDisplayText

Pobiera lub ustawia tekst wyświetlany w obiekcie, ImageField gdy wartość pola określonego DataImageUrlField przez właściwość to null.

NullImageUrl

Pobiera lub ustawia adres URL na alternatywny obraz wyświetlany w obiekcie, ImageField gdy wartość pola określonego DataImageUrlField przez właściwość to null.

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy wartości pola określone przez DataImageUrlField właściwość można modyfikować w trybie edycji.

ShowHeader

Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany.

(Odziedziczone po DataControlField)
SortExpression

Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych.

(Odziedziczone po DataControlField)
ValidateRequestMode

Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta.

(Odziedziczone po DataControlField)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
Visible

Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane.

(Odziedziczone po DataControlField)

Metody

CloneField()

Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego.

(Odziedziczone po DataControlField)
CopyProperties(DataControlField)

Kopiuje właściwości bieżącego ImageField obiektu do określonego obiektu.

CreateField()

Zwraca nowe wystąpienie ImageField klasy.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Wypełnia określony IOrderedDictionary obiekt wartościami z określonego DataControlFieldCell obiektu.

FormatImageUrlValue(Object)

Stosuje format określony przez DataImageUrlFormatString właściwość do wartości pola.

GetDesignTimeValue()

Pobiera wartość używaną dla wartości pola podczas renderowania ImageField obiektu w projektancie.

GetFormattedAlternateText(Control)

Stosuje format określony przez DataAlternateTextFormatString właściwość do alternatywnej wartości tekstowej zawartej w określonym Control obiekcie.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
GetValue(Control, String, PropertyDescriptor)

Pobiera wartość określonego pola z określonej kontrolki.

Initialize(Boolean, Control)

Inicjuje ImageField obiekt.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicjuje określony DataControlFieldCell obiekt z określonym typem komórki, stanem wiersza i indeksem wiersza.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicjuje określony DataControlFieldCell obiekt o określonym stanie wiersza.

LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku źródła danych.

(Odziedziczone po DataControlField)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnDataBindField(Object, EventArgs)

Wiąże wartość pola z obiektem ImageField .

OnFieldChanged()

FieldChanged Zgłasza zdarzenie.

(Odziedziczone po DataControlField)
SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
ToString()

Zwraca ciąg reprezentujący ten DataControlField obiekt.

(Odziedziczone po DataControlField)
TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
ValidateSupportsCallback()

Określa, czy kontrolki zawarte w ImageField obiekcie obsługują wywołania zwrotne.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem.

(Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku pola kontroli danych.

(Odziedziczone po DataControlField)
IStateManager.SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
IStateManager.TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)

Dotyczy

Zobacz też