Share via


WebPart.PartCommunicationInit Method

NOTE: This API is now obsolete.

Provides a connectable Web Part with a method for firing any of its initialization events, such as the CellProviderInit or CellConsumerInit event.

Namespace:  Microsoft.SharePoint.WebPartPages
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No

Syntax

'Declaration
<ObsoleteAttribute("Use ConnectionProvider or ConnectionConsumer attribute to create ConnectionPoint instead.")> _
Public Overridable Sub PartCommunicationInit
'Usage
Dim instance As WebPart

instance.PartCommunicationInit()
[ObsoleteAttribute("Use ConnectionProvider or ConnectionConsumer attribute to create ConnectionPoint instead.")]
public virtual void PartCommunicationInit()

Examples

The following code example shows an overridden PartCommunicationInit method that fires the CellProviderInit event. This code example is part of a larger example provided for the ICellProvider interface.

For an overview of the steps for creating a connectable Web Part, see Walkthrough: Creating Connectable Web Parts in SharePoint Foundation.

' Step #9: Override the PartCommunicationInit() method
' PartCommunicationInit() is called by the Web Part infrastructure during the ASP.NET PreRender 
' event to allow the part to pass initialization information to the other connected parts.
' It is important to always pass initialization information as some parts
' may not behave properly if this initialization information is not received.
Public Overrides Sub PartCommunicationInit()
   ' Check if connected
   If _connected Then                                
      ' Create the InitEventArgs structure for the CellProviderInit event.
      Dim cellProviderInitArgs As New CellProviderInitEventArgs()

      ' Set the FieldName and FieldDisplay values.
       cellProviderInitArgs.FieldName = _cellName
       cellProviderInitArgs.FieldDisplayName = _cellDisplayName

      ' Fire the CellProviderInit event. 
      RaiseEvent CellProviderInit(Me, cellProviderInitArgs)

    End If
End Sub
// Step #9: Override the PartCommunicationInit() method
// PartCommunicationInit() is called by the Web Part infrastructure during the ASP.NET PreRender 
// event to allow the part to pass initialization information to the other connected parts.
// It is important to always pass initialization information as some parts
// may not behave properly if this initialization information is not received.
public override void PartCommunicationInit()
{
    // Check if connected
    if(_connected)
    {
        // If there is a listener, fire the CellProviderInit event.
        if (CellProviderInit != null)
        {
            // Create the CellProviderInitEventArgs structure for the CellProviderInit event.
            CellProviderInitEventArgs cellProviderInitArgs = new CellProviderInitEventArgs();

            // Set the FieldName and FieldDisplay values.
            cellProviderInitArgs.FieldName = _cellName;
            cellProviderInitArgs.FieldDisplayName = _cellDisplayName;

            // Fire the CellProviderInit event.
            CellProviderInit(this, cellProviderInitArgs);
        }
    }
}

See Also

Reference

WebPart Class

WebPart Members

Microsoft.SharePoint.WebPartPages Namespace