El WebPart Framework Parte 2 Programming ASP.NET El WebPart Framework Parte 2 Jorge Oblitas Consultor Independiente Microsoft Regional Director Peru – Región Andina Copyright © 2001-2002

Conexiones entre Web Parts Programming ASP.NET Conexiones entre Web Parts Los Web Parts se pueden comunicar El Provider publica la interface El Consumer usa la interface para obtener los datos El WebPartManager maneja las conexiones Recoge las interfaces de los providers Provee de interfaces a los consumers Las conexiones pueden ser estáticas o dinámicas ConnectionsZone provee la UI para eso Copyright © 2001-2002

Providers de la Conexión Programming ASP.NET Providers de la Conexión Implementa métodos que retornan interface [ConnectionProvider] [ConnectionProvider (“Codigo Postal", “CodigoPostalProvider")] public ICodigoPostal GetCodigoPostalInterface () { return this; // Se asume que el control implementa ICodigoPostal } // Implementación ICodigPostal.GetCodigoPostal public string GetCodigoPostal () return _zip; Copyright © 2001-2002

Consumers de la conexión Programming ASP.NET Consumers de la conexión Implementa el método que recibe la interface Atributo [ConnectionConsumer] [ConnectionConsumer (“Codigo Postal", “CodigoPostalConsumer")] public void GetICodigoPostalInterface (ICodigoPostal provider) { string zip = provider.GetCodigoPostal (); // Obtiene el código postal // del provider } Copyright © 2001-2002

Cómo trabajan las conexiones Programming ASP.NET Cómo trabajan las conexiones WebPartManager 1 El WebPartManager llama al método [ConnectionProvider] 2 El WebPartManager recibe la Interface del provider 1 2 3 3 El WebPartManager llama al método [ConnectionConsumer] , Pasando la interfaceal consumer Provider Consumer 4 4 El consumer llama al provider Usando la interface provista Copyright © 2001-2002

Programming ASP.NET Conexiones estáticas Se define en el elemento <StaticConnections> del WebPartManager No puede ser editado por los usuarios finales Instancias de <asp:Connection> <asp:WebPartManager ID="WebPartManager1" Runat="server"> <StaticConnections> <asp:Connection ID=“CodigoPostalConnection" Runat="server" ProviderID=“Clima" ProviderConnectionPointID=“CodigoPostalProvider" ConsumerID=“Noticias" ConsumerConnectionPointID=“CodigoPostalConsumer" /> </StaticConnections> </asp:WebPartManager> Copyright © 2001-2002

El control ConnectionsZone Programming ASP.NET El control ConnectionsZone Provee la Interface de usuario para conectar Web Parts Los usuarios, no lo desarrolladores, crean las conexiones. <asp:ConnectionsZone ID="ConnectionsZone1" Runat="server" /> Copyright © 2001-2002

Programming ASP.NET Conectando WebParts Copyright © 2001-2002

Personalización de Web Parts Programming ASP.NET Personalización de Web Parts El servicio de personalización de Web Parts Automáticamente persiste las propiedades relevantes del Web Part (layout, apariencia, etc.) También persiste las propiedades personalizadas marcadas con PersonalizableAttribute La clase PersonalizationAdministration Provee la API para el servicio de personalización -Basada en provides para un almacenamiento de datos flexible. Copyright © 2001-2002

Personalización por usuario Programming ASP.NET Personalización por usuario [Personalizable] persiste las propiedades por usuario string _stocks; // ejemplo: "MSFT,INTC,AMZN" [WebBrowsable] [Personalizable] public string Stocks { get { return _stocks; } set { _stocks = value; } } Copyright © 2001-2002

Personalización compartida Programming ASP.NET Personalización compartida [Personalizable (PersonalizationScope.-Shared)] persiste las propiedades de forma compartida string _stocks; // ejemplo: "MSFT,INTC,AMZN" [WebBrowsable] [Personalizable (PersonalizationScope.Shared)] public string Stocks { get { return _stocks; } set { _stocks = value; } } Copyright © 2001-2002

Providers de Personalización Programming ASP.NET Providers de Personalización EL servicio de personalización de Web Parts está basado en providers Beta 1 viene con dos providers AccessPersonalizationProvider (Access)* SqlPersonalizationProvider (SQL Server) Usemos providers personalizados para agregar soporte para otros manejadores de datos. * Will be removed from beta 2 Copyright © 2001-2002

Usando el SQL Server Provider Programming ASP.NET Usando el SQL Server Provider <configuration> <system.web> <webParts> <personalization defaultProvider="AspNetSqlPersonalizationProvider" /> </webParts> </system.web> </configuration> Copyright © 2001-2002

Web Parts Personalizados Programming ASP.NET Web Parts Personalizados Cualquier control sirve como Web Part, pero… Los controles que derivan de WebPart pueden mejorar la infraestructura de los web parts. Controles Title y otras propiedades relacionadas con la UI Controles AllowClose, AllowZoneChange, AllowMinimize, y otras propiedades de conducta Se aplica seguridad basada en roles (filtros de autorización) Agregar verbos personalizados, exportar Web Parts y más Copyright © 2001-2002

Agregando Verbos personalizados Programming ASP.NET Agregando Verbos personalizados public class MiWebPart : WebPart { public override WebPartVerbCollection Verbs get { EnsureChildControls (); WebPartVerb verb = new WebPartVerb (new WebPartEventHandler (OnClearResults)); verb.Text = "Clear Results"; WebPartVerb[] verbs = new WebPartVerb[] { verb }; return new WebPartVerbCollection (base.Verbs, verbs); } void OnClearResults (object sender, WebPartEventArgs args) { ... } ... Copyright © 2001-2002

Exportando Web Parts Propiedad WebPart.ExportMode Programming ASP.NET Exportando Web Parts Propiedad WebPart.ExportMode WebPartExportMode.None (por defecto) WebPartExportMode.All WebPartExportMode.NonSensitiveData "All" y "NonSensitiveData" agregan el verbo “exportar” habilitando a los web parts a ser exportados. Propiedades [Personalizable] only PersonalizableAttribute.IsSensitive identifica las propiedades "sensitivas" Copyright © 2001-2002

Exportando todas las propiedades Programming ASP.NET Exportando todas las propiedades public class MiWebPart : WebPart { public MyWebPart () ExportMode = WebPartExportMode.All; } ... Copyright © 2001-2002

Exportando propiedades seleccionadas Programming ASP.NET Exportando propiedades seleccionadas public class MiWebPart : WebPart { public MyWebPart () ExportMode = WebPartExportMode.NonSensitiveData; } // Esta propiedad será exportada [Personalizable (PersonalizationScope.User, false)] public string CodigoPostal { ... } // Esta no [Personalizable (PersonalizationScope.User, true)] public string NumerodeSeguroSocial ... IsSensitive Copyright © 2001-2002

Web Parts personalizados Programming ASP.NET Web Parts personalizados Copyright © 2001-2002