WebPart.CanRunAt method

NOTE: This API is now obsolete.

Returns a value that indicates where the implementation of a connection interface can run.

Namespace:  Microsoft.SharePoint.WebPartPages
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

<ObsoleteAttribute("Use ConnectionProvider or ConnectionConsumer attribute to create ConnectionPoint instead.")> _
Public Overridable Function CanRunAt As ConnectionRunAt
Dim instance As WebPart
Dim returnValue As ConnectionRunAt

returnValue = instance.CanRunAt()

When developing a connectable Web Part, you must override the CanRunAt method to return the appropriate value for the implementation of a connection interface. The CanRunAt method should return a ConnectionRunAt enumeration that indicates whether implementation for the connection interface can run on the server, the client, both, or not at all (ConnectionRunAt.None). The default behavior of this method is to throw an exception that returns Strings.CommunicationMethodNotImplementedError. This method is called before the inherited System.Web.UI.Control class's PreRender event and after the Load event.

The following code example shows how to override the CanRunAt method to indicate that the connection interface can run only on the server.

To see this method in a fuller context, see Walkthrough: Creating Connectable SharePoint Web Parts

Public Overrides Function CanRunAt() As ConnectionRunAt
   ' This Web Part can run on the server.
   Return ConnectionRunAt.Server
End Function