SPFarm.Open method (SqlConnectionStringBuilder, String, SecureString)
NOTE: This API is now obsolete.
Obsoleto. Use o método Open() que usa uma senha. Retorna um objeto representando um SPFarm remoto.
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
<ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.", _
False)> _
Public Shared Function Open ( _
connectionString As SqlConnectionStringBuilder, _
username As String, _
password As SecureString _
) As SPFarm
'Uso
Dim connectionString As SqlConnectionStringBuilder
Dim username As String
Dim password As SecureString
Dim returnValue As SPFarm
returnValue = SPFarm.Open(connectionString, _
username, password)
[ObsoleteAttribute("Use the SPFarm.Open method that takes a passphrase.",
false)]
public static SPFarm Open(
SqlConnectionStringBuilder connectionString,
string username,
SecureString password
)
Parâmetros
connectionString
Type: System.Data.SqlClient.SqlConnectionStringBuilderContém a seqüência de conexão para o banco de dados de configuração de farm de servidor remoto.
username
Type: System.StringContém o nome de usuário para a conta do farm de servidor é usado para o pool e o timer de serviço de aplicativo do site administrativo.
password
Type: System.Security.SecureStringContém a senha para a conta do farm de servidor é usada para o pool e o timer de serviço de aplicativo do site administrativo. O texto é criptografado para privacidade quando ele está sendo usado e excluído da memória quando ela não for mais necessário.
Valor retornado
Type: Microsoft.SharePoint.Administration.SPFarm
Um objeto SPFarm que representa o farm de servidores remotos.
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | Obsoleto. Use o método Open() que usa uma senha. |
ArgumentNullException | objeto de SqlConnectionStringBuilder é a null reference (Nothing in Visual Basic). |
Comentários
O nome de usuário e a senha fornecidos devem ser associados uma conta de domínio.
Este método requer acesso ao banco de dados de configuração de farms remotos. Se a identidade do usuário ou processo atual não tem permissão para acessar o banco de dados, ou se a máquina local não estiver na mesma rede que o banco de dados, a chamada falhará com uma exceção de tipo SqlException e uma mensagem que indica que esse é o caso.