Build Your Own ASP.NET 3.5 Website Using C# & VB (113 page)

Image

Properties

AlternateText

specifies the text to display within browsers that do not

support images

Licensed to [email protected]

Appendix A: Web Control Reference

667

ImageAlign

specifies one of ten possible values for image alignment;

possible values include AbsBottom, AbsMiddle, Baseline,

Bottom, Left, Middle, NotSet, Right, TextTop, and Top

ImageURL

specifies the location of the image to use

Visible

controls the visibility of the image

ImageButton

Properties

AlternateText

specifies the text to display within browsers that do not

support images

CommandName

passes a value to the Command event when the ImageButton

is clicked

CommandArgument

passes a value to the Command event when the ImageButton

is clicked

CausesValidation

allows interaction with client-side validation controls;

when False, validation does not occur

ImageAlign

specifies one of ten possible values for image alignment;

possible values include AbsBottom, AbsMiddle, Baseline,

Bottom, Left, Middle, NotSet, Right, TextTop, and Top

ImageURL

specifies the location of the image to use

Visible

controls the visibility of the ImageButton

Events

Click

raised when the ImageButton is clicked and the form is

submitted to the server for processing

Command

raised when the ImageButton is clicked and the form is

submitted to the server for processing; values of the

CommandName and CommandArgument properties are

provided with the event

Licensed to [email protected]

668

Build Your Own ASP.NET 3.5 Web Site Using C# & VB

ImageMap

Properties

Enabled

enables or disables the control

HotSpotMode

defines the behavior when a hot spot is clicked; possible

values are Inactive, Navigate, NotSet, and PostBack

HotSpots

the HotSpotCollection object containing the ImageMap’s

hot spots; hot spots are defined using three other controls,

which generate hot spots of different shapes:

CircleHotSpot, RectangleHotSpot, and PolygonHotSpot

Target

specifies the target window or frame where new content

should be displayed when a link is clicked; possible values are _blank, _parent, _search, _self, and _top
Events

Click

raised when a HotSpot object in the ImageMap is clicked

and the form is submitted to the server for processing

Label

Properties

AssociatedControlID

specifies the ID of the server control with which the Label

is associated and, if set, causes the control to be rendered

as an HTML label element

Text

specifies the text displayed by the Label

Visible

controls the visibility of the Label

LinkButton

Properties

Text

specifies the text displayed by the LinkButton

Licensed to [email protected]

Appendix A: Web Control Reference

669

CommandName

passes a value to the Command event when the LinkButton

is clicked

CommandArgument

passes a value to the Command event when the LinkButton

is clicked

CausesValidation

allows interaction with client-side validation controls;

when False, validation does not occur

Visible

controls the visibility of the LinkButton

Events

Click

raised when the LinkButton is clicked and the form is

submitted to the server for processing

Command

raised when the LinkButton is clicked and the form is

submitted to the server for processing; values of the

CommandName and CommandArgument properties are passed

ListBox

Properties

AutoPostBack

when True, automatically posts the form containing the

ListBox whenever an item is selected

DataMember

specifies the particular table within the data source to

which to bind

DataSource

represents the actual data source to use when binding

DataTextField

represents the field within the data source to use with the

ListBox’s text label

DataTextFormatString

specifies a format string that determines how the ListBox

is displayed

DataValueField

represents the field within the data source to use with the

ListBox’s value

Licensed to [email protected]

670

Build Your Own ASP.NET 3.5 Web Site Using C# & VB

Items

the collection of items within the ListBox

Rows

indicates the number of rows to display within the

ListBox; default value is 4

SelectedIndex

represents the index selected within the ListBox

SelectedItem

represents the item selected within the ListBox

SelectionMode

determines whether or not a user can select more than

one item at a time; possible values are Multiple and

Single

Events

SelectedIndexChanged

raised when an item within the ListBox is selected

Literal

Properties

Text

specifies the text displayed by the control

MultiView

Properties

ActiveViewIndex

specifies the index of the active view

Views

represents the ViewCollection object representing the

collection of views

Methods

GetActiveView

returns the active view as a View object

SetActiveView

sets the active view to the View received as parameter

Events

ActiveViewChanged

fires when the active view of the MultiView changes

Licensed to [email protected]

Appendix A: Web Control Reference

671

Panel

Properties

BackImageURL

the URL of the background image to use within the Panel

DefaultButton

specifies the ID of a button contained within the Panel

that is the default button that’s clicked should the user

press the
Enter
key while the Panel has focus

HorizontalAlign

sets the horizontal alignment of the Panel; possible values

are Center, Justify, Left, NotSet, and Right

Wrap

wraps the contents within the Panel when True; default

value is True

Visible

controls the visibility of the Panel

PlaceHolder

Properties

Visible

controls the visibility of the PlaceHolder

RadioButton

Properties

AutoPostBack

automatically posts the form containing the RadioButton

whenever checked or unchecked is True

Checked

shows the RadioButton as checked if set to True

GroupName

determines the name of the group to which the

RadioButton belongs

Text

specifies the text displayed next to the RadioButton

TextAlign

determines how the text associated with the RadioButton

is aligned; possible values are Left and Right

Licensed to [email protected]

672

Build Your Own ASP.NET 3.5 Web Site Using C# & VB

Events

CheckedChanged

raised when the RadioButton is checked or unchecked

RadioButtonList

Properties

AutoPostBack

automatically posts the form containing the

RadioButtonList whenever checked or unchecked is

True

DataMember

represents the particular table within the data source

DataSource

represents the actual data source to use when binding to

a RadioButtonList

DataTextField

represents the field within the data source to use with the

RadioButtonList’s text label

DataTextFormatString

specifies a format string that determines how the

RadioButtonList is displayed

DataValueField

represents the field within the data source to use with the

RadioButtonList’s value

RepeatColumns

the collection of items within the RadioButtonList

Items

determines the number of columns to use when displaying

the radio buttons

RepeatDirection

indicates the direction in which the radio buttons should

repeat; possible values are Horizontal and Vertical

RepeatLayout

determines how the radio buttons should repeat; possible

values are Horizontal and Vertical

SelectedIndex

represents the index selected within the RadioButtonList

SelectedItem

represents the item selected within the RadioButtonList

Licensed to [email protected]

Appendix A: Web Control Reference

673

SelectedItem

represents the item selected within the RadioButtonList

TextAlign

determines how the text associated with the

RadioButtonList is aligned; possible values are Left and

Right

Events

SelectedIndexChanged

raised when a radio button within the RadioButtonList

is selected

TextBox

Properties

AutoPostBack

automatically posts the form containing the TextBox

whenever a change is made to the contents of the TextBox

Columns

sets the horizontal size of the TextBox in characters

MaxLength

sets the maximum number of characters that may be

entered

Rows

sets the vertical size of the multiline TextBox

Text

specifies the text displayed by the TextBox

TextMode

determines whether the TextBox should render as

SingleLine, Password, or MultiLine

Visible

controls the visibility of the TextBox

Wrap

determines how a multiline TextBox wraps; if set to True,

word wrapping is enabled

Events

TextChanged

raised when the contents of the TextBox have changed

Licensed to [email protected]

674

Build Your Own ASP.NET 3.5 Web Site Using C# & VB

Wizard

Properties

ActiveStep

represents the step that is currently displayed to the user

ActiveStepIndex

specifies the index of the current step

CancelButtonImageUrl

specifies the URL of the image displayed for the
Cancel
button

CancelButtonStyle

represents the style properties of the
Cancel
button

CancelButtonText

specifies the text for the
Cancel
button

CancelButtonType

specifies the type of button that’s displayed as the
Cancel
button; possible values

are Button, Image, or Link

CancelDestinationPageUrl

specifies the URL that the user is directed to when he or she clicks the
Cancel

button

CellPadding

specifies the amount of cell padding

CellSpacing

specifies the amount of cell spacing

DisplayCancelButton

enables or disables the display of a
Cancel
button

DisplaySideBar

enables or disables the display of the sidebar area

FinishCompleteButtonImageUrl

specifies the URL of the image displayed for the
Finish
button

Licensed to [email protected]

Appendix A: Web Control Reference

675

FinishCompleteButtonStyle

represents the style properties of the
Finish
button

FinishCompleteButtonText

specifies the text for the
Finish
button

FinishCompleteButtonType

specifies the type of button that’s displayed as the
Finish
button; possible values

are Button, Image, or Link

FinishDestinationPageUrl

specifies the URL that the user is directed to when he or she clicks the
Finish

button

FinishNavigationTemplate

specifies the template used to display the navigation area on the
Finish
step

FinishPreviousButtonImageUrl

specifies the URL of the image displayed for the
Previous
button on the
Finish

step

FinishPreviousButtonStyle

represents the style properties of the
Previous
button on the
Finish
step

FinishPreviousButtonText

specifies the text for the
Previous
button on the
Finish
step

FinishPreviousButtonType

specifies the type of button that’s displayed as the
Previous
button on the
Finish