IParametersInConsumer.ParametersInConsumerInit - Événement

Remarque : cette API est désormais obsolète.

Permet au consommateur WebPart pour passer des informations d'initialisation sur les paramètres attendu pour les autres parties connectées.

Espace de noms :  Microsoft.SharePoint.WebPartPages.Communication
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
<ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartParameters instead")> _
Event ParametersInConsumerInit As ParametersInConsumerInitEventHandler
'Utilisation
Dim instance As IParametersInConsumer
Dim handler As ParametersInConsumerInitEventHandler

AddHandler instance.ParametersInConsumerInit, handler

[ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartParameters instead")]
event ParametersInConsumerInitEventHandler ParametersInConsumerInit

Remarques

Le Gestionnaire d'événements reçoit un argument de type Microsoft.SharePoint.WebPartPages.Communication.ParametersInConsumerInitEventArgs contenant des données liées à cet événement. L'objet ParametersInConsumerInitEventArgs contient un tableau d'objets Microsoft.SharePoint.WebPartPages.Communication.ParameterInProperty avec les propriétés ParameterName, ParameterDisplayName, Requiredet Description.

Exemples

L'exemple de code suivant montre une méthode substituée PartCommunicationInit qui déclenche l'événement ParametersInConsumerInit . Cet exemple de code fait partie d'un exemple plus développé fourni pour l'interface IParametersInConsumer .

' Step #7: Override the PartCommunicationInit method.
' The PartCommunicationInit method is called by the Web Part 
' infrastructure during the ASP.NET PreRender 
' phase to allow the part to pass initialization information to the 
' other connected parts.
' It is important to always pass initialization information. Some 
' parts
' may not behave properly if this initialization information is not 
' received.
Public Overrides Sub PartCommunicationInit()
    ' Ensure all controls have been created.
    EnsureChildControls()

    ' Check if connected.
    If _connected Then
        'Need to create the args for the ParametersInConsumerInit event
        Dim parametersInConsumerInitEventArgs As New ParametersInConsumerInitEventArgs()

        'Set the ParameterInProperties
        parametersInConsumerInitEventArgs.ParameterInProperties = New ParameterInProperty(3) {}

        parametersInConsumerInitEventArgs.ParameterInProperties(0) = New ParameterInProperty()
        parametersInConsumerInitEventArgs.ParameterInProperties(0).Description = _fontFamilyParamDescription
        parametersInConsumerInitEventArgs.ParameterInProperties(0).ParameterDisplayName = _fontFamilyParamDisplayName
        parametersInConsumerInitEventArgs.ParameterInProperties(0).ParameterName = _fontFamilyParamName
        parametersInConsumerInitEventArgs.ParameterInProperties(0).Required = True

        parametersInConsumerInitEventArgs.ParameterInProperties(1) = New ParameterInProperty()
        parametersInConsumerInitEventArgs.ParameterInProperties(1).Description = _fontColorParamDescription
        parametersInConsumerInitEventArgs.ParameterInProperties(1).ParameterDisplayName = _fontColorParamDisplayName
        parametersInConsumerInitEventArgs.ParameterInProperties(1).ParameterName = _fontColorParamName
        parametersInConsumerInitEventArgs.ParameterInProperties(1).Required = False

        parametersInConsumerInitEventArgs.ParameterInProperties(2) = New ParameterInProperty()
        parametersInConsumerInitEventArgs.ParameterInProperties(2).Description = _fontWeightParamDescription
        parametersInConsumerInitEventArgs.ParameterInProperties(2).ParameterDisplayName = _fontWeightParamDisplayName
        parametersInConsumerInitEventArgs.ParameterInProperties(2).ParameterName = _fontWeightParamName
        parametersInConsumerInitEventArgs.ParameterInProperties(2).Required = True

        parametersInConsumerInitEventArgs.ParameterInProperties(3) = New ParameterInProperty()
        parametersInConsumerInitEventArgs.ParameterInProperties(3).Description = _fontSizeParamDescription
        parametersInConsumerInitEventArgs.ParameterInProperties(3).ParameterDisplayName = _fontSizeParamDisplayName
        parametersInConsumerInitEventArgs.ParameterInProperties(3).ParameterName = _fontSizeParamName
        parametersInConsumerInitEventArgs.ParameterInProperties(3).Required = False

        ' Fire the ParametersInConsumerInit event.
        RaiseEvent ParametersInConsumerInit(Me, parametersInConsumerInitEventArgs)
    End If
End Sub

// Step #7: Override the PartCommunicationInit method.
// The PartCommunicationInit method is called by the Web Part 
// infrastructure during the ASP.NET PreRender 
// phase to allow the part to pass initialization information to the 
// other connected parts.
// It is important to always pass initialization information. Some 
// parts
// may not behave properly if this initialization information is not 
// received.
public override void PartCommunicationInit()
{
    // Ensure all controls have been created.
    EnsureChildControls();

    // Check if connected.
    if(_connected)
    {
        // If there is a listener, fire the ParametersInConsumerInit 
        // event.
        if (ParametersInConsumerInit != null)
        {
            // Need to create the ParametersInConsumerInitEventArgs 
            // object for the ParametersInConsumerInit event.
            ParametersInConsumerInitEventArgs parametersInConsumerInitEventArgs = new ParametersInConsumerInitEventArgs();
            
            // Set the ParameterInProperties.
            parametersInConsumerInitEventArgs.ParameterInProperties = new ParameterInProperty[4];

            parametersInConsumerInitEventArgs.ParameterInProperties[0] = new ParameterInProperty();
            parametersInConsumerInitEventArgs.ParameterInProperties[0].Description = _fontFamilyParamDescription;
            parametersInConsumerInitEventArgs.ParameterInProperties[0].ParameterDisplayName = _fontFamilyParamDisplayName;
            parametersInConsumerInitEventArgs.ParameterInProperties[0].ParameterName = _fontFamilyParamName;
            parametersInConsumerInitEventArgs.ParameterInProperties[0].Required = true;

            parametersInConsumerInitEventArgs.ParameterInProperties[1] = new ParameterInProperty();
            parametersInConsumerInitEventArgs.ParameterInProperties[1].Description = _fontColorParamDescription;
            parametersInConsumerInitEventArgs.ParameterInProperties[1].ParameterDisplayName = _fontColorParamDisplayName;
            parametersInConsumerInitEventArgs.ParameterInProperties[1].ParameterName = _fontColorParamName;
            parametersInConsumerInitEventArgs.ParameterInProperties[1].Required = false;

            parametersInConsumerInitEventArgs.ParameterInProperties[2] = new ParameterInProperty();
            parametersInConsumerInitEventArgs.ParameterInProperties[2].Description = _fontWeightParamDescription;
            parametersInConsumerInitEventArgs.ParameterInProperties[2].ParameterDisplayName = _fontWeightParamDisplayName;
            parametersInConsumerInitEventArgs.ParameterInProperties[2].ParameterName = _fontWeightParamName;
            parametersInConsumerInitEventArgs.ParameterInProperties[2].Required = true;

            parametersInConsumerInitEventArgs.ParameterInProperties[3] = new ParameterInProperty();
            parametersInConsumerInitEventArgs.ParameterInProperties[3].Description = _fontSizeParamDescription;
            parametersInConsumerInitEventArgs.ParameterInProperties[3].ParameterDisplayName = _fontSizeParamDisplayName;
            parametersInConsumerInitEventArgs.ParameterInProperties[3].ParameterName = _fontSizeParamName;
            parametersInConsumerInitEventArgs.ParameterInProperties[3].Required = false;

            // Fire the ParametersInConsumerInit event.
            ParametersInConsumerInit(this, parametersInConsumerInitEventArgs);
        }
    }
}

Voir aussi

Référence

IParametersInConsumer interface

IParametersInConsumer - Membres

Microsoft.SharePoint.WebPartPages.Communication - Espace de noms