SPFarm.Open - Méthode (SqlConnectionStringBuilder, String, String)
Remarque : cette API est désormais obsolète.
Retourne une batterie de serveurs à distance basée sur la chaîne de connexion spécifiée, le nom d'utilisateur et le mot de passe. Obsolète. Utilisez la méthode Open() qui accepte un mot de passe.
Espace de noms : Microsoft.SharePoint.Administration
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
<ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.", _
False)> _
Public Shared Function Open ( _
connectionString As SqlConnectionStringBuilder, _
user As String, _
password As String _
) As SPFarm
'Utilisation
Dim connectionString As SqlConnectionStringBuilder
Dim user As String
Dim password As String
Dim returnValue As SPFarm
returnValue = SPFarm.Open(connectionString, _
user, password)
[ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.",
false)]
public static SPFarm Open(
SqlConnectionStringBuilder connectionString,
string user,
string password
)
Paramètres
connectionString
Type : System.Data.SqlClient.SqlConnectionStringBuilderUn objet SqlConnectionStringBuilder qui contient la chaîne de connexion pour la base de données de configuration de la batterie de serveurs à distance.
user
Type : System.StringUn objet String qui contient le nom d'utilisateur pour le compte de batterie de serveurs qui est utilisé pour le service d'application d'administration site pool et timer.
password
Type : System.StringUn objet String qui contient le mot de passe pour le compte de batterie de serveurs qui est utilisé pour le service d'application d'administration site pool et timer.
Valeur renvoyée
Type : Microsoft.SharePoint.Administration.SPFarm
Objet SPFarm qui représente la batterie de serveurs à distance.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | objet SqlConnectionStringBuilder est une référence Null (Rien dans Visual Basic). |
Remarques
Lorsqu'un objet [T:System:String] contient des informations sensibles comme un mot de passe, il existe un risque que les informations soient révélées après leur utilisation, car votre application ne peut pas supprimer les données de la mémoire de l'ordinateur. Vous pouvez fournir le paramètre farmPassword sous la forme d'un objet SecureString , pour assurer leur protection contre une exposition accidentelle ou malveillante. Voir Open.
Le nom d'utilisateur et le mot de passe que vous fournissez doivent être associés à un compte de domaine.
Cette méthode requiert l'accès à la base de données de configuration de batteries de serveurs distantes. Si l'identité d'utilisateur ou le processus actuel n'est pas autorisé à accéder à la base de données, ou si l'ordinateur local n'est pas sur le même réseau que la base de données, cet appel échoue avec une avec une exception de type SqlException et un message indiquant que c'est le cas.