Método DataObjectIdentifierResolver.ContractIdentifier

Artigo
10/26/2012

Reduz um identificador para um objeto de dados com o tipo especificado e identificador completo e um indicando se qualquer contração armazenada em cache deve ser atualizada.

Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)

Sintaxe

'Declaração
Public Overridable Function ContractIdentifier ( _
    typeName As String, _
    fullIdentifier As Object(), _
    refresh As Boolean _
) As Object()

public virtual Object[] ContractIdentifier(
    string typeName,
    Object[] fullIdentifier,
    bool refresh
)

public:
virtual array<Object^>^ ContractIdentifier(
    String^ typeName, 
    array<Object^>^ fullIdentifier, 
    bool refresh
)

abstract ContractIdentifier : 
        typeName:string * 
        fullIdentifier:Object[] * 
        refresh:bool -> Object[] 
override ContractIdentifier : 
        typeName:string * 
        fullIdentifier:Object[] * 
        refresh:bool -> Object[]

public function ContractIdentifier(
    typeName : String, 
    fullIdentifier : Object[], 
    refresh : boolean
) : Object[]

Parâmetros

typeName
Tipo: System.String
o nome de um tipo de objeto de dados.

fullIdentifier
Tipo: array<System.Object[]
Um identificador completo de um objeto de dados.

refresh
Tipo: System.Boolean
Um indicando se qualquer contração armazenada em cache deve ser atualizada.

Valor de retorno

Tipo: array<System.Object[]
Retorna o identificador exclusivo parcial, reduzido para um objeto de dados.

Exceções

Exceção	Condição
ArgumentNullException	O parâmetro de typeName é zero.

Comentários

Use este método para colocar um identificador completo e para convertê-lo para o identificador possível que o menor que ainda identifica unicamente o objeto.Por exemplo no SQL Server, quando conectado como o do usuário para bares de banco de dados, um identificador completo “pubs.dbo.authors” pode ser reduzido a forma mais simples, “autores”.

O parâmetro de refresh indica se o método deve atualizar o cache para refletir o contexto atual da fonte de dados.Isso é provavelmente necessário se o contexto da fonte de dados for alterado durante o ciclo de vida de uma conexão.

Normalmente um provedor de dados não poderia substituir esse método diretamente.A implementação base faz chamadas em QuickContractIdentifier e possivelmente no método de SlowContractIdentifier, dependendo do estado do cache.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.