WebPartManager.GetProviderConnectionPoints Method
Assembly: System.Web (in system.web.dll)
public: virtual ProviderConnectionPointCollection^ GetProviderConnectionPoints ( WebPart^ webPart )
public ProviderConnectionPointCollection GetProviderConnectionPoints ( WebPart webPart )
public function GetProviderConnectionPoints ( webPart : WebPart ) : ProviderConnectionPointCollection
Parameters
- webPart
A server control that is acting as a provider in a connection.
Return Value
A ProviderConnectionPointCollection that contains all connection points in the provider.A Web Parts connection always involves exactly two controls, one acting as the provider of data, the other acting as the consumer of data. Each control must have one or more methods that are defined as connection points. In the case of a provider control, its connection points are ProviderConnectionPoint objects.
A provider must always have at least one connection point to be able to establish a connection. The GetProviderConnectionPoints method checks a provider control and retrieves a collection of all its connection points. Retrieving the provider connection points is a necessary step in forming a Web Parts connection.
The following code example demonstrates how to use the GetProviderConnectionPoints method.
The example has four parts:
-
A user control that enables you to change display modes on a Web Parts page.
-
A Web page that contains two custom WebPart controls that can be connected, and an <asp:webpartmanager> element.
-
A source code file that contains two custom WebPart controls and a custom interface.
-
An explanation of how the example works in a browser.
The first part of the code example is the user control for changing display modes. You can obtain the source code for the user control from the Example section of the WebPartManager class overview. For more information about display modes and how the user control works, see Walkthrough: Changing Display Modes on a Web Parts Page.
The declarative markup for the Web page contains Register directives for both the user control and the custom controls. There is an <asp:webpartmanager> element, an <asp:webpartzone> element to contain the custom controls, and an <asp:connectionszone> element. Notice that in the Page_Load method, the code checks to see whether a connection already exists and, if not, defines a provider, a consumer, and their respective connection points, and then adds a new connection to the set of static connections referenced by the StaticConnections property. Note that the ProviderConnectionPointCollection object that is retrieved by using the GetProviderConnectionPoints method is then passed to the CanConnectWebParts method to determine whether a connection between the two controls can be created.
The third part of the example is the source code for the controls. You can obtain this code, and instructions for compiling it, from the Example section of the WebPartManager class overview.
After you have loaded the Web page in a browser, click the Display Mode drop-down list control and select Connect to switch the page to connect mode. Connect mode uses the <asp:connectionszone> element to enable you to create connections between controls. In connect mode, click the downward arrow in the title bar of the ZIP Code control to activate its verbs menu, and then click Connect. After the connection user interface (UI) appears, notice that a connection has already been created by the code contained in the Page_Load method. If you return to this page in a later browser session, this static connection will already be established and will not need to be recreated each time the page loads.
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.