Share via


WebPart Class

The WebPart class provides the base class for creating Web Parts. All custom Web Parts must derive from this class. To learn the basic steps for creating a Web Part, see the Creating a Basic Web Part programming task.

System.Object

   System.Web.UI.Control

      Microsoft.SharePoint.WebPartPages.WebPart

Protected Constructors

The following table shows the constructors of the WebPart class and a brief description of each.

Name Description
WebPart Initializes a new instance of the WebPart class.

Public Methods

The following table shows the public methods of the WebPart class and a brief description of each.

Name Description
AfterDeserialize The virtual function that is called after a Web Part's properties are deserialized from the SharePoint database or from a Web Part description file (.dwp). Suggested place for Web Part upgrade code.
CanRunAt Returns a ConnectionRunAt enumeration that indicates the appropriate value for where the implementation for connection interface can run.
CreateWebPartMenu The virtual function for creating the Web Part menu when a developer wants to modify or override the default menu.
Dispose Releases all resources used by the Web Part.
EnsureInterfaces Provides notification for a connectable Web Part that it should ensure all its interfaces are registered using the RegisterInterface method.
GetData The virtual method that is called by the Web Part infrastructure when the System.Web.UI.Control.PreRender event occurs to allow a Web Part to retrieve data.
GetDesignTimeFooter Returns the static HTML for the footer portion of a Web Part frame to a custom designer created by deriving from System.Web.UI.ControlDesigner.
GetDesignTimeHeader Returns static HTML for the header portion of a Web Part frame to a custom designer created by deriving from System.Web.UI.ControlDesigner.
GetInitEventArgs(String) Returns the Microsoft.SharePoint.WebPartPages.Communication.InitEventArgs object for the name of the interface that is passed in.
GetRequiresData The virtual method that is called by the Web Part infrastructure when the System.Web.UI.Control.PreRender event occurs to indicate that a Web Part requires data.
GetToolParts Determines which tool parts are displayed in the tool pane of the Web-based Web Part design user interface, and the order in which they are displayed.
LoadResource(String) Returns a string that describes the localized Name, Category, and Description property values of the specified resource.
PartCommunicationConnect(String, Microsoft.SharePoint.WebPartPages.WebPart, String, Microsoft.SharePoint.WebPartPages.Communication.ConnectionRunAt) Provides a connectable Web Part with the ability to notify other Web Parts that it has a connected interface, where that interface should run, and what that interface is connected to.
PartCommunicationInit Provides a connectable Web Part with the ability to run event handlers for any Microsoft.SharePoint.WebPartPages.Communcation "Init" events, such as the CellProviderInit or CellConsumerInit events.
PartCommunicationMain Provides a connectable Web Part with a method to run event handlers for any additional events of a connectable Web Part.
PartCacheInvalidate Marks all the contents of the Web Part cache as outdated.
ShouldSerializeAllowMinimize Returns whether the AllowMimimize property has changed from its default value.
ShouldSerializeAllowRemove Returns whether the AllowRemove property has changed from its default value.
ShouldSerializeAllowZoneChange Returns whether the AllowZoneChange property has changed from its default value.
ShouldSerializeConnectionID Returns whether the ConnectionID property has changed from its default value.
ShouldSerializeConnections Returns whether the Connections property has changed from its default value.
ShouldSerializeDescription Returns whether the Description property has changed from its default value.
ShouldSerializeDetailLink Returns whether the DetailLink property has changed from its default value.
ShouldSerializeDir Returns whether the Dir property has changed from its default value.
ShouldSerializeExportControlledProperties Returns whether the ExportControlledProperties property has changed from its default value.
ShouldSerializeFrameState Returns whether the FrameState property has changed from its default value.
ShouldSerializeFrameType Returns whether the FrameType property has changed from its default value.
ShouldSerializeHeight Returns whether the Height property has changed from its default value.
ShouldSerializeHelpLink Returns whether the HelpLink property has changed from its default value.
ShouldSerializeIsIncluded Returns whether the IsIncluded property has changed from its default value.
ShouldSerializeIsIncludedFilter Returns whether the IsIncludedFilter property has changed from its default value.
ShouldSerializeIsVisible Returns whether the IsVisible property has changed from its default value.
ShouldSerializeMissingAssembly Returns whether the MissingAssembly property has changed from its default value.
ShouldSerializePartImageLarge Returns whether the PartImageLarge property has changed from its default value.
ShouldSerializePartImageSmall Returns whether the PartImageSmall property has changed from its default value.
ShouldSerializePartOrder Returns whether the PartOrder property has changed from its default value.
ShouldSerializeTitle Returns whether the Title property has changed from its default value.
ShouldSerializeWidth Returns whether the Width property has changed from its default value.
ShouldSerializeZoneID Returns whether the ZoneID property has changed from its default value.

Protected Methods

The following table shows the protected methods of the WebPart class and a brief description of each.

Name Description
AddParsedSubObject(object) Overrides System.Web.UI.Control.AddParsedSubObject.
Finalize The protected implemenation of the System.Object.Finalize method.
GetCustomBuilder(String) Provides the ability to associate a dynamic builder with a custom property of a Web Part.
NotifyWorkItemComplete(System.IAsyncResult) Indicates that work being performed on an external asynchronous thread that has been registered using the RegisterWorkItem method has completed.
OnDataBinding(System.EventArgs) Provides an event handler for the System.Web.UI.Control.DataBinding event that occurs when a Web Part is binding to a data source.
OnInit(System.EventArgs) Provides an event handler for the System.Web.UI.Control.Init event that occurs as the Web Part is being instantiated.
OnLoad(System.EventArgs) Provides an event handler for the System.Web.UI.Control.Load event indicating that a Web Part is being loaded into the Web Part Page.
OnPreRender(System.EventArgs) Provides an event handler for the System.Web.UI.Control.PreRender event that occurs immediately before the Web Part is rendered to its containing Web Part Page.
OnUnload(System.EventArgs) Provides an event handler for the System.Web.UI.Control.Unload event, which occurs when the Web Part is being unloaded from memory.
PartCacheInvalidate(Microsoft.SharePoint.WebPartPages.Storage) Marks all contents of the specified storage type in the Web Part cache as outdated.
PartCacheInvalidate(Microsoft.SharePoint.WebPartPages.Storage, String) Marks the specified cache entries of the specified storage type in the Web Part cache as outdated.
PartCacheRead(Microsoft.SharePoint.WebPartPages.Storage, String) Reads and returns a value from the specified location in the specified type of storage in the Web Part cache.
PartCacheWrite(Microsoft.SharePoint.WebPartPages.Storage, String, object, System.TimeSpan) Stores the specified value of the specified type of storage in the Web Part cache.
RegisterInterface(String, String, Int32, Microsoft.SharePoint.WebPartPages.Communication.ConnectionRunAt, object, String, String, String) Registers an interface from the Microsoft.SharePoint.WebPartPages.Communication Namespace for a connectable Web Part.
RegisterInterface(String, String, Int32, Microsoft.SharePoint.WebPartPages.Communication.ConnectionRunAt, object, String, String, String, Boolean) Registers an interface from the Microsoft.SharePoint.WebPartPages.Communication Namespace for a connectable Web Part.
RegisterWorkItem(System.IAsyncResult) Keeps track of work being done by an external thread, such as a Web Part that handles its own thread pool.
RegisterWorkItemCallback(System.Threading.WaitCallback, object) Queues a Web Part work item to the thread pool, invokes the specified delegate, and specifies an object to be passed to the delegate when serviced from the thread pool.
ReplaceTokens(String) Performs token replacement for a string, using the same algorithm used for URL-valued properties.
Render(System.Web.UI.HtmlTextWriter) Inherited from System.Web.UI.Control . This method is overridable, but when creating a Web Part you should override the RenderWebPart method instead.
RenderWebPart(System.Web.UI.HtmlTextWriter) The virtual method called by the Web Part infrastructure to render the HTML for the body of a Web Part to the client.
RenderWorkItemTimeout(System.Web.UI.HtmlTextWriter) Renders HTML in a Web Part when a work item has timed out.

Public Properties

The following table shows the public properties of the WebPart class, the data type of each property, and a brief description of each.

Name Data Type Description
AllowMinimize Boolean Gets or sets whether the Web Part can be minimized.
AllowRemove Boolean Gets or sets whether the Web Part can be removed from a Web Part Page by controlling whether the IsIncluded property can be set to false
AllowZoneChange Boolean Gets or sets whether the Web Part can be moved to a different zone by controlling whether the ZoneID property can be changed.
BrowserDesignMode Boolean Gets whether a Web Part is in the Web Part Page design mode (changing layout or modifying its properties) in the Web browser.
Caption String Specifies a string that is added following the Title property in the title bar of the Web Part.
ClientName String Gets the unique name of the Web Part used by the client-side Web Parts Page Service Component (WPSC).
ConnectionID System.Guid Gets or sets the Guid that is used internally by the Web Part infrastructure as the unique identifier of a Web Part connection.
Connections String Gets or sets the connection information that is stored with a connected Web Part.
Description String Get or sets a text description that appears when a user rests the mouse pointer on the title of a Web Part in a Web Part Page or in a Web Part library.
DetailLink String Gets or sets a URL to an HTML document that contains supplemental information.
Dir Direction Gets or sets the language direction for a Web Part's text and frame.
EffectiveFrameType FrameType Gets the frame type that is used to render the Web Part frame at run time.
EffectiveStorage Storage Gets whether the instance of the Web Part returned is stored as personal instance or shared instance.
EffectiveTitle String Gets the title of the specified Web Part instance, including any disambiguation information added by the Web Part infrastructure.
ExportControlledProperties Boolean Gets or sets whether a Web Part's properties that are flagged as controlled properties by the Web Part developer can have their values exported in Personal View.
FrameState FrameState Gets or sets the initial state of the Web Part frame, which can be normal (expanded) or minimized.
FrameType FrameType Gets or sets the style of the Web Part frame.
Height String Gets or sets the fixed height for a Web Part on a Web Part Page.
HelpLink String Gets or sets a URL or file system path to a help file in HTML format.
ID String Gets or sets the GUID for the Web Part.
IsIncluded Boolean Gets or sets whether a Web Part, added by another user or the administrator, should be included in a personal view of a Web Part Page.
IsIncludedFilter String Gets or sets the parameters used by the IRuntimeFilter interface to determine if the Web Part will be included on the Web Part page.
IsVisible Boolean Gets or sets whether the part is visible.
MissingAssembly String Gets or sets the message displayed to the user when importing a Web Part, if the assembly for the Web Part is not installed on the target server.
PartImageLarge String Gets or sets the URL of an image file containing a 32 x 32 pixel image, typically used to depict icons.
PartImageSmall String Gets or sets the URL of an image file containing a 16 x 16 pixel image, typically used to depict icons.
PartOrder Int32 Gets or sets the order in which the Web Part appears within a WebPartZone control.
Permissions Permissions Gets which properties of a Web Part can be currently modified.
Qualifier String Gets a unique identifier for a Web Part.
StorageKey System.Guid Gets the unique identifier set by the Web Part infrastructure when a Web Part is added to a zone.
Title String Gets or sets the title that appears in the title bar of a Web Part.
UseDefaultStyles Boolean Gets or sets whether the default font size and style are applied to the Web Part.
UnknownXmlElements UnknownXmlElementCollection Gets an UnknownXmlElementCollection object that contains XML elements from an imported Web Part that were not mapped to a property on the Web Part.
Width String Gets or sets the fixed width for a Web Part.
ZoneID String Gets or sets in which WebPartZone control a Web Part will be rendered.

Protected Properties

The following table shows the protected properties of the WebPart class, the data type of each property, and a brief description of each.

Name Data type Description
CacheType CacheType Gets the type of caching being used by the Web server.
ClassResourcePath String Gets the base path to Web Part class resources.
ContainerWidth String Gets the WebPartZone.ContainerWidth value set by the page author as a hint to the Web Part of how wide to expect the containing Web Part zone to be.
OverflowAuto Boolean Gets whether to override the default setting for the cascading style sheet (CSS) overflow attribute in the Web Part's rendering.
SaveProperties Boolean Gets or sets whether a Web Part's properties have changed and should be persisted at the end of page rendering.
SerializeAll Boolean Gets whether a retrieved property value should be serialized for use in the client-side WPSC property collection.
ShouldValidate Boolean Gets whether the Web Part infrastructure should perform data validation of Web Part properties before setting them.
WebPartMenu Menu Gets or sets the Web Part menu source that is rendered in the frame of the Web Part.
WorkItemTimeout Boolean Gets whether a work item, such as a data request started with RegisterWorkItemCallback Method has timed out and must be ended.

Thread Safety

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

Example

The following code example shows a simple Web Part that contains HtmlButton and HtmlInputText controls that allow the user to change the Web Part's Title property. For a step-by-step walkthrough of creating this Web Part, see the Creating a Basic Web Part programming task.

Requirements

Namespace: Microsoft.SharePoint.WebPartPages

Platforms: Microsoft Windows Server 2003

Assembly: Windows SharePoint Services (in Microsoft.SharePoint.dll)

Security: Code Access Security