Style Class

.NET Framework (current version)

Represents the style of a Web server control.

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

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Web.UI.WebControls.Style
System.Web.UI.Design.DesignerAutoFormatStyle
System.Web.UI.WebControls.MenuItemStyle
System.Web.UI.WebControls.PanelStyle
System.Web.UI.WebControls.SubMenuStyle
System.Web.UI.WebControls.TableItemStyle
System.Web.UI.WebControls.TableSectionStyle
System.Web.UI.WebControls.TableStyle
System.Web.UI.WebControls.TreeNodeStyle

Syntax

C++

type Style = 
    class
        inherit Component
        interface IStateManager
    end

Constructors

	Name	Description
	Style()	Initializes a new instance of the Style class using default values.
	Style(StateBag)	Initializes a new instance of the Style class with the specified state bag information.

Properties

	Name	Description
	BackColor	Gets or sets the background color of the Web server control.
	BorderColor	Gets or sets the border color of the Web server control.
	BorderStyle	Gets or sets the border style of the Web server control.
	BorderWidth	Gets or sets the border width of the Web server control.
	CanRaiseEvents	Gets a value indicating whether the component can raise an event.(Inherited from Component.)
	Container	Gets the IContainer that contains the Component.(Inherited from Component.)
	CssClass	Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client.
	DesignMode	Gets a value that indicates whether the Component is currently in design mode.(Inherited from Component.)
	Events	Gets the list of event handlers that are attached to this Component.(Inherited from Component.)
	Font	Gets the font properties associated with the Web server control.
	ForeColor	Gets or sets the foreground color (typically the color of the text) of the Web server control.
	Height	Gets or sets the height of the Web server control.
	IsEmpty	This API supports the product infrastructure and is not intended to be used directly from your code. A protected property. Gets a value indicating whether any style elements have been defined in the state bag.
	IsTrackingViewState	Returns a value indicating whether any style elements have been defined in the state bag.
	RegisteredCssClass	Gets the cascading style sheet (CSS) class that is registered with the control.
	Site	Gets or sets the ISite of the Component.(Inherited from Component.)
	ViewState	This API supports the product infrastructure and is not intended to be used directly from your code. Gets the state bag that holds the style elements.
	Width	Gets or sets the width of the Web server control.

Methods

	Name	Description
	AddAttributesToRender(HtmlTextWriter)	Adds HTML attributes and styles that need to be rendered to the specified System.Web.UI.HtmlTextWriter. This method is primarily used by control developers.
	AddAttributesToRender(HtmlTextWriter, WebControl)	Adds HTML attributes and styles that need to be rendered to the specified System.Web.UI.HtmlTextWriter and Web server control. This method is primarily used by control developers.
	CopyFrom(Style)	Duplicates the style properties of the specified Style into the instance of the Style class that this method is called from.
	CreateObjRef(Type)	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.(Inherited from MarshalByRefObject.)
	Dispose()	Releases all resources used by the Component.(Inherited from Component.)
	Dispose(Boolean)	Releases the unmanaged resources used by the Component and optionally releases the managed resources.(Inherited from Component.)
	Equals(Object)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	Adds the specified object's style properties to a System.Web.UI.CssStyleCollection object.
	Finalize()	Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection.(Inherited from Component.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetLifetimeService()	Retrieves the current lifetime service object that controls the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
	GetService(Type)	Returns an object that represents a service provided by the Component or by its Container.(Inherited from Component.)
	GetStyleAttributes(IUrlResolutionService)	Retrieves the System.Web.UI.CssStyleCollection object for the specified System.Web.UI.IUrlResolutionService-implemented object.
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	InitializeLifetimeService()	Obtains a lifetime service object to control the lifetime policy for this instance.(Inherited from MarshalByRefObject.)
	LoadViewState(Object)	Loads the previously saved state.
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object.(Inherited from MarshalByRefObject.)
	MergeWith(Style)	Combines the style properties of the specified Style with the instance of the Style class that this method is called from.
	Reset()	Removes any defined style elements from the state bag.
	SaveViewState()	A protected method. Saves any state that has been modified after the TrackViewState method was invoked.
	SetBit(Int32)	This API supports the product infrastructure and is not intended to be used directly from your code. A protected internal method. Sets an internal bitmask field that indicates the style properties that are stored in the state bag.
	SetDirty()	Marks the Style so that its state will be recorded in view state.
	ToString()	Returns a String containing the name of the Component, if any. This method should not be overridden.(Inherited from Component.)
	TrackViewState()	A protected method. Marks the beginning for tracking state changes on the control. Any changes made after tracking has begun will be tracked and saved as part of the control view state.

Events

	Name	Description
	Disposed	Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)

Explicit Interface Implementations

	Name	Description
	IStateManager.LoadViewState(Object)	This API supports the product infrastructure and is not intended to be used directly from your code. Loads the previously saved state.
	IStateManager.SaveViewState()	This API supports the product infrastructure and is not intended to be used directly from your code. Returns the object containing state changes.
	IStateManager.TrackViewState()	This API supports the product infrastructure and is not intended to be used directly from your code. Starts tracking state changes.
	IStateManager.IsTrackingViewState	Gets a value that indicates whether a server control is tracking its view state changes.

The Style class encapsulates the properties that control the appearance of a Web server control and can be applied to multiple Web server controls to provide a common appearance. You can specify the background color and font color of a control by setting the BackColor and ForeColor properties, respectively. On controls that can display a border, you can control the border width, the border style, and the border color by setting the BorderWidth, BorderStyle, and BorderColor properties. The size of a Web server control can also be specified by using the Height and Width properties.

Examples

This example demonstrates how to use a Style object to change the style properties of multiple controls at once. Each time one of the Style property values changes, each control must call its ApplyStyle method. Note that not all the controls included support all the properties demonstrated. If a control does not support a particular property, the appearance of the control will not change when the property value is changed.

Note
The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 1.1

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.