Compartilhar via


Authentication.Login Method

Usado em um sistema autenticação Forms-Based para definir uma autenticação de cookie ou, se houver um problema com o logon, retornar um código de erro.

Web Service: AuthenticationWeb Reference: http://<Site>/_vti_bin/Authentication.asmx

Syntax

'Declaração
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/Login", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
PublicFunctionLogin ( _
    usernameAsString, _
    passwordAsString _
) AsLoginResult
'Uso
DiminstanceAsAuthenticationDimusernameAsStringDimpasswordAsStringDimreturnValueAsLoginResultreturnValue = instance.Login(username, password)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/Login", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
publicLoginResultLogin (
    stringusername,
    stringpassword
)

Parameters

  • username
    O usuário do nome de logon para o site do SharePoint.
  • password
    Senha de usuário do.

Return Value

Uma LoginResult estrutura que contém a um código de erro em seu campo ErrorCode ou o nome de um cookie em sua propriedade CookieName autenticação.

Remarks

The Login method uses the authentication services provided by the Membership and FormsAuthentication classes that are provided in Microsoft ASP.NET 2.0.

O cookie contém um tíquete autenticação que será usado para autenticar solicitações subseqüentes para o servidor.

Você precisará impor restrições na senha, such as que exija senhas para incluir um numeral ou punctuation Mark ou nome de usuário tamanho ou formato. Nesse caso, você deve fornecer sua própria validação lógica antes de passar a nome de usuário e senha para o método Login.Por motivos desempenho, essa etapa validação deve ser executada localmente nos computadores cliente.

See Also

Reference

Authentication Class
Authentication Members
Authentication Web Service
Membership
FormsAuthentication

Concepts

A autorização e autenticação