Evento IFilterConsumer.FilterConsumerInit

NOTA: esta API está ahora obsoleta.

El evento de inicialización para recibir la lista de campos y, opcionalmente, nombres para mostrar campo usados para filtrar una lista.

Espacio de nombres:  Microsoft.SharePoint.WebPartPages.Communication
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
<ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartParameters instead")> _
Event FilterConsumerInit As FilterConsumerInitEventHandler
'Uso
Dim instance As IFilterConsumer
Dim handler As FilterConsumerInitEventHandler

AddHandler instance.FilterConsumerInit, handler

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

Ejemplos

En el ejemplo de código siguiente se muestra un métodoreemplazado PartCommunicationInitque se desencadena el evento FilterConsumerInit . Este ejemplo de código forma parte de un ejemplo más extenso de la interfaz IFilterConsumer .

' Step #7: Override 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. Some parts
' may not behave properly if this initialization information is not 
' received.
 Public Overrides Sub PartCommunicationInit()
      ' If the connection wasn't actually formed then we don't want to 
      ' send the Init event.
      If _connected Then
          ' Ensure that all of the Web Part's controls are created.
          ' The _filterFieldNames and _filterFieldDisplayNames are set 
          ' during EnsureChildControls().
          EnsureChildControls()

          ' Create the FilterConsumerInitEventArgs object for the 
          ' FilterConsumerInit event.
          Dim filterConsumerInitArgs As New FilterConsumerInitEventArgs()

          ' Set the field names.
          filterConsumerInitArgs.FieldList = _filterFieldNames
          filterConsumerInitArgs.FieldDisplayList = _filterFieldDisplayNames

          ' Fire the FilterConsumerInit event.
           RaiseEvent FilterConsumerInit(Me, filterConsumerInitArgs)
      End If
End Sub

// Step #7: Override 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. 
// Some parts may not behave properly if this initialization 
// information is not received.

public override void PartCommunicationInit()
{
    // If the connection wasn't actually formed then don't want to send 
    // Init event.
    if(_connected)
    {
        // Ensure that all of the Web Part's controls are created.
        // The _filterFieldNames and _filterFieldDisplayNames are set 
        // during EnsureChildControls()
        EnsureChildControls();

        // If there is a listener, fire the FilterConsumerInit event.
        if (FilterConsumerInit != null)
        {
            // Create the FilterConsumerInitEventArgs object for the 
            // FilterConsumerInit event.
            FilterConsumerInitEventArgs filterConsumerInitArgs = new FilterConsumerInitEventArgs();
            
            // Set the field names.
            filterConsumerInitArgs.FieldList = _filterFieldNames;
            filterConsumerInitArgs.FieldDisplayList = _filterFieldDisplayNames;
            
            // Fire the FilterConsumerInit event.
            FilterConsumerInit(this, filterConsumerInitArgs);
        }
    }
}

Vea también

Referencia

interfaz IFilterConsumer

Miembros IFilterConsumer

Espacio de nombres Microsoft.SharePoint.WebPartPages.Communication