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.
|
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,