DataObjectIdentifierResolver.ExpandIdentifier (Método)

Artículo
05/17/2015

Expanda un identificador para un objeto de datos con el tipo especificado y completa parcialmente el identificador y una indicación si cualquier extensión 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 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: String

El nombre de un tipo de objeto de datos.

partialIdentifier
Tipo: array<Object[]

Un identificador parcial de un objeto de datos.

refresh
Tipo: Boolean

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

Valor devuelto

Tipo: array<Object[]
Devuelve el identificador completo, expandido del objeto de datos que coincide con el identificador parcial pasado, o nullreferencia null (Nothing en Visual Basic) si el identificador no puede expandir.

Excepciones

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

Comentarios

Utilice este método para simular cómo expanda el origen de datos los identificadores. Por consiguiente, se espera que el método utiliza el mismo mecanismo de resolución que el origen de datos. Si el identificador de entrada representa un objeto real en el origen de datos, se espera que este método encuentre ese objeto. Si no representa un objeto (es decir, si es un identificador de un objeto a-ser- creado), se espera que el método complete el identificador de la misma manera que el origen de datos para este tipo de objeto. Por ejemplo, si los autores de las soluciones del origen de datos en “CREATE a los autores de TABLE “a pubs.dbo.authors,” y este método debe hacer lo mismo.

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 no invalidaría normalmente este método directamente. La implementación base realiza llamadas en QuickExpandIdentifier y posiblemente el método de SlowExpandIdentifier , 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.