ImageField Klasse

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 dem datengebundenen Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein ImageField Objekt als Spalte an, während das DetailsView Steuerelement es als Zeile anzeigt.

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. Jedes Bild kann auch alternativen Text zugeordnet haben. Dieser Text wird angezeigt, wenn ein Bild nicht geladen werden kann oder nicht verfügbar ist. Browser, die das QuickInfo-Feature unterstützen, zeigen diesen Text auch als QuickInfo an. Sie können den Alternativtext für ein angezeigtes Bild mithilfe 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 der einzelnen Bilder zu binden. Auf diese Weise können Sie für jedes angezeigte Bild unterschiedliche Alternativtexte verwenden. Beim Binden von Daten können Sie optional den Alternativtext 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. Statt 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. Wenn Sie eine Beschriftung im Kopf- oder Fußzeilenabschnitt anzeigen möchten, legen Sie die Eigenschaften FooterText bzw. eigenschaften HeaderText fest. Wenn Sie ein Bild im Kopfzeilenabschnitt anstelle von Text anzeigen möchten, legen Sie die HeaderImageUrl Eigenschaft fest. Der Kopfzeilenabschnitt kann im ImageField Objekt ausgeblendet werden, indem die ShowHeader Eigenschaft auf false.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView Steuerelement) können nur den gesamten Kopfzeilenabschnitt des Steuerelements ein- oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes datengebundenes Feld nicht. Wenn Sie den gesamten Kopfzeilenabschnitt eines datengebundenen Steuerelements ein- oder ausblenden möchten, 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 Formateigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formateigenschaften aufgeführt.

Style-Eigenschaft	Beschreibung
ControlStyle	Die Formatvorlageneinstellungen für die untergeordneten Webserversteuerelemente des ImageField Objekts.
FooterStyle	Die Formatvorlageneinstellungen für den Fußzeilenabschnitt des ImageField Objekts.
HeaderStyle	Die Formatvorlageneinstellungen für den Kopfzeilenabschnitt des ImageField Objekts.
ItemStyle	Die Formatvorlageneinstellungen für die Datenelemente im ImageField Objekt.

Konstruktoren

Name	Beschreibung
ImageField()	Initialisiert eine neue Instanz der ImageField-Klasse.

Felder

Name	Beschreibung
ThisExpression	Stellt den Ausdruck "this" dar.

Eigenschaften

Name	Beschreibung
AccessibleHeaderText	Dient zum Abrufen oder Festlegen von Text, der `AbbreviatedText` in einigen Steuerelementen als Eigenschaftswert gerendert wird. (Geerbt von DataControlField)
AlternateText	Dient zum Abrufen oder Festlegen des alternativen Texts, der für ein Bild im ImageField Objekt angezeigt wird.
Control	Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField Objekt zugeordnet ist. (Geerbt von DataControlField)
ControlStyle	Ruft den Stil aller Webserversteuerelemente ab, die im DataControlField Objekt enthalten sind. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob leere Zeichenfolgenwerte ("") konvertiert `null` werden, wenn die Feldwerte aus der Datenquelle zurückgegeben werden.
DataAlternateTextField	Dient zum Abrufen oder Festlegen des Namens des Felds aus der Datenquelle, das die Werte enthält, die an die AlternateText Eigenschaft der einzelnen Bilder in einem ImageField Objekt gebunden werden sollen.
DataAlternateTextFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Format angibt, in dem der alternative Text für jedes Bild in einem ImageField Objekt gerendert wird.
DataImageUrlField	Dient zum Abrufen oder Festlegen des Namens des Felds aus der Datenquelle, das die Werte enthält, die an die ImageUrl Eigenschaft der einzelnen Bilder in einem ImageField Objekt gebunden werden sollen.
DataImageUrlFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Format angibt, in dem die URL für jedes Bild in einem ImageField Objekt gerendert wird.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelementfeld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Dient zum Abrufen oder Festlegen der Formatvorlage der Fußzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der URL eines Bilds, das im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderStyle	Dient zum Abrufen oder Festlegen des Stils der Kopfzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
HeaderText	Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt sichtbar ist, wenn sich das übergeordnete datengebundene Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format aller textbasierten Inhalte ab, die von einem Datensteuerelementfeld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Dient zum Abrufen oder Festlegen des Texts, der in einem ImageField Objekt angezeigt werden soll, wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds ist `null`.
NullImageUrl	Dient zum Abrufen oder Festlegen der URL auf ein alternatives Bild, das in einem ImageField Objekt angezeigt wird, wenn der Wert des durch die DataImageUrlField Eigenschaft angegebenen Felds ist `null`.
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Werte des durch die DataImageUrlField Eigenschaft angegebenen Felds im Bearbeitungsmodus geändert werden können.
ShowHeader	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kopfzeilenelement eines Datensteuerelementfelds gerendert wird. (Geerbt von DataControlField)
SortExpression	Dient zum Abrufen oder Festlegen eines Sortierausdrucks, der von einem Datenquellensteuerelement zum Sortieren von Daten verwendet wird. (Geerbt von DataControlField)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die Clienteingabe überprüft. (Geerbt von DataControlField)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datensteuerelementfeld gerendert wird. (Geerbt von DataControlField)

Methoden

Name	Beschreibung
CloneField()	Erstellt eine duplizierte Kopie des aktuellen DataControlFieldabgeleiteten 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 dem aktuellen Objekt entspricht. (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 von der DataImageUrlFormatString Eigenschaft angegebene Format auf einen Feldwert an.
GetDesignTimeValue()	Ruft den Wert ab, der beim Rendern des Objekts in einem Designer für den ImageField Wert eines Felds verwendet wird.
GetFormattedAlternateText(Control)	Wendet das von der DataAlternateTextFormatString Eigenschaft angegebene Format auf den alternativen Textwert an, der im angegebenen Control Objekt enthalten ist.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die 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, Zeilenstatus und Zeilenindex.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialisiert das angegebene DataControlFieldCell Objekt mit dem angegebenen Zeilenstatus.
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField)
MemberwiseClone()	Erstellt eine flache Kopie der 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 am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet 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 am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die in einem ImageField Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das diesem DataControlField Objekt zugeordnete Schema ab oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelementfelds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?