IConnection.PrepareStatement Método

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.

Sobrecargas

Nome	Description
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[])	Cria um objeto padrão `PreparedStatement` capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada.
PrepareStatement(String, String[])	Cria um objeto padrão `PreparedStatement` capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada.
PrepareStatement(String, Int32, Int32)	Cria um `PreparedStatement` objeto que gerará `ResultSet` objetos com o tipo e simultaneidade fornecidos.
PrepareStatement(String, Int32, Int32, Int32)	Cria um `PreparedStatement` objeto que gerará `ResultSet` objetos com o tipo, simultaneidade e capacidade de retenção fornecidos.

PrepareStatement(String)

Cria um PreparedStatement objeto para enviar instruções SQL parametrizadas para o banco de dados.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

uma instrução SQL que pode conter um ou mais '?' Espaços reservados do parâmetro IN

Retornos

IPreparedStatement

um novo objeto padrão PreparedStatement que contém a instrução SQL pré-compilada

Atributos: RegisterAttribute

Exceções

SQLException

se houver um problema ao acessar o banco de dados.

Comentários

Cria um PreparedStatement objeto para enviar instruções SQL parametrizadas para o banco de dados.

Uma instrução SQL com ou sem parâmetros IN pode ser pré-compilada e armazenada em um PreparedStatement objeto. Esse objeto pode ser usado para executar essa instrução com eficiência várias vezes.

<Observação B>:</B> Esse método é otimizado para lidar com instruções SQL paramétricas que se beneficiam da pré-compilação. Se o driver der suporte à pré-compilação, o método prepareStatement enviará a instrução para o banco de dados para pré-compilação. Alguns drivers podem não dar suporte à pré-compilação. Nesse caso, a instrução pode não ser enviada ao banco de dados até que o PreparedStatement objeto seja executado. Isso não tem efeito direto sobre os usuários; no entanto, isso afeta quais métodos lançam determinados SQLException objetos.

Os conjuntos de resultados criados usando o objeto retornado PreparedStatement serão, por padrão, tipo TYPE_FORWARD_ONLY e terão um nível de simultaneidade de CONCUR_READ_ONLY. A retenção dos conjuntos de resultados criados pode ser determinada chamando #getHoldability.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String).

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

Aplica-se a

PrepareStatement(String, Int32)

Cria um objeto padrão PreparedStatement que tem a capacidade de recuperar chaves geradas automaticamente.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int autoGeneratedKeys);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

uma instrução SQL que pode conter um ou mais '?' Espaços reservados do parâmetro IN

autoGeneratedKeys: Int32

um sinalizador que indica se as chaves geradas automaticamente devem ser retornadas; um de Statement.RETURN_GENERATED_KEYS ou Statement.NO_GENERATED_KEYS

Retornos

IPreparedStatement

um novo PreparedStatement objeto, que contém a instrução SQL pré-compilada, que terá a capacidade de retornar chaves geradas automaticamente

Atributos: RegisterAttribute

Exceções

SQLException

se houver um problema ao acessar o banco de dados.

Comentários

Cria um objeto padrão PreparedStatement que tem a capacidade de recuperar chaves geradas automaticamente. A constante fornecida informa ao driver se ele deve disponibilizar chaves geradas automaticamente para recuperação. Esse parâmetro será ignorado se a instrução SQL não for uma instrução INSERT ou uma instrução SQL capaz de retornar chaves geradas automaticamente (a lista dessas instruções é específica do fornecedor).

Adicionado em 1.4.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String, int).

Aplica-se a

PrepareStatement(String, Int32[])

Cria um objeto padrão PreparedStatement capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int[]? columnIndexes);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[I)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int[] -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

uma instrução SQL que pode conter um ou mais '?' Espaços reservados do parâmetro IN

columnIndexes: Int32[]

uma matriz de índices de coluna que indica as colunas que devem ser retornadas das linhas ou linhas inseridas

Retornos

IPreparedStatement

um novo PreparedStatement objeto, que contém a instrução pré-compilada, que é capaz de retornar as chaves geradas automaticamente designadas pela matriz de índices de coluna fornecida

Atributos: RegisterAttribute

Exceções

SQLException

se ocorrer um problema ao acessar o banco de dados.

Comentários

Cria um objeto padrão PreparedStatement capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada. Essa matriz contém os índices das colunas na tabela de destino que contêm as chaves geradas automaticamente que devem ser disponibilizadas. O driver ignorará a matriz se a instrução SQL não for uma instrução INSERT ou uma instrução SQL capaz de retornar chaves geradas automaticamente (a lista dessas instruções é específica do fornecedor).

Adicionado em 1.4.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String, int[]).

Aplica-se a

PrepareStatement(String, String[])

Cria um objeto padrão PreparedStatement capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayLjava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, string[]? columnNames);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;[Ljava/lang/String;)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_arrayLjava_lang_String_Handler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * string[] -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

uma instrução SQL que pode conter um ou mais '?' Espaços reservados do parâmetro IN

columnNames: String[]

uma matriz de nomes de coluna que indica as colunas que devem ser retornadas da linha ou linhas inseridas

Retornos

IPreparedStatement

um novo PreparedStatement objeto, que contém a instrução pré-compilada, que é capaz de retornar as chaves geradas automaticamente designadas pela matriz de nomes de coluna fornecida

Atributos: RegisterAttribute

Exceções

SQLException

se ocorrer um problema ao acessar o banco de dados.

Comentários

Cria um objeto padrão PreparedStatement capaz de retornar as chaves geradas automaticamente designadas pela matriz determinada. Essa matriz contém os nomes das colunas na tabela de destino que contêm as chaves geradas automaticamente que devem ser retornadas. O driver ignorará a matriz se a instrução SQL não for uma instrução INSERT ou uma instrução SQL capaz de retornar chaves geradas automaticamente (a lista dessas instruções é específica do fornecedor).

Adicionado em 1.4.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String, java.lang.String[]).

Aplica-se a

PrepareStatement(String, Int32, Int32)

Cria um PreparedStatement objeto que gerará ResultSet objetos com o tipo e simultaneidade fornecidos.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;II)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int resultSetType, int resultSetConcurrency);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;II)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int * int -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

um String objeto que é a instrução SQL a ser enviada ao banco de dados; pode conter um ou mais '?' Parâmetros IN

resultSetType: Int32

um tipo de conjunto de resultados; um de ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVEou ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency: Int32

um tipo de simultaneidade; um de ResultSet.CONCUR_READ_ONLY ou ResultSet.CONCUR_UPDATABLE

Retornos

IPreparedStatement

um novo objeto PreparedStatement que contém a instrução SQL pré-compilada que produzirá ResultSet objetos com o tipo e simultaneidade fornecidos

Atributos: RegisterAttribute

Exceções

SQLException

se ocorrer um problema ao acessar o banco de dados.

Comentários

Cria um PreparedStatement objeto que gerará ResultSet objetos com o tipo e simultaneidade fornecidos. Esse método é o mesmo que o prepareStatement método acima, mas permite que o tipo de conjunto de resultados padrão e a simultaneidade sejam substituídos. A retenção dos conjuntos de resultados criados pode ser determinada chamando #getHoldability.

Adicionado em 1.2.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String, int, int).

Aplica-se a

PrepareStatement(String, Int32, Int32, Int32)

Cria um PreparedStatement objeto que gerará ResultSet objetos com o tipo, simultaneidade e capacidade de retenção fornecidos.

[Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;III)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Sql.IPreparedStatement? PrepareStatement(string? sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability);

[<Android.Runtime.Register("prepareStatement", "(Ljava/lang/String;III)Ljava/sql/PreparedStatement;", "GetPrepareStatement_Ljava_lang_String_IIIHandler:Java.Sql.IConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member PrepareStatement : string * int * int * int -> Java.Sql.IPreparedStatement

Parâmetros

sql: String

um String objeto que é a instrução SQL a ser enviada ao banco de dados; pode conter um ou mais '?' Parâmetros IN

resultSetType: Int32

uma das seguintes ResultSet constantes: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVEou ResultSet.TYPE_SCROLL_SENSITIVE

resultSetConcurrency: Int32

uma das seguintes ResultSet constantes: ResultSet.CONCUR_READ_ONLY ou ResultSet.CONCUR_UPDATABLE

resultSetHoldability: Int32

uma das seguintes ResultSet constantes: ResultSet.HOLD_CURSORS_OVER_COMMIT ou ResultSet.CLOSE_CURSORS_AT_COMMIT

Retornos

IPreparedStatement

um novo PreparedStatement objeto, que contém a instrução SQL pré-compilada, que gerará ResultSet objetos com o tipo, simultaneidade e capacidade de retenção fornecidos

Atributos: RegisterAttribute

Exceções

SQLException

se ocorrer um problema ao acessar o banco de dados.

Comentários

Cria um PreparedStatement objeto que gerará ResultSet objetos com o tipo, simultaneidade e capacidade de retenção fornecidos.

Esse método é o mesmo que o prepareStatement método acima, mas permite que o tipo de conjunto de resultados padrão, a simultaneidade e a capacidade de retenção sejam substituídos.

Adicionado em 1.4.

Documentação Java para java.sql.Connection.prepareStatement(java.lang.String, int, int, int).

Aplica-se a