THE WORLD'S LARGEST WEB DEVELOPER SITE
HTMLCSSJAVASCRIPTSQLPHPBOOTSTRAPJQUERYANGULARXML
 

WebSecurity - InitializeDatabaseConnection()


WebSecurity Object WebSecurity Object

Definition

The InitializeDatabaseConnection() method initializes the WebSecurity database.

The method initializes the WebSecurity system by connecting to the database that contains user and membership information.


C# and VB Syntax

WebSecurity.InitializeDatabaseConnection(connectionString, userTableName, userIdColumn, userNameColumn, autoCreateTables)

Parameters

Parameter Type Description
connectionString String

The name of your WebSecurity database (se remarks)

userTableName String The database table that contains the user profile information
userIdColumn String The database column that contains the user IDs (primary keys)
userNameColumn String The database column that contains the user names
autoCreateTables Boolean true indicates that user profile and membership tables should be created if they do not exist, otherwise false

Return Value

None.


Remarks

If you are using SQL Server Compact, connectionString should be the name of the WebSecurity database (without the .sdf file name extension). Otherwise it should be the name of a connection string in the web configuration (web.config file).

Note  Even if autoCreateTables can force the database tables to be created automatically, the database itself must always exist.

Errors and Exceptions

The InitializeDatabaseConnection() method throws an InvalidOperationException if:

  • SimpleMembership is not initialized (or disabled in the website configuration)

Technical Data

Name Value
Namespace WebMatrix.WebData
Assembly WebMatrix.WebData.dll

WebSecurity Object WebSecurity Object