SPFarm.Open 方法 (SqlConnectionStringBuilder, String, String)
请注意:此 API 现在已过时。
返回基于指定的连接字符串、 用户名和密码的远程服务器场。过时。使用Open()方法接受一个密码短语。
命名空间: Microsoft.SharePoint.Administration
程序集: Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)
语法
声明
<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
用法
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
)
参数
connectionString
类型:System.Data.SqlClient.SqlConnectionStringBuilderSqlConnectionStringBuilder对象,该对象包含远程服务器场的配置数据库的连接字符串。
user
类型:System.StringString对象,该对象包含用于管理网站应用程序池和计时器服务的服务器场帐户的用户名。
password
类型:System.StringString对象,该对象包含用于管理网站应用程序池和计时器服务的服务器场帐户的密码。
返回值
类型:Microsoft.SharePoint.Administration.SPFarm
一个SPFarm对象,表示远程服务器场。
异常
异常 | 条件 |
---|---|
ArgumentNullException | SqlConnectionStringBuilder对象是空引用(无 在 Visual Basic 中)。 |
备注
当**[T:System:String]**对象中包含敏感信息,如密码时,存在着某种风险,信息有可能因为应用程序无法从计算机内存中删除该数据使用后泄漏。您可以为一个SecureString对象,以帮助保护其免受意外或恶意公开提供的farmPassword参数。请参阅Open。
用户名称和您提供的密码必须使用域帐户相关联。
此方法需要访问远程的服务器场的配置数据库。如果当前用户或进程标识没有权限访问该数据库,或者如果本地计算机不是在数据库所在的相同网络上,此调用将失败,并具有类型SqlException和一条消息指出这种情况的例外。