DbConnection.CloseAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fecha assíncronamente a ligação à base de dados.
public:
virtual System::Threading::Tasks::Task ^ CloseAsync();public virtual System.Threading.Tasks.Task CloseAsync();abstract member CloseAsync : unit -> System.Threading.Tasks.Task
override this.CloseAsync : unit -> System.Threading.Tasks.TaskPublic Overridable Function CloseAsync () As TaskDevoluções
A Task representa a operação assíncrona.
Observações
A implementação padrão deste método assíncrono delega ao seu equivalente síncrono e devolve um completo Task, potencialmente bloqueando o thread que chama.
Os fornecedores de dados que suportam programação assíncrona devem sobrepor a implementação padrão usando operações de I/O assíncronas.
Os Close métodos and CloseAsync revertem quaisquer transações pendentes. Depois, libertam a ligação ao pool de ligações, ou fecham a ligação se o pool de ligação estiver desativado.
Uma candidatura pode ligar Close ou CloseAsync mais do que uma vez. Não é gerada nenhuma exceção.
Se sair DbConnection do âmbito, não está fechado. Portanto, deve fechar explicitamente a ligação chamando Close ou Dispose, que são funcionalmente equivalentes. Se o valor Pooling do pool de ligação estiver definido para true ou yes, isto também liberta a ligação física.
Caution
Não feche ou descarte um DbConnection, um DbDataReader, ou qualquer outro objeto gerido no Finalize processo da sua turma. Num finalizador, só deves libertar recursos não geridos que a tua classe possua diretamente. Se sua classe não possui recursos não gerenciados, não inclua um Finalize método em sua definição de classe. Para obter mais informações, consulte Coleta de lixo.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Close().