Share via


de la propiedad ListReadyEventArgs.List

NOTA: esta API está ahora obsoleta.

Obtiene o establece la lista proporcionada por un elemento Web que implementa la interfaz de IListProvider cuando se produce el evento deListReady.

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

Sintaxis

'Declaración
<ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartTable instead")> _
Public Property List As DataTable
    Get
    Set
'Uso
Dim instance As ListReadyEventArgs
Dim value As DataTable

value = instance.List

instance.List = value
[ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartTable instead")]
public DataTable List { get; set; }

Valor de propiedad

Tipo: System.Data.DataTable
System.Data.DataTable que contiene la lista de datos proporcionada.

Ejemplos

En el ejemplo de código siguiente se muestra un métodoreemplazado WebPart.PartCommunicationMainque usa la propiedad List para establecer la lista de datos proporcionados por este elemento Web. Este ejemplo de código forma parte de un ejemplo más extenso de la interfaz IListProvider .

' Step #8: Override the PartCommunicationMain method.
' The PartCommunicationMain method is called by the Web Part Infrastructure 
' on the client during the ASP.NET PreRender
' phase to allow the part to pass its primary data to the other 
' connected parts.
' It is important to always fire the ListReady or PartialListReady 
' event. Some parts may not behave properly if they are left waiting 
' for this information.
Public Overrides Sub PartCommunicationMain()

   ' Ensure that all of the Web Part's controls are created.
       EnsureChildControls()
   
   'Check if connected
   If _connected Then
      ' If there is a listener, fire the ListReady event.
      If Not (ListReady Is Nothing) Then
         ' Create the ListReadyEventArgs object for the ListProviderInit event.
         Dim listReadyArgs As New ListReadyEventArgs()
         
         ' If user clicked button, send the value.
         If _listButtonClicked Then
            ' Set the List to the value of the table in the DataGrid.
            ' This is the value that will be sent to the consumer Web 
            ' Part.
            listReadyArgs.List = CType(_dataGrid.DataSource, DataTable)
         Else
            ' The user didn't click the button, so send a
            ' null DataTable to the consumer Web Part.
            listReadyArgs.List = Nothing
         End If
         
         ' Fire the ListReady event.
         ' The consumer Web Part will receive the DataTable.
         
                  ' The consumer Web Part will receive the DataTable.
                   ListReady(Me, listReadyArgs)

      End If
   End If
End Sub 'PartCommunicationMain
// Step #8: Override the PartCommunicationMain method.
// The PartCommunicationMain method is called by the Web Part 
// Infrastructure on the client during the ASP.NET PreRender
// phase to allow the part to pass its primary data to the other 
// connected parts. It is important to always fire the ListReady or 
// PartialListReady event. Some parts may not behave properly if they 
// are left waiting for this information.
public override void PartCommunicationMain()
{
    // Ensure that all of the Web Part's controls are created.
    EnsureChildControls();

    //Check if connected
    if(_connected)
    {
        // If there is a listener, fire the ListReady event.
        if (ListReady != null)
        {
            // Create the ListReadyEventArgs object for the 
            // ListProviderInit event.
            ListReadyEventArgs listReadyArgs = new ListReadyEventArgs();

            // If user clicked button, send the value.
            if (_listButtonClicked)
            {
                // Set the List to the value of the table in the 
                // DataGrid. This is the value that will be sent to the 
                // consumer Web Part.
                listReadyArgs.List = ((DataTable)_dataGrid.DataSource);
            }
            else
            {
                // The user didn't click the button, so send a
                // null DataTable to the consumer Web Part.
                listReadyArgs.List = null;
            }

            // Fire the ListReady event.
            // The consumer Web Part will receive the DataTable.
            ListReady(this, listReadyArgs);
        }
    }
}

Vea también

Referencia

clase ListReadyEventArgs

Miembros ListReadyEventArgs

Espacio de nombres Microsoft.SharePoint.WebPartPages.Communication