ImageField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

DataControlField
ImageField

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