DataObjectIdentifierResolver.ContractIdentifier (Método)

Artículo
05/17/2015

Contrata un identificador para un objeto de datos con el tipo especificado y completa el identificador y una indicación si cualquier retirar almacenada en memoria caché debe actualizarse.

Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)

Sintaxis

'Declaración
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: String

El nombre de un tipo de objeto de datos.

fullIdentifier
Tipo: array<Object[]

Un identificador completo de un objeto de datos.

refresh
Tipo: Boolean

Una indicación si cualquier retirar almacenada en memoria caché debe actualizarse.

Valor devuelto

Tipo: array<Object[]
Devuelve el identificador único parcial, contratante para un objeto de datos.

Excepciones

Excepción	Condición
ArgumentNullException	El parámetro typeName es null.

Comentarios

Utilice este método para realizar un identificador completo y para convertirlo en el identificador posible más pequeño que todavía identifica de forma única el objeto. Por ejemplo en SQL Server, cuando está conectado como usuario dbo con los pubs de base de datos, un identificador completo “pubs.dbo.authors” se puede contratar al formulario más simple, “autores”.

El parámetro de refresh indica si el método debe actualizar su caché para reflejar el contexto actual del origen de datos. Esto es probablemente necesario si cambia el contexto de origen de datos durante la duración de una conexión.

Un proveedor de datos no invalidaría normalmente este método directamente. La implementación base realiza llamadas en el QuickContractIdentifier y posiblemente el método de SlowContractIdentifier, dependiendo del estado de la memoria caché.

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.