Método DataObjectIdentifierResolver.ExpandIdentifier

Artigo
10/26/2012

Expandir um identificador para um objeto de dados com o tipo especificado e identificador parcialmente completo e um indicando se alguma expansã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 ExpandIdentifier ( _
    typeName As String, _
    partialIdentifier As Object(), _
    refresh As Boolean _
) As Object()

public virtual Object[] ExpandIdentifier(
    string typeName,
    Object[] partialIdentifier,
    bool refresh
)

public:
virtual array<Object^>^ ExpandIdentifier(
    String^ typeName, 
    array<Object^>^ partialIdentifier, 
    bool refresh
)

abstract ExpandIdentifier : 
        typeName:string * 
        partialIdentifier:Object[] * 
        refresh:bool -> Object[] 
override ExpandIdentifier : 
        typeName:string * 
        partialIdentifier:Object[] * 
        refresh:bool -> Object[]

public function ExpandIdentifier(
    typeName : String, 
    partialIdentifier : Object[], 
    refresh : boolean
) : Object[]

Parâmetros

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

partialIdentifier
Tipo: array<System.Object[]
Um identificador parcial de um objeto de dados.

refresh
Tipo: System.Boolean
Um indicando se alguma expansão armazenada em cache deve ser atualizada.

Valor de retorno

Tipo: array<System.Object[]
Retorna o identificador completo, expandido do objeto de dados correspondente o identificador parcial passado, ou nulluma referência nula (Nothing no Visual Basic) se o identificador não pode ser expandido.

Exceções

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

Comentários

Use este método para simular como a fonte de dados se expande identificadores.Portanto, espera-se que o método usará o mesmo mecanismo de resolução da fonte de dados.Se o identificador de entrada representa um objeto real na fonte de dados, espera-se que este método localiza o objeto.Se não representa um objeto (isto é, se é um identificador de um objeto à-estar- criado), então espera-se que o método se concluirá o identificador da mesma forma que a fonte de dados para tal objeto.Por exemplo, se uma fonte de dados resolve os autores “em “CRIAM autores de TABELA a “pubs.dbo.authors”, então esse método deve fazer o mesmo.

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 não poderia substituir esse método diretamente.A implementação base faz chamadas em QuickExpandIdentifier e possivelmente no método de SlowExpandIdentifier , 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.