Método DataConnection.GetLockedProviderObject (Int32)

Artigo
10/26/2012

Retorna o objeto do provedor de dados subjacentes, se houver, que oferece suporte a conexão de dados atual.

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

Sintaxe

'Declaração
Public MustOverride Function GetLockedProviderObject ( _
    lockTimeout As Integer _
) As Object

public abstract Object GetLockedProviderObject(
    int lockTimeout
)

public:
virtual Object^ GetLockedProviderObject(
    int lockTimeout
) abstract

abstract GetLockedProviderObject : 
        lockTimeout:int -> Object

public abstract function GetLockedProviderObject(
    lockTimeout : int
) : Object

Parâmetros

lockTimeout
Tipo: System.Int32
A quantidade de tempo, em segundos, para esperar em bloquear a conexão antes de retornar.

Valor de retorno

Tipo: System.Object
Retorna uma instância do objeto de GetLockedProviderObject , se houver, que suporte a conexão de dados atual, ou retorna nulluma referência nula (Nothing no Visual Basic) se o tempo limite de bloqueio foi atingido e o objeto do provedor não pôde ser bloqueado.

Exceções

Exceção	Condição
InvalidOperationException	Este objeto é um proxy exclusivo de acesso que ainda não tenha acesso exclusivo.

Comentários

Este método chama o método sobrecarregado de GetLockedProviderObject com um tempo limite (System.Threading.Timeout.Infinite) infinito.

Um cliente pode usar esse método quando são com muitos conhecimentos sobre o provedor e o desejo de dados subjacentes fazer chamadas diretamente ao seu API, ou por razões de desempenho ou porque há funcionalidade que DDEX não oferecem suporte nativo.

Um exemplo de um objeto do provedor seria uma instância de IDbConnection para um provedor de ADO.NET , ou um XmlDocument para um arquivo XML.

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.