Método DataConnection.GetExclusiveAccessProxy
Recupera uma instância de proxy que permite ao chamador acesso exclusivo a conexão de dados.
Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)
Sintaxe
'Declaração
Public MustOverride Function GetExclusiveAccessProxy ( _
lockTimeout As Integer _
) As DataConnection
public abstract DataConnection GetExclusiveAccessProxy(
int lockTimeout
)
public:
virtual DataConnection^ GetExclusiveAccessProxy(
int lockTimeout
) abstract
abstract GetExclusiveAccessProxy :
lockTimeout:int -> DataConnection
public abstract function GetExclusiveAccessProxy(
lockTimeout : int
) : DataConnection
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: Microsoft.VisualStudio.Data.DataConnection
Retorna uma instância do objeto de DataConnection proxy que permite ao chamador acesso exclusivo a conexão, ou retorna nulluma referência nula (Nothing no Visual Basic) se o tempo limite de bloqueio foi atingido e a conexão não pode ser bloqueada.
Exceções
| Exceção | Condição |
|---|---|
| InvalidOperationException | Este objeto é um proxy exclusivo de acesso que ainda não tenha acesso exclusivo. |
Comentários
Normalmente, bloquear de conexão ocorre em uma base por segmento, garantindo que vários segmentos não possam interagir com a conexão de dados ao mesmo tempo.Em o entanto, em alguns casos isso não é um mecanismo adequado de bloqueio para o cliente, como quando um cliente desejar executar uma operação bloqueado usando uma única conexão que abrange vários segmentos.Em esses casos, um cliente pode chamar esse método para recuperar uma instância do não bloqueio de conexão que podem então executar seu próprio acesso serializado.
O objeto retornado por esse método é uma nova instância da classe de DataConnection que tem um atributo especial permitindo que apenas as chamadas através de esta instância sucedam.Chamadas com todas as outras referências para o objeto de DataConnection de original são bloqueados então até que o método seja chamado de ReleaseExclusiveAccessProxy o proxy exclusivo de acesso.
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.