IPreparedStatement Интерфейс

Определение

Пространство имен:: Java.Sql

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Объект, представляющий предварительно скомпилированную инструкцию SQL.

[Android.Runtime.Register("java/sql/PreparedStatement", "", "Java.Sql.IPreparedStatementInvoker")]
public interface IPreparedStatement : IDisposable, Java.Interop.IJavaPeerable, Java.Sql.IStatement

[<Android.Runtime.Register("java/sql/PreparedStatement", "", "Java.Sql.IPreparedStatementInvoker")>]
type IPreparedStatement = interface
    interface IStatement
    interface IWrapper
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Производный: Java.Sql.ICallableStatement

Атрибуты: RegisterAttribute

Реализации: IJavaObject IJavaPeerable IStatement IWrapper IDisposable

Инструкция SQL предварительно компилируется и хранится в объекте PreparedStatement . Затем этот объект можно использовать для эффективного выполнения этой инструкции несколько раз.

<Примечание B.</B>> Методы задания (setShortи setStringт. д.) для задания значений параметров IN должны указывать типы, совместимые с определенным типом SQL входного параметра. Например, если параметр IN имеет тип INTEGERSQL, то следует использовать метод setInt .

Если требуются произвольные преобразования типов параметров, метод setObject должен использоваться с целевым типом SQL.

В следующем примере настройки параметра con представляет активное подключение:

PreparedStatement pstmt = con.prepareStatement("UPDATE EMPLOYEES
                                                SET SALARY = ? WHERE ID = ?");
              pstmt.setBigDecimal(1, 153833.00)
              pstmt.setInt(2, 110592)

Java документации по java.sql.PreparedStatement.

Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".

Поля

Имя	Описание
CloseAllResults	Константы, указывающие, что все `ResultSet` объекты, которые ранее были открыты, должны быть закрыты при вызове `getMoreResults`. (Унаследовано от IStatement)
CloseCurrentResult	Константы, указывающие, что текущий `ResultSet` объект должен быть закрыт при вызове `getMoreResults`. (Унаследовано от IStatement)
ExecuteFailed	Константа, указывающая, что при выполнении пакетной инструкции произошла ошибка. (Унаследовано от IStatement)
KeepCurrentResult	Константы, указывающие, что текущий `ResultSet` объект не должен быть закрыт при вызове `getMoreResults`. (Унаследовано от IStatement)
NoGeneratedKeys	Константы, указывающие, что созданные ключи не должны быть доступны для извлечения. (Унаследовано от IStatement)
ReturnGeneratedKeys	Константы, указывающие, что созданные ключи должны быть доступны для извлечения. (Унаследовано от IStatement)
SuccessNoInfo	Константы, указывающие, что инструкция пакетной службы выполнена успешно, но количество затронутых строк недоступно. (Унаследовано от IStatement)

Свойства

Имя	Описание
Connection	`Connection` Возвращает объект, который создал эту инструкцию. (Унаследовано от IStatement)
FetchDirection	Возвращает направление по умолчанию для получения строк для `ResultSet`созданных из этой инструкции строк. (Унаследовано от IStatement)
FetchSize	Возвращает число строк по умолчанию для `ResultSet` получения объектов, возвращаемых из этой инструкции. (Унаследовано от IStatement)
GeneratedKeys	Возвращает автоматически созданные ключи, созданные путем выполнения этой инструкции. (Унаследовано от IStatement)
Handle	Возвращает значение JNI базового объекта Android. (Унаследовано от IJavaObject)
IsClosed	Возвращает значение true, если эта инструкция закрыта, значение false в противном случае. (Унаследовано от IStatement)
JniIdentityHashCode	Возвращает значение `java.lang.System.identityHashCode()` для упаковаемого экземпляра. (Унаследовано от IJavaPeerable)
JniManagedPeerState	Состояние управляемого однорангового узла. (Унаследовано от IJavaPeerable)
JniPeerMembers	Поддержка доступа к членам и вызовов. (Унаследовано от IJavaPeerable)
MaxFieldSize	Возвращает максимальное количество байтов, которые можно возвращать в виде значений из столбцов символов и двоичных типов в производном `ResultSet` из этой инструкции. (Унаследовано от IStatement)
MaxRows	Возвращает максимальное количество строк, которые `ResultSet` могут содержаться при создании из этой инструкции. (Унаследовано от IStatement)
MetaData	`ResultSetMetaData` Возвращает описание`ResultSet`, которое будет производиться при выполнении `PreparedStatement`объекта .
MoreResults	Переходит к следующему результату этой инструкции. (Унаследовано от IStatement)
ParameterMetaData	Возвращает сведения о параметрах объекта `PreparedStatement`.
PeerReference	JniObjectReference Возвращает экземпляр объекта в оболочке Java. (Унаследовано от IJavaPeerable)
Poolable	Возвращает значение true, если эта инструкция является пулом, значение false в противном случае. (Унаследовано от IStatement)
QueryTimeout	Возвращает значение времени ожидания для времени выполнения инструкции. (Унаследовано от IStatement)
ResultSet	Возвращает текущий результат. (Унаследовано от IStatement)
ResultSetConcurrency	Возвращает параметр параллелизма для `ResultSet` объектов, созданных этим оператором. (Унаследовано от IStatement)
ResultSetHoldability	Возвращает параметр удержания курсора для `ResultSet` объектов, созданных этим оператором. (Унаследовано от IStatement)
ResultSetType	`ResultSet` Возвращает параметр типа для `ResultSet`производных от этой инструкции. (Унаследовано от IStatement)
UpdateCount	Возвращает число обновлений для текущего результата, если оно не `ResultSet`является. (Унаследовано от IStatement)
Warnings	Извлекает первое `SQLWarning` сообщение по вызовам этой инструкции. (Унаследовано от IStatement)

Методы

Имя	Описание
AddBatch()	Добавляет набор параметров в пакет команд этого `PreparedStatement` объекта.
AddBatch(String)	Добавляет указанную команду SQL в текущий список commmands для этого `Statement` объекта. (Унаследовано от IStatement)
Cancel()	Отменяет этот `Statement` объект, если СУБД и драйвер поддерживают прерывание инструкции SQL. (Унаследовано от IStatement)
ClearBatch()	Очищает текущий список команд SQL этого `Statement` объекта. (Унаследовано от IStatement)
ClearParameters()	Немедленно удаляет текущие значения параметров.
ClearWarnings()	Очищает все предупреждения, сообщаемые об этом `Statement` объекте. (Унаследовано от IStatement)
Close()	Освобождает базу данных этого `Statement` объекта и ресурсы JDBC сразу же, а не ожидая, когда она будет автоматически закрыта. (Унаследовано от IStatement)
Disposed()	Вызывается при удалении экземпляра. (Унаследовано от IJavaPeerable)
DisposeUnlessReferenced()	Если нет невыполненных ссылок на этот экземпляр, то вызывается `Dispose()`; в противном случае ничего не делает. (Унаследовано от IJavaPeerable)
Execute()	Выполняет инструкцию SQL в этом `PreparedStatement` объекте, которая может быть любой инструкцией SQL.
Execute(String, Int32)	Выполняет указанную инструкцию SQL, которая может возвращать несколько результатов и сообщает драйверу, что все автоматически созданные ключи должны быть доступны для извлечения. (Унаследовано от IStatement)
Execute(String, Int32[])	Выполняет указанную инструкцию SQL, которая может возвращать несколько результатов и сигнализирует драйверу о том, что автоматически созданные ключи, указанные в данном массиве, должны быть доступны для получения. (Унаследовано от IStatement)
Execute(String, String[])	Выполняет указанную инструкцию SQL, которая может возвращать несколько результатов и сигнализирует драйверу о том, что автоматически созданные ключи, указанные в данном массиве, должны быть доступны для получения. (Унаследовано от IStatement)
Execute(String)	Выполняет указанную инструкцию SQL, которая может возвращать несколько результатов. (Унаследовано от IStatement)
ExecuteBatch()	Отправляет пакет команд в базу данных для выполнения, а если все команды выполняются успешно, возвращает массив счетчиков обновлений. (Унаследовано от IStatement)
ExecuteQuery()	Выполняет SQL-запрос в этом `PreparedStatement` объекте и возвращает `ResultSet` объект, созданный запросом.
ExecuteQuery(String)	Выполняет указанную инструкцию SQL, которая возвращает один `ResultSet` объект. (Унаследовано от IStatement)
ExecuteUpdate()	Выполняет инструкцию SQL в этом `PreparedStatement` объекте, которая должна быть инструкцией языка обработки данных SQL (DML), например `INSERTUPDATE` или `DELETE`инструкцией SQL, возвращающей ничего, например инструкцию DDL.
ExecuteUpdate(String, Int32)	Выполняет указанную инструкцию SQL и сообщает драйверу с заданным флагом о том, должны ли автоматически созданные этим `Statement` объектом ключи быть доступны для извлечения. (Унаследовано от IStatement)
ExecuteUpdate(String, Int32[])	Выполняет указанную инструкцию SQL и сообщает драйверу, что автоматически созданные ключи, указанные в указанном массиве, должны быть доступны для получения. (Унаследовано от IStatement)
ExecuteUpdate(String, String[])	Выполняет указанную инструкцию SQL и сообщает драйверу, что автоматически созданные ключи, указанные в указанном массиве, должны быть доступны для получения. (Унаследовано от IStatement)
ExecuteUpdate(String)	Выполняет указанную инструкцию SQL, которая может быть `INSERT`инструкцией , `UPDATE`или `DELETE` инструкцией SQL, которая не возвращает ничего, например инструкцию DDL SQL. (Унаследовано от IStatement)
Finalized()	Вызывается при завершении экземпляра. (Унаследовано от IJavaPeerable)
GetMoreResults(Int32)	Перемещается к следующему результату этого `Statement` объекта, обрабатывает все текущие `ResultSet` объекты в соответствии с инструкциями, указанными заданным заданным флагом, и возвращается `true` , если следующий результат является `ResultSet` объектом. (Унаследовано от IStatement)
IsWrapperFor(Class)	Возвращает значение true, если это либо реализует аргумент интерфейса, либо напрямую или косвенно является оболочкой для объекта, который делает. (Унаследовано от IWrapper)
SetArray(Int32, IArray)	Задает указанный параметр заданному `java.sql.Array` объекту.
SetAsciiStream(Int32, Stream, Int32)	Задает указанный параметр заданному входной потоку, который будет иметь указанное количество байтов.
SetAsciiStream(Int32, Stream, Int64)	Задает указанный параметр заданному входной потоку, который будет иметь указанное количество байтов.
SetAsciiStream(Int32, Stream)	Устанавливает для указанного параметра заданное значение входного потока.
SetBigDecimal(Int32, BigDecimal)	Задает указанный параметр заданному `java.math.BigDecimal` значению.
SetBinaryStream(Int32, Stream, Int32)	Задает указанный параметр заданному входной потоку, который будет иметь указанное количество байтов.
SetBinaryStream(Int32, Stream, Int64)	Задает указанный параметр заданному входной потоку, который будет иметь указанное количество байтов.
SetBinaryStream(Int32, Stream)	Устанавливает для указанного параметра заданное значение входного потока.
SetBlob(Int32, IBlob)	Задает указанный параметр заданному `java.sql.Blob` объекту.
SetBlob(Int32, Stream, Int64)	Задает назначенный параметр объекту `InputStream` .
SetBlob(Int32, Stream)	Задает назначенный параметр объекту `InputStream` .
SetBoolean(Int32, Boolean)	Задает указанный параметр заданному значению Java`boolean`.
SetByte(Int32, SByte)	Задает указанный параметр заданному значению Java`byte`.
SetBytes(Int32, Byte[])	Задает назначенный параметр заданному Java массиву байтов.
SetCharacterStream(Int32, Reader, Int32)	Задает назначенный параметр заданному `Reader` объекту, который является заданным числом символов.
SetCharacterStream(Int32, Reader, Int64)	Задает назначенный параметр заданному `Reader` объекту, который является заданным числом символов.
SetCharacterStream(Int32, Reader)	Задает указанный параметр заданному `Reader` объекту.
SetClob(Int32, IClob)	Задает указанный параметр заданному `java.sql.Clob` объекту.
SetClob(Int32, Reader, Int64)	Задает назначенный параметр объекту `Reader` .
SetClob(Int32, Reader)	Задает назначенный параметр объекту `Reader` .
SetCursorName(String)	Задает заданное имя `String`курсора SQL, которое будет использоваться последующими `Statement` методами объекта `execute` . (Унаследовано от IStatement)
SetDate(Int32, Date, Calendar)	Задает указанный параметр заданному `java.sql.Date` значению, используя заданный `Calendar` объект.
SetDate(Int32, Date)	Задает указанный параметр заданному `java.sql.Date` значению с помощью часового пояса по умолчанию виртуальной машины, работающей в приложении.
SetDouble(Int32, Double)	Задает указанный параметр заданному значению Java`double`.
SetEscapeProcessing(Boolean)	Задает escape-обработку включено или выключение. (Унаследовано от IStatement)
SetFloat(Int32, Single)	Задает указанный параметр заданному значению Java`float`.
SetInt(Int32, Int32)	Задает указанный параметр заданному значению Java`int`.
SetJniIdentityHashCode(Int32)	Задайте значение, возвращаемое `JniIdentityHashCode`. (Унаследовано от IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Объект, представляющий предварительно скомпилированную инструкцию SQL. (Унаследовано от IJavaPeerable)
SetLong(Int32, Int64)	Задает указанный параметр заданному значению Java`long`.
SetNCharacterStream(Int32, Reader, Int64)	Задает назначенный параметр объекту `Reader` .
SetNCharacterStream(Int32, Reader)	Задает назначенный параметр объекту `Reader` .
SetNClob(Int32, INClob)	Задает назначенный параметр объекту `java.sql.NClob` .
SetNClob(Int32, Reader, Int64)	Задает назначенный параметр объекту `Reader` .
SetNClob(Int32, Reader)	Задает назначенный параметр объекту `Reader` .
SetNString(Int32, String)	Задает назначенный параметр для заданного `String` объекта.
SetNull(Int32, Int32, String)	Задает назначенный параметр SQL `NULL`.
SetNull(Int32, Int32)	Задает назначенный параметр SQL `NULL`.
SetObject(Int32, Object, Int32, Int32)	Задает значение указанного параметра с заданным объектом.
SetObject(Int32, Object, Int32)	Задает значение указанного параметра с заданным объектом.
SetObject(Int32, Object)	Устанавливает значение указанного параметра с помощью заданного объекта.
SetPeerReference(JniObjectReference)	Задайте значение, возвращаемое `PeerReference`. (Унаследовано от IJavaPeerable)
SetRef(Int32, IRef)	Задает указанный параметр заданному `REF(<structured-type>)` значению.
SetRowId(Int32, IRowId)	Задает указанный параметр заданному `java.sql.RowId` объекту.
SetShort(Int32, Int16)	Задает указанный параметр заданному значению Java`short`.
SetSQLXML(Int32, ISQLXML)	Задает указанный параметр заданному `java.sql.SQLXML` объекту.
SetString(Int32, String)	Задает указанный параметр заданному значению Java`String`.
SetTime(Int32, Time, Calendar)	Задает указанный параметр заданному `java.sql.Time` значению, используя заданный `Calendar` объект.
SetTime(Int32, Time)	Задает указанный параметр заданному `java.sql.Time` значению.
SetTimestamp(Int32, Timestamp, Calendar)	Задает указанный параметр заданному `java.sql.Timestamp` значению, используя заданный `Calendar` объект.
SetTimestamp(Int32, Timestamp)	Задает указанный параметр заданному `java.sql.Timestamp` значению.
SetUnicodeStream(Int32, Stream, Int32)	Устаревшие. Задает указанный параметр заданному входной потоку, который будет иметь указанное количество байтов.
SetURL(Int32, URL)	Задает указанный параметр заданному `java.net.URL` значению.
UnregisterFromRuntime()	Отмените регистрацию этого экземпляра, чтобы среда выполнения не возвращала ее из будущих Java.Interop.JniRuntime+JniValueManager.PeekValue вызовов. (Унаследовано от IJavaPeerable)
Unwrap(Class)	Возвращает объект, реализующий заданный интерфейс, чтобы разрешить доступ к нестандартным методам или стандартным методам, не предоставляемым прокси-сервером. (Унаследовано от IWrapper)

Методы расширения

Имя	Описание
GetJniTypeName(IJavaPeerable)	Возвращает имя JNI типа экземпляра `self`.
JavaAs<TResult>(IJavaPeerable)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.
JavaCast<TResult>(IJavaObject)	Выполняет преобразование типа, проверяемого средой выполнения Android.
JavaCast<TResult>(IJavaObject)	Объект, представляющий предварительно скомпилированную инструкцию SQL.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Попробуйте принуждать к типу`self`, проверяя`TResult`, является ли приведение допустимым на стороне Java.

Применяется к