Compartir a través de


de la propiedad WebPart.Connections

Obtiene o establece la información de conexión que se almacena con un elemento Web conectado.

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

Sintaxis

'Declaración
<WebPartStorageAttribute(Storage := Storage.Shared)> _
<BrowsableAttribute(False)> _
Public Property Connections As String
    Get
    Set
'Uso
Dim instance As WebPart
Dim value As String

value = instance.Connections

instance.Connections = value
[WebPartStorageAttribute(Storage = Storage.Shared)]
[BrowsableAttribute(false)]
public string Connections { get; set; }

Valor de propiedad

Tipo: System.String
Un valor de string que especifica la información de conexión. El valor predeterminado es String.Empty para un elemento Web sin relación entre sí.

Comentarios

La cadena que especifica la propiedad Connections tiene el siguiente formato para cada conexión que se almacenan con un elemento Web.

ConsumerPartID,ProviderPartID,ConsumerInterfaceName,ProviderInterfaceName,ConsumerIntefaceGroupName,ProviderIntefaceGroupName, XformInfo,CrossPageConnectionID,CrossPageURL,CrossPageInitEventArgs

Este formato se repite para cada conexión que se almacenan con un elemento Web con cada conexión separado por punto y coma (;). No debe haber ningún punto y coma después de la última conexión almacenada.

La tabla siguiente describe cada uno de los elementos de la cadena de la propiedad Connections .

Name

Description

ConsumerPartID

ConnectionID del elemento Web de consumidor.

ProviderPartID

ConnectionID del proveedor de elemento Web. Sin embargo, si el usuario está en modo de personalización cuando se crea la conexión y el proveedor de elemento Web es un elemento compartido que no existe ya una ConnectionID, la infraestructura de elementos Web utilizará la propiedad webPartID para identificar el elemento Web en su lugar. Esto es porque el ConnectionID no puede ser asignado y guardado cuando un elemento Web está en modo de personalización.

ConsumerInterfaceName

interfaceName de consumidor (tal y como se define en el método RegisterInterface de la interfaz de conexión). Será una cadena, como:

myRowConsumer_WPQ_.

ProviderInterfaceName

interfaceName del proveedor de elemento de Web (como se define en el método RegisterInterface de la interfaz de conexión). Será una cadena, como:

myRowProvider_WPQ_.

ConsumerInterfaceGroupName

interfaceName del elemento Web de consumidor. Esta configuración es idéntica a la del parámetro ConsumerInterfaceName .

ProviderInterfaceGroupName

interfaceName del proveedor de elemento Web. Esta configuración es idéntica a la del parámetro ProviderInterfaceName .

XFormInfo

(Opcional) Una cadena en la que un transformador puede guardar cualquier información de eliminación de ambigüedades que necesita para realizar su lógica durante el tiempo de ejecución. Las definiciones y los ejemplos siguientes son para los transformadores proporcionados con la infraestructura de elementos Web.

  • IRowProvider to ICellConsumer

    Un valor de cadena único que se corresponde con el nombre de columna para los datos que se enviarán desde el IRowProvider a la ICellConsumer en el formulario IRowProviderColumnName. En el siguiente ejemplo se muestra la cadena de un IRowProvider especificar una columna denominada nombre.

    First%20Name

  • IRowProvider to IFilterConsumer

    Un par de cadenas que corresponden a los nombres de dos columnas que se buscarán para filtrar en el formulario: IFilterConsumerColumn = IRowProviderColumn. En el siguiente ejemplo se muestra la cadena de un IFilterConsumer especifica un filtro en la columna con nombre apellido con una columna denominada Apellidos proporcionado por un IRowProvider.

    Surname=Last%20Name

  • IRowProvider to IParametersInConsumer

    Un conjunto de pares de columnas que se muestran los mismos datos en el formulario: (IRowProviderColumn = IParametersInConsumerPropertyName ).

    (First%20Name=FName)(Last%20Name=LName)(Phone%20Number=Phone)(Company=Co)

  • IParametersOutProvider to IParametersInConsumer

    Un conjunto de pares de columnas que se muestran los mismos datos en el formulario: (IParametersOutProviderPropertyName = IParametersInConsumerPropertyName )...

    (First=FName)(Last=LName)(Number=Phone)(Employer=Co)

CrossPageConnectionID

(Opcional) Para una conexión entre páginas, éste es el identificador único de la conexión en la otra página a la que se está conectando el elemento Web. El parámetro crosspageconnectionid es una Guid y debe ser único en las dos páginas. La herramienta de edición debe generar este Id.

CrossPageURL

(Opcional) Para una conexión entre páginas, se trata de la dirección URL de la página a la que está conectado el elemento Web.

CrossPageInitEventArgs

(Opcional) Para una conexión entre páginas, ésta es la estructura de InitEventArgs de la interfaz de la otra página a la que el elemento Web se está conectando con formato como un fragmento de XML. El siguiente es un ejemplo de una estructura de IFilterConsumerInitEventArgs con formato para el parámetro CrossPageInitEventArgs .

<FilterConsumerInitEventArgs>><Field FieldName="First Name" FieldDisplayName="First Name"/><Field FieldName="Surname" FieldDisplayName="Sur Name"/><Field FieldName="Phone" FieldDisplayName="Phone Number"/><Field FieldName="Company" FieldDisplayName="Company"/></FilterConsumerInitEventArgs>

El siguiente es un ejemplo de una estructura de IParametersInConsumerInitEventArgs con formato para el parámetro CrossPageInitEventArgs .

<ParametersInConsumerInitEventArgs><Parameter ParameterName="LName" ParameterDisplayName="Last Name" Required="True" Description="Last Name of an employee."><Parameter ParameterName="FName" ParameterDisplayName="First Name" Required="True" Description="First Name of an employee."><Parameter ParameterName="Co" ParameterDisplayName="Company" Required="False" Description="Company the employee previously worked for."><Parameter ParameterName="Phone" ParameterDisplayName="Business Phone" Required="False" Description="Business Phone Number of an employee."></ParametersInConsumerInitEventArgs>

Se utiliza una coma para delimitar los parámetros individuales de una conexión. Se utiliza un punto y coma para delimitar toda conexiones. No se permite el espacio en blanco antes o después de los delimitadores. Si se usa una coma, un punto y coma o un signo de porcentaje en cualquiera de los parámetros, la infraestructura de elementos Web codifica el delimitador, tal como se muestra en la siguiente tabla.

Delimitador

Codificación

,

%2 C

;

% 3B

%

25%

El valor de la propiedad Connections se almacena en un solo lado (elemento Web) de una conexión a menos que sea una conexión entre páginas. Para las conexiones entre páginas, la conexión se almacena con ambos lados de la conexión. De forma predeterminada, la infraestructura de elementos Web almacena el valor de la propiedad Connections con el elemento Web de consumidor aunque admite la infraestructura de almacenamiento de una conexión en el lado del proveedor para elementos Web estático (un elemento Web fuera de un control de WebPartZone ) y para las conexiones entre páginas.

Esta propiedad no se puede personalizar por usuarios individuales. El valor de su WebPartStorageAttribute es Storage.Shared, que especifica que la propiedad se almacena con el mismo valor para todos los usuarios. Sólo los usuarios con el derecho de escritura de páginas web pueden establecer esta propiedad. Puede establecerse sólo mediante programación.

Ejemplos

El siguiente es un ejemplo de un valor de la propiedad Connections para una conexión directa entre ICellProvider y ICellConsumer elementos Web en la misma página de elementos Web.

f690a578-6d1b-4d04-b081-011a93fa23bf,332f8676-875b-44eb-a537-8f946edb7e5f,MyCellConsumer_WPQ_,MyCellProvider_WPQ_,MyCellConsumer_WPQ_,MyCellProvider_WPQ_

El siguiente es un ejemplo de configuración de propiedades de Connections de ambos lados de la conexión entre un IFilterConsumer elemento Web y un elemento Web mediante un transformador IRowProvider entre páginas.

A continuación se muestra el valor de la propiedad Connection para el elemento Web en la página de origen (origen ASPX):

a93e4d5a-835b-4a80-80c0-a0e23149ed03,69c42cf9-e98b-4f6e-954a-42c7b46ba32e,MyFilterConsumerInterface_WPQ_,RowProviderInterface,MyFilterConsumerInterface_WPQ_,RowProviderInterface,Surname=Last%20Name,0e194b89-eaf0-4fcb-93f9-fe6c0a7a88d1,target.aspx,<FilterConsumerInitEventArgs>><Field FieldName="First Name" /><Field FieldName="Surname" /><Field FieldName="Phone" /><Field FieldName="Company" /></FilterConsumerInitEventArgs>

A continuación se muestra el valor de la propiedad Connection para el elemento Web en la página de destino (ASPX de destino):

a93e4d5a-835b-4a80-80c0-a0e23149ed03,69c42cf9-e98b-4f6e-954a-42c7b46ba32e,MyFilterConsumerInterface_WPQ_,RowProviderInterface,MyFilterConsumerInterface_WPQ_,RowProviderInterface,,0e194b89-eaf0-4fcb-93f9-fe6c0a7a88d1,source.aspx,

Vea también

Referencia

clase WebPart

Miembros WebPart

Espacio de nombres Microsoft.SharePoint.WebPartPages