(SqlConnectionStringBuilder, String, SecureString) del método SPFarm.Open
NOTA: esta API está ahora obsoleta.
Ha quedado obsoleto. Utilice el método Open() que toma una frase de contraseña. Devuelve un objeto Object que representa un SPFarm remoto.
Espacio de nombres: Microsoft.SharePoint.Administration
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
<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
Tipo: System.Data.SqlClient.SqlConnectionStringBuilderContiene la cadena de conexión para la base de datos de configuración de la granja de servidores remotos.
username
Tipo: System.StringContiene el nombre de usuario para la cuenta de la granja de servidores que se usa para el servicio de temporizador y grupo de servidores de aplicaciones de sitio administrativo.
password
Tipo: System.Security.SecureStringContiene la contraseña de la cuenta de la granja de servidores que se usa para el servicio de temporizador y grupo de servidores de aplicaciones de sitio administrativo. El texto está cifrado de privacidad cuando se memoria utilizarse y eliminarse desde el equipo cuando ya no sea necesario.
Valor devuelto
Tipo: Microsoft.SharePoint.Administration.SPFarm
Un objeto SPFarm que representa el conjunto de servidores remotos.
Excepciones
Excepción | Condición |
---|---|
InvalidOperationException | Ha quedado obsoleto. Utilice el método Open() que toma una frase de contraseña. |
ArgumentNullException | objeto de SqlConnectionStringBuilder es una referencia null (Nothing en Visual Basic). |
Comentarios
El nombre de usuario y la contraseña que se proporcionan deben asociarse con una cuenta de dominio.
Este método requiere acceso a la base de datos de configuración de granjas de servidores remotas. Si la identidad del usuario o proceso actual no tiene permiso para tener acceso a la base de datos, o si el equipo local no está en la misma red que la base de datos, esta llamada producirá un error con una excepción de tipo SqlException y un mensaje que indica éste es el caso.