Création de la base de données des services d'application pour SQL Server
Mise à jour : novembre 2007
Plusieurs fonctionnalités ASP.NET reposent sur un fournisseur pour gérer le stockage et la récupération de données à partir d'une source de données. Chaque fournisseur est spécifique à la source de données. ASP.NET inclut un fournisseur Microsoft SQL Server pour les fonctionnalités ASP.NET suivantes :
Appartenance (classe SqlMembershipProvider)
Gestion des rôles (classe SqlRoleProvider).
Profil (classe SqlProfileProvider)
Personnalisation de WebParts (classe SqlPersonalizationProvider)
Événements Web (classe SqlWebEventProvider)
Par défaut, chaque fournisseur SQL Server stocke des données dans une base de données générée automatiquement à l'aide d'une installation Microsoft SQL Server Express locale. Chaque fonctionnalité peut être utilisée individuellement, ou conjointement avec d'autres fonctionnalités. Par exemple, vous pouvez utiliser la gestion des rôles seule ou conjointement avec les informations utilisateur gérées par la fonctionnalité d'appartenance.
Fournisseurs SQL Server préconfigurés
Lorsque vous installez ASP.NET, le fichier de configuration machine et le fichier Web.config racine de votre serveur incluent des éléments de configuration qui spécifient les fournisseurs SQL Server pour chacune des fonctionnalités ASP.NET qui dépendent d'un fournisseur. Ces fournisseurs sont configurés, par défaut, pour se connecter à une instance locale de SQL Server Express. Si vous prévoyez d'utiliser uniquement SQL Server Express avec l'emplacement par défaut spécifié dans la section connectionStrings du fichier de configuration machine, vous n'avez pas besoin d'installer manuellement la base de données. Si vous devez configurer une base de données à l'aide d'une version standard de SQL Server exécutée sur le même serveur ou configurer un ordinateur SQL Server distant, vous devrez utiliser cet outil.
Remarque : |
---|
L'outil Aspnet_regsql ne doit pas être utilisé avec une installation locale de SQL Server Express exécutée en mode instance d'utilisateur (c.-à-d. lorsque la chaîne de connexion contient User Instance=true). |
Installation de la base de données à l'aide d'Aspnet_regsql.exe
ASP.NET inclut un outil permettant d'installer la base de données SQL Server utilisée par les fournisseurs SQL Server, appelé Aspnet_regsql.exe. L'outil Aspnet_regsql.exe se trouve dans le dossier lecteur:\WINDOWS\Microsoft.NET\Framework\numéroVersion de votre serveur Web. Aspnet_regsql.exe est utilisé à la fois pour créer la base de données SQL Server et pour ajouter ou supprimer des options d'une base existante.
Vous pouvez exécuter Aspnet_regsql.exe sans argument de la ligne de commande pour exécuter un Assistant qui vous aidera à spécifier les informations de connexion pour l'ordinateur SQL Server et à installer ou supprimer des éléments de base de données pour toutes les fonctionnalités prises en charge. Vous pouvez également exécuter Aspnet_regsql.exe comme outil de ligne de commande pour spécifier les éléments de base de données de fonctionnalités particulières à ajouter ou à supprimer.
Remarque : |
---|
Les éléments de base de données qui sont installés dans la base de données des fonctionnalités appartiendront toujours au compte du propriétaire de la base de données SQL Server (dbo). Pour installer la base de données des fonctionnalités, une connexion SQL Server doit être autorisée pour les rôles db_ddladmin et dd_securityadmin sur la base de données SQL Server. Toutefois, vous n'avez pas besoin d'être un administrateur système pour SQL Server afin d'installer la base de données des fonctionnalités. |
Pour exécuter l'Assistant Aspnet_regsql.exe, exécutez Aspnet_regsql.exe sans argument de la ligne de commande, comme indiqué dans l'exemple suivant :
C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.exe
Vous pouvez également exécuter l'outil Aspnet_regsql.exe comme un utilitaire en ligne de commande. Par exemple, la commande suivante installe les éléments de base de données pour l'appartenance et la gestion des rôles sur le serveur SQL Server local.
aspnet_regsql.exe -E -S localhost -A mr
Le tableau suivant décrit les options de ligne de commande prises en charge par l'outil Aspnet_regsql.exe.
Option |
Description |
---|---|
-? |
Imprime le texte d'aide de l'outil Aspnet_regsql.exe dans la fenêtre de commande. |
-W |
Exécute l'outil en mode Assistant. C'est la valeur par défaut si aucun argument de la ligne de commande n'est spécifié. |
-C chaîne de connexion |
Chaîne de connexion à l'ordinateur SQL Server sur lequel la base de données sera installée ou est déjà installée. Cette option n'est pas nécessaire si vous spécifiez uniquement le serveur (-S) et les informations de connexion (-U et -P ou -E). |
-S serveur |
Nom de l'ordinateur SQL Server sur lequel la base de données sera installée ou est déjà installée. Le nom du serveur peut également inclure un nom d'instance, tel que .\INSTANCENAME. |
-U nom d'accès |
Identificateur utilisateur SQL Server avec lequel ouvrir une session. Cette option nécessite également l'option de mot de passe (-P). Cette option n'est pas nécessaire dans le cas d'une authentification effectuée à l'aide des informations d'identification Windows (-E). |
-P mot de passe |
Mot de passe SQL Server avec lequel ouvrir une session. Cette option exige également l'option de nom d'accès (-U). Cette option n'est pas nécessaire dans le cas d'une authentification effectuée à l'aide des informations d'identification Windows (-E). |
-E |
Procède à l'authentification à l'aide des informations d'identification Windows de l'utilisateur actuellement connecté. |
-d base de données |
Nom de la base de données à créer ou modifier. Si la base de données n'est pas spécifiée, le nom de la base de données par défaut, " aspnetdb " est utilisé. |
-sqlexportonly nom_fichier |
Génère un fichier de script SQL qui peut être utilisé pour ajouter ou supprimer les fonctionnalités spécifiées. Les actions spécifiées ne sont pas exécutées. |
-A all|m|r|p|c|w |
Ajoute la prise en charge d'une ou plusieurs fonctionnalités. Les identificateurs suivants sont utilisés pour les fonctionnalités ASP.NET.
IdentificateurAffecte
allToutes les fonctionnalités
mAppartenance
rGestion des rôles
pProfil
cPersonnalisation des WebParts
wÉvénements Web
Les identificateurs de fonctionnalités peuvent être spécifiés ensemble ou séparément, comme l'illustrent les exemples suivants. aspnet_regsql.exe -E -S localhost -A mp aspnet_regsql.exe -E -S localhost -A m -A p |
-R all|m|r|p|c|w |
Supprime la prise en charge d'une ou plusieurs fonctionnalités. Les identificateurs suivants sont utilisés pour les fonctionnalités ASP.NET.
IdentificateurAffecte
allToutes les fonctionnalités
mAppartenance
rGestion des rôles
pProfil
cPersonnalisation des WebParts
wÉvénements Web
Les identificateurs de fonctionnalités peuvent être spécifiés ensemble ou séparément, comme l'illustrent les exemples suivants. aspnet_regsql.exe -E -S localhost -R mp aspnet_regsql.exe -E -S localhost -R m -R p |
-Q |
Exécute l'outil en mode silencieux et n'affiche pas de message de confirmation avant de supprimer une fonctionnalité. |
Voir aussi
Concepts
Accès à SQL Server à partir d'une application Web
Fournisseurs de profils ASP.NET
Fournisseurs de navigation de site ASP.NET
Autres ressources
Création et configuration de la base de données des services d'application pour SQL Server