Implementar un proveedor de perfiles
Actualización: noviembre 2007
La característica de perfiles de ASP.NET permite utilizar fácilmente distintos proveedores. Puede utilizar la clase SqlProfileProvider incluida con .NET Framework o puede implementar su propio proveedor.
Cree un proveedor de perfiles personalizado cuando:
Necesite almacenar información de perfil en un origen de datos, como una base de datos de FoxPro o de Oracle, que no sea compatible con los proveedores de perfiles incluidos en .NET Framework.
Necesite administrar la información de perfil mediante un esquema de base de datos distinto del que utilizan los proveedores que se distribuyen con .NET Framework. Un ejemplo común es la integración de la información de perfil con los datos de usuario en una base de datos de SQL Server existente.
Clases requeridas
Para implementar un proveedor de perfiles, es necesario crear una clase que herede la clase abstracta System.Web.Profile.ProfileProvider. A su vez, la clase abstracta ProfileProvider hereda la clase abstracta System.Configuration.SettingsProvider, que, a su vez, hereda la clase abstracta System.Configuration.Provider.ProviderBase. Debido a esta cadena de herencia, además de los miembros requeridos de la clase ProfileProvider, es necesario implementar también los miembros requeridos de las clases SettingsProvider y ProviderBase.
En las tablas siguientes se describen las propiedades y los métodos que se deben implementar de las clases abstractas ProviderBase, SettingsProvider y ProfileProvider. Para revisar la implementación de cada uno de los miembros, vea Cómo: Generar y ejecutar el ejemplo de proveedor de perfiles.
Miembros de ProviderBase
Miembro |
Descripción |
|---|---|
Método Initialize |
Toma como entrada el nombre de la instancia del proveedor y un objeto NameValueCollection de parámetros de configuración. Se utiliza para establecer las opciones y los valores de las propiedades en la instancia del proveedor, entre los que se incluyen los valores específicos de la implementación y las opciones especificadas en la configuración del equipo o en el archivo Web.config. |
Miembros de SettingsProvider
Miembro |
Descripción |
|---|---|
Propiedad ApplicationName |
El nombre de aplicación que se almacena con cada perfil. El proveedor de perfiles utiliza el nombre de aplicación para almacenar independientemente la información del perfil de cada aplicación. Esto permite a varias aplicaciones ASP.NET utilizar el mismo origen de datos sin que se produzca un conflicto si se crea el mismo nombre de usuario en aplicaciones diferentes. Opcionalmente, varias aplicaciones ASP.NET pueden compartir un origen de datos de perfil si se especifica el mismo nombre de aplicación. |
Método GetPropertyValues |
Toma como entrada los objetos SettingsContext y SettingsPropertyCollection. El objeto SettingsContext proporciona información sobre el usuario. Puede utilizar dicha información como clave principal para recuperar información sobre las propiedades de perfil correspondientes al usuario. Utilice el objeto SettingsContext para obtener el nombre de usuario y comprobar si éste se ha autenticado o es anónimo. El objeto SettingsPropertyCollection contiene una colección de objetos SettingsProperty. Cada objeto SettingsProperty proporciona el nombre y tipo de la propiedad, junto con información adicional, como el valor predeterminado de la propiedad y si ésta es de sólo lectura. El método GetPropertyValues rellena un objeto SettingsPropertyValueCollection con objetos SettingsPropertyValue basados en los objetos SettingsProperty proporcionados como entrada. Los valores del origen de datos para el usuario especificado se asignan a las propiedades PropertyValue de cada objeto SettingsPropertyValue y se devuelve la colección completa. La llamada al método también actualiza a la fecha y hora actuales el valor de LastActivityDate correspondiente al perfil de usuario especificado. |
Método SetPropertyValues |
Toma como entrada los objetos SettingsContext y SettingsPropertyValueCollection. El objeto SettingsContext proporciona información sobre el usuario. Puede utilizar dicha información como clave principal para recuperar información sobre las propiedades de perfil correspondientes al usuario. Utilice el objeto SettingsContext para obtener el nombre de usuario y comprobar si éste se ha autenticado o es anónimo. El objeto SettingsPropertyValueCollection contiene una colección de objetos SettingsPropertyValue. Cada objeto SettingsPropertyValue proporciona el nombre, tipo y valor de la propiedad, junto con información adicional, como el valor predeterminado de la propiedad y si ésta es de sólo lectura. El método SetPropertyValues actualiza los valores de la propiedad de perfil en el origen de datos para el usuario especificado. La llamada al método también actualiza a la fecha y hora actuales los valores de LastActivityDate y LastUpdatedDate correspondientes al perfil de usuario especificado. |
Miembros de ProfileProvider
Miembro |
Descripción |
|---|---|
Método DeleteProfiles |
Toma como entrada una matriz de cadenas de nombres de usuario y elimina del origen de datos toda la información del perfil y los valores de las propiedades correspondientes a los nombres especificados cuyo nombre de aplicación coincida con el valor de la propiedad ApplicationName. Si su origen de datos admite transacciones, se recomienda que incluya todas las operaciones de eliminación en una transacción y que revierta ésta y produzca una excepción cuando se produzca un error en una de esas operaciones. |
Método DeleteProfiles |
Toma como entrada una colección de objetos ProfileInfo y elimina del origen de datos toda la información del perfil y los valores de las propiedades correspondientes a los perfiles cuyo nombre de aplicación coincida con el valor de la propiedad ApplicationName. Si su origen de datos admite transacciones, se recomienda que incluya todas las operaciones de eliminación en una transacción y que revierta ésta y produzca una excepción cuando se produzca un error en una de esas operaciones. |
Método DeleteInactiveProfiles |
Toma como entrada un valor ProfileAuthenticationOption y un objeto DateTime, y elimina del origen de datos toda la información del perfil y los valores de las propiedades cuya fecha de última actividad es anterior o igual a la fecha y hora especificadas, y cuyo nombre de aplicación coincide con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se eliminarán sólo perfiles anónimos, sólo perfiles autenticados o todos los perfiles. Si su origen de datos admite transacciones, se recomienda que incluya todas las operaciones de eliminación en una transacción y que revierta ésta y produzca una excepción cuando se produzca un error en una de esas operaciones. |
Método GetAllProfiles |
Toma como entrada un valor ProfileAuthenticationOption, un entero que especifica el índice de página, un entero que especifica el tamaño de página y una referencia a un entero que se establecerá en el número total de perfiles. Devuelve una colección ProfileInfoCollection que contiene objetos ProfileInfo para todos los perfiles del origen de datos cuyo nombre de aplicación coincida con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se devolverán sólo perfiles anónimos, sólo perfiles autenticados o todos los perfiles. Los resultados devueltos por el método GetAllProfiles están restringidos por los valores de índice de página y de tamaño de página. El valor de tamaño de página especifica el número máximo de objetos ProfileInfo que se van a devolver en ProfileInfoCollection. El valor de índice de página especifica la página de resultados que se va a devolver, teniendo en cuenta que 1 identifica la primera página. El parámetro correspondiente al número total de registros es un parámetro out (se puede utilizar ByRef en Visual Basic) que se establece en el número total de perfiles. Por ejemplo, si el almacén de datos contiene 13 perfiles de la aplicación y el valor de índice de página es 6 con un tamaño de página de 5, el resultado devuelto por ProfileInfoCollection contendrá del sexto al décimo perfil. Cuando el método devuelve el resultado, el valor del número total de registros se establece en 13. |
Método GetAllInactiveProfiles |
Toma como entrada un valor ProfileAuthenticationOption, un objeto DateTime, un entero que especifica el índice de página, un entero que especifica el tamaño de página y una referencia a un entero que se establecerá en el número total de perfiles. Devuelve una colección ProfileInfoCollection que contiene objetos ProfileInfo para todos los perfiles del origen de datos cuya última fecha de actividad es anterior o igual al valor de DateTime especificado y cuyo nombre de aplicación coincide con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se devolverán sólo perfiles anónimos, sólo perfiles autenticados o todos los perfiles. Los resultados devueltos por el método GetAllInactiveProfiles están restringidos por los valores de índice de página y de tamaño de página. El valor de tamaño de página especifica el número máximo de objetos ProfileInfo que se van a devolver en ProfileInfoCollection. El valor de índice de página especifica la página de resultados que se va a devolver, teniendo en cuenta que 1 identifica la primera página. El parámetro correspondiente al número total de registros es un parámetro out (se puede utilizar ByRef en Visual Basic) que se establece en el número total de perfiles. Por ejemplo, si el almacén de datos contiene 13 perfiles de la aplicación y el valor de índice de página es 2 con un tamaño de página de 5, el resultado devuelto por ProfileInfoCollection contendrá del sexto al décimo perfil. Cuando el método devuelve el resultado, el valor del número total de registros se establece en 13. |
Método FindProfilesByUserName |
Toma como entrada un valor ProfileAuthenticationOption, una cadena que contiene un nombre de usuario, un entero que especifica el índice de página, un entero que especifica el tamaño de página y una referencia a un entero que se establecerá en el número total de perfiles. Devuelve una colección ProfileInfoCollection que contiene objetos ProfileInfo para todos los perfiles del origen de datos cuyo nombre de usuario coincide con el nombre de usuario especificado y cuyo nombre de la aplicación coincide con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se devolverán sólo perfiles anónimos, sólo perfiles autenticados o todos los perfiles. Si el origen de datos admite funciones de búsqueda adicionales, como caracteres comodín, puede incluir funciones de búsqueda más avanzadas para los nombres de usuario. Los resultados devueltos por el método FindProfilesByUserName están restringidos por los valores de índice de página y de tamaño de página. El valor de tamaño de página especifica el número máximo de objetos ProfileInfo que se van a devolver en ProfileInfoCollection. El valor de índice de página especifica la página de resultados que se va a devolver, teniendo en cuenta que 1 identifica la primera página. El parámetro correspondiente al número total de registros es un parámetro out (se puede utilizar ByRef en Visual Basic) que se establece en el número total de perfiles. Por ejemplo, si el almacén de datos contiene 13 perfiles de la aplicación y el valor de índice de página es 2 con un tamaño de página de 5, el resultado devuelto por ProfileInfoCollection contendrá del sexto al décimo perfil. Cuando el método devuelve el resultado, el valor del número total de registros se establece en 13. |
Toma como entrada un valor ProfileAuthenticationOption, una cadena que contiene un nombre de usuario, un objeto DateTime, un entero que especifica el índice de página, un entero que especifica el tamaño de página y una referencia a un entero que se establecerá en el número total de perfiles. Devuelve una colección ProfileInfoCollection que contiene objetos ProfileInfo para todos los perfiles del origen de datos cuyo nombre de usuario coincide con el nombre de usuario especificado, cuya última fecha de actividad es anterior o igual al valor de DateTime especificado y cuyo nombre de aplicación coincide con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se devolverán sólo perfiles anónimos, sólo perfiles autenticados o todos los perfiles. Si el origen de datos admite funciones de búsqueda adicionales, como caracteres comodín, puede incluir funciones de búsqueda más avanzadas para los nombres de usuario. Los resultados devueltos por el método FindInactiveProfilesByUserName están restringidos por los valores de índice de página y de tamaño de página. El valor de tamaño de página especifica el número máximo de objetos ProfileInfo que se van a devolver en ProfileInfoCollection. El valor de índice de página especifica la página de resultados que se va a devolver, teniendo en cuenta que 1 identifica la primera página. El parámetro correspondiente al número total de registros es un parámetro out (se puede utilizar ByRef en Visual Basic) que se establece en el número total de perfiles. Por ejemplo, si el almacén de datos contiene 13 perfiles de la aplicación y el valor de índice de página es 2 con un tamaño de página de 5, el resultado devuelto por ProfileInfoCollection contendrá del sexto al décimo perfil. Cuando el método devuelve el resultado, el valor del número total de registros se establece en 13. |
|
Método GetNumberOfInactiveProfiles |
Toma como entrada un valor ProfileAuthenticationOption y un objeto DateTime, y devuelve el número total de perfiles del origen de datos cuya última fecha de actividad es anterior o igual al igual al valor de DateTime especificado y cuyo nombre de aplicación coincide con el valor de la propiedad ApplicationName. El parámetro ProfileAuthenticationOption especifica si se deben contar sólo los perfiles anónimos, sólo los perfiles autenticados o todos los perfiles. |
ApplicationName
Dado que los proveedores de perfiles almacenan independientemente la información de perfil de cada aplicación, deberá comprobar que el esquema de datos incluye el nombre de la aplicación y que éste también se incluye en las consultas y las actualizaciones. Por ejemplo, el comando siguiente se utiliza para recuperar un valor de propiedad de una base de datos a partir del nombre de usuario y de la condición de anónimo del perfil, y garantiza que el valor ApplicationName esté incluido en la consulta.
SELECT Property FROM PropertyTable
WHERE Username = 'user1' AND IsAnonymous = False
AND ApplicationName = 'MyApplication'
Vea también
Tareas
Cómo: Generar y ejecutar el ejemplo de proveedor de perfiles
Conceptos
Información general sobre las propiedades de perfil de ASP.NET