del método WebPart.PartCommunicationConnect

NOTA: esta API está ahora obsoleta.

Se usa para notificar a un elemento Web que se ha conectado a otro elemento Web.

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

Sintaxis

'Declaración
<ObsoleteAttribute("Use ConnectionProvider or ConnectionConsumer attribute to create ConnectionPoint instead.")> _
Public Overridable Sub PartCommunicationConnect ( _
    interfaceName As String, _
    connectedPart As WebPart, _
    connectedInterfaceName As String, _
    runAt As ConnectionRunAt _
)
'Uso
Dim instance As WebPart
Dim interfaceName As String
Dim connectedPart As WebPart
Dim connectedInterfaceName As String
Dim runAt As ConnectionRunAt

instance.PartCommunicationConnect(interfaceName, _
    connectedPart, connectedInterfaceName, _
    runAt)

[ObsoleteAttribute("Use ConnectionProvider or ConnectionConsumer attribute to create ConnectionPoint instead.")]
public virtual void PartCommunicationConnect(
    string interfaceName,
    WebPart connectedPart,
    string connectedInterfaceName,
    ConnectionRunAt runAt
)

Parámetros

• interfaceName
  Tipo: System.String

  Especifica el nombre de la interfaz en este elemento Web que se está conectando.

• connectedPart
  Tipo: Microsoft.SharePoint.WebPartPages.WebPart

  WebPart que especifica el otro elemento Web que está conectado.

• connectedInterfaceName
  Tipo: System.String

  Especifica el nombre de la interfaz que se está conectando a en el otro elemento Web.

• runAt
  Tipo: Microsoft.SharePoint.WebPartPages.Communication.ConnectionRunAt

  Un valor deConnectionRunAtque especifica dónde se debe ejecutar la interfaz en este elemento Web.

Comentarios

Un elemento Web que implementa una interfaz de conexión deben reemplazar el método PartCommunicationConnect . Este método es invocado por la infraestructura de elementos Web para notificar al elemento Web que está conectado durante el evento de System.Web.UI.Control.PreRender de Microsoft ASP.NET. Información relevante que se pasa a la que se conectan elementos Web, como la interfaz está conectado a través, el elemento Web se está conectando a y donde el elemento se ejecutará, del cliente o del servidor.

Si el elemento Web que se está conectando a está en otra página, connectedPart es una referencia null (Nothing en Visual Basic).

Ejemplos

En el ejemplo de código siguiente se muestra un método invalidado PartCommunicationConnect . Este ejemplo de código forma parte de un ejemplo más extenso de la interfaz ICellProvider .

Dado que en este ejemplo se usa la clase Microsoft.SharePoint.Utilities.SPEncode , requiere una directiva de using (Imports en Visual Basic) para el espacio de nombres Microsoft.SharePoint.Utilities .

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

Public Overrides Sub PartCommunicationConnect( _
    interfaceName As String, _
    connectedPart As WebPart, _
    connectedInterfaceName As String, _
    runAt As ConnectionRunAt)

   ' Keep track of whether the Web Part is connected.
   If interfaceName = "MyCellProviderInterface_WPQ_" Then
      _connected = True
      _connectedWebPartTitle = SPEncode.HtmlEncode(connectedPart.Title)
    End If
End Sub

// Step #7: Override the PartCommunicationConnect() method.
// The PartCommunicationConnect method is called by the Web Part infrastructure to notify the Web Part that it
// is connected during the ASP.NET PreRender event. Relevant information is passed to the part such as 
// the interface it is connected over, the Web Part it is being conected to, and where the part will be running, 
// either client-side or server-side. 
// <param name="interfaceName">Friendly name of the interface that is being connected</param>
// <param name="connectedPart">Reference to the other Web Part that is being connected to</param>
// <param name="connectedInterfaceName">Friendly name of the interface on the other Web Part</param>
// <param name="runAt">Where the interface should execute</param>
public override void PartCommunicationConnect(
    string interfaceName,
    WebPart connectedPart,
    string connectedInterfaceName,
    ConnectionRunAt runAt)
{
    // Keep track of whether the Web Part is connected.
    if (interfaceName == "MyCellProviderInterface_WPQ_")
    {
        _connected = true;
        _connectedWebPartTitle = SPEncode.HtmlEncode(connectedPart.Title);
    }
}

Vea también

Referencia

clase WebPart

Miembros WebPart

Espacio de nombres Microsoft.SharePoint.WebPartPages