ImageField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Feld dar, das als Bild in einem datengebundenen Steuerelement angezeigt wird.

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

Vererbung: Object

DataControlField
ImageField

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein ImageField -Objekt in einem GridView -Steuerelement zum Anzeigen eines Bilds verwendet wird.


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

Hinweise

Die ImageField -Klasse wird von datengebundenen Steuerelementen (z GridView . B. und DetailsView) verwendet, um ein Bild für jeden angezeigten Datensatz anzuzeigen. Das ImageField Objekt wird je nach datengebundenem Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein ImageField Objekt als Spalte an, während es vom DetailsView Steuerelement als Zeile angezeigt wird.

Zum Anzeigen von Bildern müssen Sie ein ImageField Objekt an ein Feld aus einer Datenquelle binden, das die URL eines Bilds enthält. Dies wird durch Festlegen der DataImageUrlField -Eigenschaft erreicht. Der URL-Wert kann mithilfe der DataImageUrlFormatString -Eigenschaft formatiert werden. Jedem Bild kann auch alternativer Text zugeordnet sein. Dieser Text wird angezeigt, wenn ein Bild nicht geladen werden kann oder nicht verfügbar ist. Browser, die die QuickInfos-Funktion unterstützen, zeigen diesen Text auch als QuickInfo an. Sie können den alternativen Text für ein angezeigtes Bild mit einer der folgenden Methoden angeben:

Verwenden Sie die AlternateText -Eigenschaft, um alternativen Text anzugeben, der für alle Bilder gilt.
Verwenden Sie die DataAlternateTextField -Eigenschaft, um ein Feld aus einer Datenquelle an die AlternateText Eigenschaft jedes Bilds zu binden. Dadurch können Sie einen anderen alternativen Text für jedes Bild anzeigen. Beim Binden von Daten können Sie optional den alternativen Text mithilfe der DataAlternateTextFormatString -Eigenschaft formatieren.

Wenn der URL-Wert für ein Bild lautet null, kann kein Bild angezeigt werden. Sie können ein alternatives Bild für null Feldwerte anzeigen, indem Sie die NullImageUrl -Eigenschaft festlegen. Anstelle eines alternativen Bilds können Sie alternativ Text anzeigen, indem Sie die NullDisplayText -Eigenschaft festlegen.

Standardmäßig werden alle deklarierten Felder in einem datengebundenen Steuerelement angezeigt. Sie können ein ImageField Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen.

Sie können die Kopf- und Fußzeilenabschnitte eines ImageField Objekts anpassen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitt anzuzeigen, legen die HeaderText oder FooterText Eigenschaften bzw. Um ein Bild im Headerabschnitt anstelle von Text anzuzeigen, legen Sie die HeaderImageUrl -Eigenschaft fest. Der Headerabschnitt kann im ImageField -Objekt ausgeblendet werden, indem Sie die ShowHeader -Eigenschaft auf falsefestlegen.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView -Steuerelement) können nur den gesamten Headerabschnitt des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes datengebundenes Feld nicht. Um den gesamten Headerabschnitt eines datengebundenen Steuerelements ein- oder auszublenden, verwenden Sie die -Eigenschaft des Steuerelements ShowHeader (sofern verfügbar).

Sie können auch die Darstellung des ImageField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Stileigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.

Style-Eigenschaft	BESCHREIBUNG
ControlStyle	Die Stileinstellungen für die untergeordneten Webserversteuerelemente des ImageField Objekts.
FooterStyle	Die Formateinstellungen für den Fußzeilenabschnitt des ImageField Objekts.
HeaderStyle	Die Formateinstellungen für den Headerabschnitt des ImageField -Objekts.
ItemStyle	Die Stileinstellungen für die Datenelemente im ImageField -Objekt.

Konstruktoren

ImageField()

Initialisiert eine neue Instanz der ImageField-Klasse.

Felder

ThisExpression

Stellt den Ausdruck „this“ dar.

Eigenschaften

AccessibleHeaderText	Ruft Text ab, der in einigen Steuerelementen als `AbbreviatedText`-Eigenschaftswert gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
AlternateText	Ruft den alternativen Text ab, der für ein Bild im ImageField-Objekt angezeigt wird, oder legt diesen Text fest.
Control	Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist. (Geerbt von DataControlField)
ControlStyle	Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Ruft einen Wert ab, der angibt, ob Werte mit einer leeren Zeichenfolge ("") in `null` konvertiert werden, wenn die Feldwerte aus der Datenquelle zurückgegeben werden, oder legt diesen Wert fest.
DataAlternateTextField	Ruft den Namen des Felds aus der Datenquelle ab, das die an die AlternateText-Eigenschaft jedes Bilds in einem ImageField-Objekt zu bindenden Werte enthält, oder legt diesen Namen fest.
DataAlternateTextFormatString	Ruft die Zeichenfolge ab, oder legt die Zeichenfolge fest, die das Format angibt, mit dem der alternative Text für jedes Bild in einem ImageField-Objekt gerendert wird.
DataImageUrlField	Ruft den Namen des Felds aus der Datenquelle ab, das die an die ImageUrl-Eigenschaft jedes Bilds in einem ImageField-Objekt zu bindenden Werte enthält, oder legt diesen Namen fest.
DataImageUrlFormatString	Ruft die Zeichenfolge ab, die das Format angibt, mit dem die URL für jedes Bild in einem ImageField-Objekt gerendert wird, oder legt diese Zeichenfolge fest.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
FooterText	Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField)
HeaderImageUrl	Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest. (Geerbt von DataControlField)
HeaderStyle	Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
HeaderText	Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField)
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Ruft den in einem ImageField-Objekt anzuzeigenden Text ab, wenn der Wert des durch die DataImageUrlField-Eigenschaft angegebenen Felds `null` ist, oder legt diesen Text fest.
NullImageUrl	Ruft die URL für ein alternatives Bild ab, das in einem ImageField-Objekt angezeigt wird, wenn der Wert des durch die DataImageUrlField-Eigenschaft angegebenen Felds `null` ist, oder legt diese URL fest.
ReadOnly	Ruft einen Wert ab, der angibt, ob die Werte des durch die DataImageUrlField-Eigenschaft angegebenen Felds im Bearbeitungsmodus geändert werden können, oder legt diesen Wert fest.
ShowHeader	Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
SortExpression	Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest. (Geerbt von DataControlField)
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft. (Geerbt von DataControlField)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest. (Geerbt von DataControlField)

Methoden

CloneField()	Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts. (Geerbt von DataControlField)
CopyProperties(DataControlField)	Kopiert die Eigenschaften des aktuellen ImageField-Objekts in das angegebene Objekt.
CreateField()	Gibt eine neue Instanz der ImageField-Klasse zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Füllt das angegebene IOrderedDictionary-Objekt mit den Werten aus dem angegebenen DataControlFieldCell-Objekt.
FormatImageUrlValue(Object)	Wendet das durch die DataImageUrlFormatString-Eigenschaft angegebene Format auf einen Feldwert an.
GetDesignTimeValue()	Ruft beim Rendern des ImageField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.
GetFormattedAlternateText(Control)	Wendet das durch die DataAlternateTextFormatString-Eigenschaft angegebene Format auf den Wert des alternativen Texts an, der im angegebenen Control-Objekt enthalten ist.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Control, String, PropertyDescriptor)	Ruft den Wert des angegebenen Felds aus dem angegebenen Steuerelement ab.
Initialize(Boolean, Control)	Initialisiert das ImageField-Objekt.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zelltyp, dem angegebenen Zeilenzustand und dem angegebenen Zeilenindex.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zeilenzustand.
LoadViewState(Object)	Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDataBindField(Object, EventArgs)	Bindet den Wert eines Felds an das ImageField-Objekt.
OnFieldChanged()	Löst das `FieldChanged`-Ereignis aus. (Geerbt von DataControlField)
SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
ToString()	Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt. (Geerbt von DataControlField)
TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die in einem ImageField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)

Gilt für: