Método Entity.CheckAccess

Artigo
09/26/2008

Obtém os direitos a atual usuário tem em um ou mais instâncias entidade.

Espaço para nome Microsoft.Office.Server.ApplicationRegistry.MetadataModel
Conjunto de Módulos (Assembly) Microsoft.SharePoint.Portal (em microsoft.sharepoint.portal.dll)

A sintaxe

Public Function CheckAccess ( _
    subIdentifierArrayArray As Object(), _
    lobSystemInstance As LobSystemInstance _
) As Long()

Dim instance As Entity
Dim subIdentifierArrayArray As Object()
Dim lobSystemInstance As LobSystemInstance
Dim returnValue As Long()

returnValue = instance.CheckAccess(subIdentifierArrayArray, lobSystemInstance)

public long[] CheckAccess (
    Object[] subIdentifierArrayArray,
    LobSystemInstance lobSystemInstance
)

Parâmetros

subIdentifierArrayArray
Uma coleção de uma coleção de sub-Identifiers, que representa uma coleção de EntityInstances dessa entidade.Cada elemento na parte superior nível coleção representa uma matriz de valores sub-Identifier para um único EntityInstance.De exemplo, se uma entidade tem apenas um identificador único, a matriz interna poderia conter somente um elemento.

Considere uma entidade do cliente que é identificada por um inteiro NúmeroCliente.Chamar CheckAccess no seguinte maneira:

long[] rights[] = CheckAccess(new Object[]{33}, new Object[]{3}

retornaria os direitos para EntityInstances do cliente com o ID 33 e 3.

lobSystemInstance
O objeto LobSystemInstance que esta entidade pertence.

Retornar valor

Um único número 'longo' para cada EntityInstance representado na entrada.A 'longa' representa os direitos de usuário de executar o método CheckAccess tem para o correspondente EntityInstance.Um direito pode ser um único bit ou uma coleção de bits na longa.

Comentários

O chamar CheckAccess funciona de maneira semelhante ao chamar método FindSpecific, em que o Business Data Catalog converte a chamar para um consulta SQL ou um chamada WebService WebMethod back-end mais complexo.A principal diferença é que o FIndSpecific funciona para retornar um único EntityInstance; o método CheckAccess retorna resultados (rights) para um ou mais de uma EntityInstance no mesmo chamar.

O chamar CheckAccess funciona invocando o MethodInstance na entidade que possui o MethodInstanceType 'AccessChecker'.O resultado de chamar o CheckAccess pode ser usado por aplicativos cliente Business dados.Por exemplo, considere a possibilidade uma compilação usuário um personalizado Web Part em de Business Data Catalog que exibe criar, editar e Delete Actions para um EntityInstance.Agora, definindo um AccessChecker, o usuário poderia chamar ENTITY.CheckAccess e, em seguida, condicionalmente habilitar um ou mais das ações dependendo quais direitos são retornados.

O método ENTITY.CheckAccess também é executado pela Business Data Catalog Security Trimmer cada tempo de Search Query Processor retorna resultados da pesquisa compatível a regra rastrear o trimmer Business Data Catalog de segurança é associado com.Quando o método ENTITY.CheckAccess é chamado, o Business Data Catalog por sua vez, executa o API back-end descrito pela instância método AccessChecker registrada para dessa entidade.O API back-end retorna os direitos a atual usuário tem na entidade instância ou Instâncias.Isso é retransmitido voltar para o método ENTITY.CheckAccess, e finalmente para trimmer de segurança, que usa este informações para aparar os resultados antes de exibir os resultados para o usuário.

Consulte também

Referência

Entity De classe
Entity Membros
Microsoft.Office.Server.ApplicationRegistry.MetadataModel De espaço para nome

Compartilhar via