ImageField Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

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.

Konstruktorów

Nazwa	Opis
ImageField()	Inicjuje nowe wystąpienie klasy ImageField.

Pola

Nazwa	Opis
ThisExpression	Reprezentuje wyrażenie "this".

Właściwości

Nazwa	Opis
AccessibleHeaderText	Pobiera lub ustawia tekst renderowany jako `AbbreviatedText` wartość właściwości w niektórych kontrolkach. (Dziedziczone od 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. (Dziedziczone od DataControlField)
ControlStyle	Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
FooterStyle	Pobiera lub ustawia styl stopki pola kontrolki danych. (Dziedziczone od DataControlField)
FooterText	Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderStyle	Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Dziedziczone od DataControlField)
HeaderText	Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych. (Dziedziczone od DataControlField)
InsertVisible	Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka powiązana z danymi jest w trybie wstawiania. (Dziedziczone od DataControlField)
IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od DataControlField)
ItemStyle	Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Dziedziczone od 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. (Dziedziczone od DataControlField)
SortExpression	Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych. (Dziedziczone od DataControlField)
ValidateRequestMode	Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta. (Dziedziczone od 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. (Dziedziczone od DataControlField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Dziedziczone od DataControlField)

Metody

Nazwa	Opis
CloneField()	Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Dziedziczone od 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. (Dziedziczone od 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. (Dziedziczone od Object)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od 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. (Dziedziczone od DataControlField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnDataBindField(Object, EventArgs)	Wiąże wartość pola z obiektem ImageField .
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Dziedziczone od DataControlField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Dziedziczone od DataControlField)
ToString()	Zwraca ciąg reprezentujący ten DataControlField obiekt. (Dziedziczone od 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. (Dziedziczone od DataControlField)
ValidateSupportsCallback()	Określa, czy kontrolki zawarte w ImageField obiekcie obsługują wywołania zwrotne.

Implementacje interfejsów jawnych

Nazwa	Opis
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Dziedziczone od DataControlField)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od DataControlField)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku pola kontroli danych. (Dziedziczone od DataControlField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Dziedziczone od 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. (Dziedziczone od DataControlField)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?