Image-Klasse
Zeigt ein Bild auf einer Webseite an.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class Image
Inherits WebControl
'Usage
Dim instance As Image
public class Image : WebControl
public ref class Image : public WebControl
public class Image extends WebControl
public class Image extends WebControl
Hinweise
Verwenden Sie das Image-Steuerelement, um ein Bild auf einer Webseite anzuzeigen. Der Pfad des angezeigten Bilds wird durch Festlegen der ImageUrl-Eigenschaft angegeben. Der Text, der an Stelle des Bilds angezeigt werden soll, wenn dieses nicht verfügbar ist, wird durch Festlegen der AlternateText-Eigenschaft angegeben. Die Ausrichtung des Bilds im Verhältnis zu anderen Elementen auf der Webseite wird durch Festlegen der ImageAlign-Eigenschaft angegeben.
Hinweis
Dieses Steuerelement zeigt nur ein Bild an. Wenn das Aufzeichnen von Mausklicks auf das Bild erforderlich ist, verwenden Sie hierfür das ImageButton-Steuerelement.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Im folgenden Beispiel wird das Erstellen eines Image-Steuerelements auf einer Webseite veranschaulicht.
Hinweis
Im folgenden Codebeispiel wird das Einfachdatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen über das Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.
<%@ Page Language="VB" %>
<html>
<head>
<script language="VB" runat="server">
Sub Button_Click(sender As Object, e As EventArgs)
Select Case DropList1.SelectedIndex
Case 0:
Image1.ImageAlign = ImageAlign.NotSet
Case 1:
Image1.ImageAlign = ImageAlign.Left
Case 2:
Image1.ImageAlign = ImageAlign.Right
Case 3:
Image1.ImageAlign = ImageAlign.Baseline
Case 4:
Image1.ImageAlign = ImageAlign.Top
Case 5:
Image1.ImageAlign = ImageAlign.Middle
Case 6:
Image1.ImageAlign = ImageAlign.Bottom
Case 7:
Image1.ImageAlign = ImageAlign.AbsBottom
Case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle
Case 9:
Image1.ImageAlign = ImageAlign.TextTop
Case Else:
Image1.ImageAlign = ImageAlign.NotSet
End Select
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>Image Example</h3>
<font size="5">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</font>
<asp:Image id="Image1" runat="server"
AlternateText="Image Text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr>
Select Image Align: <br>
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br><br>
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<html>
<head>
<script language="C#" runat="server">
void Button_Click(Object sender, EventArgs e)
{
switch(DropList1.SelectedIndex)
{
case 0:
Image1.ImageAlign = ImageAlign.NotSet;
break;
case 1:
Image1.ImageAlign = ImageAlign.Left;
break;
case 2:
Image1.ImageAlign = ImageAlign.Right;
break;
case 3:
Image1.ImageAlign = ImageAlign.Baseline;
break;
case 4:
Image1.ImageAlign = ImageAlign.Top;
break;
case 5:
Image1.ImageAlign = ImageAlign.Middle;
break;
case 6:
Image1.ImageAlign = ImageAlign.Bottom;
break;
case 7:
Image1.ImageAlign = ImageAlign.AbsBottom;
break;
case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle;
break;
case 9:
Image1.ImageAlign = ImageAlign.TextTop;
break;
default:
Image1.ImageAlign = ImageAlign.NotSet;
break;
}
}
</script>
</head>
<body>
<form runat="server">
<h3>Image Example</h3>
<font size="5">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</font>
<asp:Image id="Image1" runat="server"
AlternateText="Image Text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr>
Select Image Align: <br>
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br><br>
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JSCRIPT" %>
<html>
<head>
<script language="JSCRIPT" runat="server">
function Button_Click(sender : Object, e : EventArgs){
switch(DropList1.SelectedIndex){
case 0:
Image1.ImageAlign = ImageAlign.NotSet
break
case 1:
Image1.ImageAlign = ImageAlign.Left
break
case 2:
Image1.ImageAlign = ImageAlign.Right
break
case 3:
Image1.ImageAlign = ImageAlign.Baseline
break
case 4:
Image1.ImageAlign = ImageAlign.Top
break
case 5:
Image1.ImageAlign = ImageAlign.Middle
break
case 6:
Image1.ImageAlign = ImageAlign.Bottom
break
case 7:
Image1.ImageAlign = ImageAlign.AbsBottom
break
case 8:
Image1.ImageAlign = ImageAlign.AbsMiddle
break
case 9:
Image1.ImageAlign = ImageAlign.TextTop
break
default:
Image1.ImageAlign = ImageAlign.NotSet
break
}
}
</script>
</head>
<body>
<form runat="server">
<h3>Image Example</h3>
<font size="5">
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
Text Text Text Text Text Text Text Text Text Text Text Text
</font>
<asp:Image id="Image1" runat="server"
AlternateText="Image Text"
ImageAlign="left"
ImageUrl="images/image1.jpg"/>
<hr>
Select Image Align: <br>
<asp:DropDownList id="DropList1"
runat="server">
<asp:ListItem>NotSet</asp:ListItem>
<asp:ListItem>Left</asp:ListItem>
<asp:ListItem>Right</asp:ListItem>
<asp:ListItem>BaseLine</asp:ListItem>
<asp:ListItem>Top</asp:ListItem>
<asp:ListItem>Middle</asp:ListItem>
<asp:ListItem>Bottom</asp:ListItem>
<asp:ListItem>AbsBottom</asp:ListItem>
<asp:ListItem>AbsMiddle</asp:ListItem>
<asp:ListItem>TextTop</asp:ListItem>
</asp:DropDownList>
<br><br>
<asp:Button id="Button1"
Text="Apply Image Alignment"
OnClick="Button_Click"
runat="server"/>
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand. Berechtigungswert: Minimal.
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand. Berechtigungswert: Minimal.
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Image
System.Web.UI.WebControls.ImageButton
System.Web.UI.WebControls.ImageMap
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Image-Member
System.Web.UI.WebControls-Namespace
ImageUrl
AlternateText
ImageAlign
Weitere Ressourcen
Image-Webserver-Steuerelement
Sichern von Standardsteuerelementen