IConnection Interface

Referência

Definição

Namespace:: Java.Sql

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Uma conexão (sessão) com um banco de dados específico.

[Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")]
public interface IConnection : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IWrapper

[<Android.Runtime.Register("java/sql/Connection", "", "Java.Sql.IConnectionInvoker")>]
type IConnection = interface
    interface IWrapper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Atributos: RegisterAttribute

Implementações: IJavaObject IJavaPeerable IWrapper IDisposable

Comentários

Uma conexão (sessão) com um banco de dados específico. As instruções SQL são executadas e os resultados são retornados no contexto de uma conexão.

O banco de dados de um Connection objeto é capaz de fornecer informações descrevendo suas tabelas, sua gramática SQL com suporte, seus procedimentos armazenados, os recursos dessa conexão e assim por diante. Essas informações são obtidas com o getMetaData método.

<Nota B>:</B> Ao configurar um Connection, os aplicativos JDBC devem usar o método apropriado Connection , como setAutoCommit ou setTransactionIsolation. Os aplicativos não devem invocar comandos SQL diretamente para alterar a configuração da conexão quando houver um método JDBC disponível. Por padrão, um Connection objeto está no modo de confirmação automática, o que significa que ele confirma automaticamente as alterações após a execução de cada instrução. Se o modo de confirmação automática tiver sido desabilitado, o método commit deverá ser chamado explicitamente para confirmar as alterações, caso contrário, as alterações no banco de dados não serão salvas.

Um novo Connection objeto criado usando a API principal do JDBC 2.1 tem um mapa de tipo inicialmente vazio associado a ele. Um usuário pode inserir um mapeamento personalizado para um UDT nesse mapa de tipo. Quando um UDT é recuperado de uma fonte de dados com o método ResultSet.getObject, o getObject método verificará o mapa de tipo da conexão para ver se há uma entrada para esse UDT. Em caso afirmativo, o getObject método mapeará o UDT para a classe indicada. Se não houver entrada, o UDT será mapeado usando o mapeamento padrão.

Um usuário pode criar um novo mapa de tipo, que é um java.util.Map objeto, fazer uma entrada nele e passá-lo para os métodos que podem executar o java.sql mapeamento personalizado. Nesse caso, o método usará o mapa de tipo fornecido em vez daquele associado à conexão.

Por exemplo, o fragmento de código a seguir especifica que o tipo ATHLETES SQL será mapeado para a classe Athletes na linguagem de programação Java. O fragmento de código recupera o mapa de tipos para o Connection objeto con, insere a entrada nele e, em seguida, define o mapa de tipo com a nova entrada como o mapa de tipo da conexão.

java.util.Map map = con.getTypeMap();
                 map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
                 con.setTypeMap(map);

Documentação Java para java.sql.Connection.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Campos

TransactionNone	Uma constante indicando que as transações não são suportadas.
TransactionReadCommitted	Uma constante indicando que leituras sujas são evitadas; Leituras não repetíveis e leituras fantasmas podem ocorrer.
TransactionReadUncommitted	Uma constante indicando que leituras sujas, leituras não repetíveis e leituras fantasmas podem ocorrer.
TransactionRepeatableRead	Uma constante indicando que leituras sujas e leituras não repetíveis são evitadas; leituras fantasmas podem ocorrer.
TransactionSerializable	Uma constante que indica que leituras sujas, leituras não repetíveis e leituras fantasmas são evitadas.

Propriedades

AutoCommit	Retorna uma `boolean` indicação se essa conexão está ou não no `auto-commit` modo de operação.
Catalog	Obtém o nome de catálogo atual deste `Connection` objeto.
ClientInfo	Retorna um Properties objeto que contém todas as propriedades de informações do cliente.
Handle	Obtém o valor JNI do objeto Android subjacente. (Herdado de IJavaObject)
Holdability	Retorna a propriedade de retenção que qualquer `ResultSet` produzido por essa instância terá.
IsClosed	Retorna uma `boolean` indicação se essa conexão está ou não no `closed` estado.
JniIdentityHashCode	Retorna o valor de `java.lang.System.identityHashCode()` para a instância encapsulada. (Herdado de IJavaPeerable)
JniManagedPeerState	Estado do par gerenciado. (Herdado de IJavaPeerable)
JniPeerMembers	Acesso de membros e suporte à invocação. (Herdado de IJavaPeerable)
MetaData	Obtém os metadados sobre o banco de dados referenciado por essa conexão.
PeerReference	Retorna uma JniObjectReference das instâncias do objeto Java encapsulado. (Herdado de IJavaPeerable)
ReadOnly	Retorna uma `boolean` indicação se essa conexão está ou não no `read-only` estado no momento.
TransactionIsolation	Retorna o nível de isolamento de transação para essa conexão.
TypeMap	Retorna o mapeamento de tipo associado a esse `Connection` objeto.
Warnings	Obtém a primeira instância de quaisquer `SQLWarning` objetos que possam ter sido criados no uso dessa conexão.

Métodos

ClearWarnings()	Limpa todos os avisos relatados para este `Connection` objeto.
Close()	Libera `Connection` o banco de dados e os recursos JDBC desse objeto imediatamente em vez de esperar que eles sejam liberados automaticamente.
Commit()	Torna permanentes todas as alterações feitas desde a confirmação/reversão anterior e libera todos os bloqueios de banco de dados atualmente mantidos por esse `Connection` objeto.
CreateArrayOf(String, Object[])	Método de fábrica para criar objetos Array.
CreateBlob()	Constrói um objeto que implementa a `Blob` interface.
CreateClob()	Constrói um objeto que implementa a `Clob` interface.
CreateNClob()	Constrói um objeto que implementa a `NClob` interface.
CreateSQLXML()	Constrói um objeto que implementa a `SQLXML` interface.
CreateStatement()	Cria um `Statement` objeto para enviar instruções SQL para o banco de dados.
CreateStatement(Int32, Int32)	Cria um `Statement` objeto que gerará `ResultSet` objetos com o tipo e a simultaneidade determinados.
CreateStatement(Int32, Int32, Int32)	Cria um `Statement` objeto que gerará `ResultSet` objetos com o determinado tipo, simultaneidade e capacidade de retenção.
CreateStruct(String, Object[])	Método de fábrica para criar objetos Struct.
Disposed()	Chamado quando a instância tiver sido descartada. (Herdado de IJavaPeerable)
DisposeUnlessReferenced()	Se não houver referências pendentes a este caso, então chame `Dispose()`, caso contrário, não faz nada. (Herdado de IJavaPeerable)
Finalized()	Chamado quando a instância tiver sido finalizada. (Herdado de IJavaPeerable)
GetClientInfo(String)	Retorna o valor da propriedade de informações do cliente especificada pelo nome.
IsValid(Int32)	Retorna true se a conexão não tiver sido fechada e ainda for válida.
IsWrapperFor(Class)	Retorna true se isso implementa o argumento de interface ou é direta ou indiretamente um wrapper para um objeto que o faz. (Herdado de IWrapper)
NativeSQL(String)	Converte a instrução SQL fornecida na gramática SQL nativa do sistema.
PrepareCall(String)	Cria um `CallableStatement` objeto para chamar procedimentos armazenados de banco de dados.
PrepareCall(String, Int32, Int32)	Cria um `CallableStatement` objeto que gerará `ResultSet` objetos com o tipo e a simultaneidade determinados.
PrepareCall(String, Int32, Int32, Int32)	Cria um `CallableStatement` objeto que gerará `ResultSet` objetos com o tipo e a simultaneidade determinados.
PrepareStatement(String)	Cria um `PreparedStatement` objeto para enviar instruções SQL parametrizadas para o banco de dados.
PrepareStatement(String, Int32)	Cria um objeto padrão `PreparedStatement` que tem a capacidade de recuperar chaves geradas automaticamente.
PrepareStatement(String, Int32, Int32)	Cria um `PreparedStatement` objeto que gerará `ResultSet` objetos com o tipo e a simultaneidade determinados.
PrepareStatement(String, Int32, Int32, Int32)	Cria um `PreparedStatement` objeto que gerará `ResultSet` objetos com o determinado tipo, simultaneidade e capacidade de retenção.
PrepareStatement(String, Int32[])	Cria um objeto padrão `PreparedStatement` capaz de retornar as chaves geradas automaticamente designadas pela matriz fornecida.
PrepareStatement(String, String[])	Cria um objeto padrão `PreparedStatement` capaz de retornar as chaves geradas automaticamente designadas pela matriz fornecida.
ReleaseSavepoint(ISavepoint)	Remove os objetos especificados `Savepoint` e subsequentes `Savepoint` da transação atual.
Rollback()	Desfaz todas as alterações feitas na transação atual e libera todos os bloqueios de banco de dados atualmente mantidos por esse `Connection` objeto.
Rollback(ISavepoint)	Desfaz todas as alterações feitas depois que o `Savepoint` determinado objeto foi definido.
SetClientInfo(String, String)	Define o valor da propriedade de informações do cliente especificada por nome como o valor especificado por valor.
SetJniIdentityHashCode(Int32)	Defina o valor retornado por `JniIdentityHashCode`. (Herdado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Uma conexão (sessão) com um banco de dados específico. (Herdado de IJavaPeerable)
SetPeerReference(JniObjectReference)	Defina o valor retornado por `PeerReference`. (Herdado de IJavaPeerable)
SetSavepoint()	Cria um savepoint sem nome na transação atual e retorna o novo `Savepoint` objeto que o representa.
SetSavepoint(String)	Cria um savepoint com o nome fornecido na transação atual e retorna o novo `Savepoint` objeto que o representa.
UnregisterFromRuntime()	Cancele o registro dessa instância para que o tempo de execução não a retorne de chamadas futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Herdado de IJavaPeerable)
Unwrap(Class)	Retorna um objeto que implementa a interface fornecida para permitir o acesso a métodos não padrão ou métodos padrão não expostos pelo proxy. (Herdado de IWrapper)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo verificada em tempo de execução do Android.
JavaCast<TResult>(IJavaObject)	Uma conexão (sessão) com um banco de dados específico.
GetJniTypeName(IJavaPeerable)	Uma conexão (sessão) com um banco de dados específico.

Aplica-se a