Partager via


ConfigurationSetting, méthode - SetDatabaseConnection

Définit la connexion à une base de données de serveur de rapports spécifique.

Syntaxe

Public Sub SetDatabaseConnection(Server as String, _  
    DatabaseName as string, CredentialsType as Integer, _  
    Username as String, Password as String, ByRef HRESULT as Int32)  
public void SetDatabaseConnection(string Server,   
    string DatabaseName, Int32 CredentialsType,   
    string UserName, string Password, out Int32 HRESULT);  

Paramètres

Serveur
Nom de l’instance SQL Server utilisée pour héberger la base de données du serveur de rapports.

DatabaseName
Nom de la base de données du serveur de rapports.

CredentialsType
Type d'informations d'identification à utiliser pour la connexion. Les valeurs peuvent être les suivantes :

  • 0 - Windows

  • 1 - SQL Server

  • 2 - Service Windows

UserName
Nom du compte utilisé pour établir la connexion à la base de données du serveur de rapports.

Mot de passe
Mot de passe utilisé pour établir la connexion à la base de données du serveur de rapports.

HRESULT
[out] Valeur indiquant si l'appel a réussi ou échoué.

Valeur de retour

Retourne un paramètre HRESULT qui indique si l'appel de la méthode a réussi ou a échoué. Une valeur 0 indique que l'appel de méthode a réussi. Une valeur différente de zéro indique qu’une erreur s’est produite.

Notes

Quand le paramètre CredentialsType a la valeur 0 (Windows), les paramètres UserName et Password doivent être définis. Le paramètre UserName doit être au format domain\username, et la valeur doit représenter une ouverture de session Windows valide.

Quand le paramètre CredentialsType a la valeur 1 (SQL Server), la valeur passée dans le paramètre UserName doit être conforme aux spécifications d’un nom de connexion SQL Server.

Quand le paramètre CredentialsType a la valeur 2 (Service Windows), le serveur de rapports utilise la sécurité intégrée pour se connecter à la base de données du serveur de rapports, et les paramètres UserName et Password sont ignorés. Le service web Report Server utilise soit le compte ASP.NET, soit le compte d’un pool d’applications et le compte de service Windows pour accéder à la base de données du serveur de rapports.

Quand la méthode SetDatabaseConnection est appelée, elle chiffre et stocke les informations d’identification et les informations sur la base de données dans le fichier de configuration du serveur de rapports spécifié.

La méthode SetDatabaseConnection ne vérifie pas si le serveur de rapports peut se connecter à la base de données à l’aide des données spécifiées.

Quand elle est définie pour la première fois, la propriété ConnectionPoolSize est définie selon les processeurs suivants : ConnectionPoolSize = #Processors * 75.

La méthode SetDatabaseConnection n’accorde pas d’autorisations au(x) compte(s) spécifié(s). Vous devez appeler la méthode GenerateDatabaseRightsScript pour chaque compte qui doit accéder à la base de données du serveur de rapports et exécuter le script obtenu.

Spécifications

Espace de noms : root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin