Image.ImageAlign Property (System.Web.UI.WebControls)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

Image.ImageAlign Property

Gets or sets the alignment of the Image control in relation to other elements on the Web page.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic

Public Overridable Property ImageAlign As ImageAlign

public virtual ImageAlign ImageAlign { get; set; }

Visual C++

public:
virtual property ImageAlign ImageAlign {
	ImageAlign get ();
	void set (ImageAlign value);
}

abstract ImageAlign : ImageAlign with get, set
override ImageAlign : ImageAlign with get, set

ASP.NET

<asp:Image ImageAlign="ImageAlign" />

Property Value

Type: System.Web.UI.WebControls.ImageAlign
One of the ImageAlign values. The default is NotSet.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The specified value is not one of the ImageAlign values.

Remarks

Use the ImageAlign property to specify or determine the alignment of the image in relation to other elements on the Web page. The following table lists the possible alignments.

Alignment	Description
NotSet	The alignment is not set.
Left	The image is aligned on the left edge of the Web page with text wrapping on the right.
Right	The image is aligned on the right edge of the Web page with text wrapping on the left.
Baseline	The lower edge of the image is aligned with the lower edge of the first line of text.
Top	The upper edge of the image is aligned with the upper edge of the highest element on the same line.
Middle	The middle of the image is aligned with the lower edge of the first line of text.
Bottom	The lower edge of the image is aligned with the lower edge of the first line of text.
AbsBottom	The lower edge of the image is aligned with the lower edge of the largest element on the same line.
AbsMiddle	The middle of the image is aligned with the middle of the largest element on the same line.
TextTop	The upper edge of the image is aligned with the upper edge of the highest text on the same line.

Examples

The following example demonstrates how to use the ImageAlign property to specify the alignment of the Image control in relation to other elements on the Web page.

Visual Basic


<%@ 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>
    <title>Image Example</title>
</head>

<body>

   <form id="form1" runat="server">

      <h3>Image Example</h3>

      <asp:Image id="Image1" runat="server"
           AlternateText="Image text"
           ImageAlign="left"
           ImageUrl="images/image1.jpg"/>

   </form>

</body>
</html>


<%@ 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>
    <title>Image Example</title>
</head>

<body>

   <form id="form1" runat="server">

      <h3>Image Example</h3>

      <asp:Image id="Image1" runat="server"
           AlternateText="Image text"
           ImageAlign="left"
           ImageUrl="images/image1.jpg"/>

   </form>

</body>
</html>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Image Class

System.Web.UI.WebControls Namespace

ImageAlign

Other Resources

Image Web Server Control Overview