IConnection.PrepareStatement Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
PrepareStatement(String) |
|
PrepareStatement(String, Int32) |
Создает объект по умолчанию |
PrepareStatement(String, Int32[]) |
Создает объект по умолчанию |
PrepareStatement(String, String[]) |
Создает объект по умолчанию |
PrepareStatement(String, Int32, Int32) |
Создает объект, который создаст |
PrepareStatement(String, Int32, Int32, Int32) |
Создает объект, который создаст |
PrepareStatement(String)
PreparedStatement
Создает объект для отправки параметризованных инструкций 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")]
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
Параметры
- sql
- String
Инструкция SQL, которая может содержать одну или несколько "?" Заполнители параметров IN
Возвращаемое значение
новый объект по умолчанию, содержащий предварительно скомпилированную инструкцию PreparedStatement
SQL
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
PreparedStatement
Создает объект для отправки параметризованных инструкций SQL в базу данных.
Инструкция SQL с параметрами IN или без нее может быть предварительно скомпилирована и сохранена в объекте PreparedStatement
. Затем этот объект можно использовать для эффективного выполнения этой инструкции несколько раз.
<Примечание B>.</B> Этот метод оптимизирован для обработки инструкций параметрического SQL, которые получают преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement
отправит инструкцию в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае инструкция может не отправляться в базу данных, пока PreparedStatement
объект не будет выполнен. Это не имеет прямого влияния на пользователей; однако это влияет на то, какие методы вызывают определенные SQLException
объекты.
Результирующие наборы, созданные с помощью возвращаемого PreparedStatement
объекта, по умолчанию будут иметь тип TYPE_FORWARD_ONLY
и уровень CONCUR_READ_ONLY
параллелизма. Удержание созданных результирующих наборов можно определить путем вызова #getHoldability
.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
PrepareStatement(String, Int32)
Создает объект по умолчанию PreparedStatement
, имеющий возможность получения автоматически созданных ключей.
[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
Параметры
- sql
- String
Инструкция SQL, которая может содержать одну или несколько "?" Заполнители параметров IN
- autoGeneratedKeys
- Int32
флаг, указывающий, следует ли возвращать автоматически созданные ключи; одно из Statement.RETURN_GENERATED_KEYS
или Statement.NO_GENERATED_KEYS
Возвращаемое значение
новый PreparedStatement
объект, содержащий предварительно скомпилированную инструкцию SQL, которая будет иметь возможность возвращать автоматически созданные ключи.
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
Создает объект по умолчанию PreparedStatement
, имеющий возможность получения автоматически созданных ключей. Указанная константа сообщает драйверу, должен ли он создавать автоматически созданные ключи для извлечения. Этот параметр игнорируется, если инструкция SQL не является оператором INSERT
, или инструкция SQL, способная возвращать автоматически созданные ключи (список таких инструкций зависит от поставщика).
<Примечание B>.</B> Этот метод оптимизирован для обработки инструкций параметрического SQL, которые получают преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement
отправит инструкцию в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае инструкция может не отправляться в базу данных, пока PreparedStatement
объект не будет выполнен. Это не имеет прямого влияния на пользователей; Однако это влияет на то, какие методы вызывают определенные экземпляры SQLExceptions.
Результирующие наборы, созданные с помощью возвращаемого PreparedStatement
объекта, по умолчанию будут иметь тип TYPE_FORWARD_ONLY
и уровень CONCUR_READ_ONLY
параллелизма. Удержание созданных результирующих наборов можно определить путем вызова #getHoldability
.
Добавлено в версии 1.4.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String, int)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
PrepareStatement(String, Int32[])
Создает объект по умолчанию PreparedStatement
, способный возвращать автоматически созданные ключи, назначенные заданным заданным массивом.
[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
Параметры
- sql
- String
Инструкция SQL, которая может содержать одну или несколько "?" Заполнители параметров IN
- columnIndexes
- Int32[]
массив индексов столбцов, указывающий столбцы, возвращаемые из вставленной строки или строк.
Возвращаемое значение
новый PreparedStatement
объект, содержащий предварительно скомпилированную инструкцию, которая может возвращать автоматически созданные ключи, назначенные заданным указанным массивом индексов столбцов.
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
Создает объект по умолчанию PreparedStatement
, способный возвращать автоматически созданные ключи, назначенные заданным заданным массивом. Этот массив содержит индексы столбцов в целевой таблице, которые содержат автоматически созданные ключи, которые должны быть доступны. Драйвер игнорирует массив, если инструкция SQL не является оператором INSERT
, или инструкция SQL, способная возвращать автоматически созданные ключи (список таких инструкций зависит от поставщика).
Инструкция SQL с параметрами IN или без нее может быть предварительно скомпилирована и сохранена в объекте PreparedStatement
. Затем этот объект можно использовать для эффективного выполнения этой инструкции несколько раз.
<Примечание B>.</B> Этот метод оптимизирован для обработки инструкций параметрического SQL, которые получают преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement
отправит инструкцию в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае инструкция может не отправляться в базу данных, пока PreparedStatement
объект не будет выполнен. Это не имеет прямого влияния на пользователей; Однако это влияет на то, какие методы вызывают определенные экземпляры SQLExceptions.
Результирующие наборы, созданные с помощью возвращаемого PreparedStatement
объекта, по умолчанию будут иметь тип TYPE_FORWARD_ONLY
и уровень CONCUR_READ_ONLY
параллелизма. Удержание созданных результирующих наборов можно определить путем вызова #getHoldability
.
Добавлено в версии 1.4.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String, int[])
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
PrepareStatement(String, String[])
Создает объект по умолчанию PreparedStatement
, способный возвращать автоматически созданные ключи, назначенные заданным заданным массивом.
[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
Параметры
- sql
- String
Инструкция SQL, которая может содержать одну или несколько "?" Заполнители параметров IN
- columnNames
- String[]
массив имен столбцов, указывающий столбцы, возвращаемые из вставленной строки или строк.
Возвращаемое значение
новый PreparedStatement
объект, содержащий предварительно скомпилированную инструкцию, которая может возвращать автоматически созданные ключи, назначенные заданным заданным массивом имен столбцов.
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
Создает объект по умолчанию PreparedStatement
, способный возвращать автоматически созданные ключи, назначенные заданным заданным массивом. Этот массив содержит имена столбцов в целевой таблице, которые содержат автоматически созданные ключи, которые должны быть возвращены. Драйвер игнорирует массив, если инструкция SQL не является оператором INSERT
, или инструкция SQL, способная возвращать автоматически созданные ключи (список таких инструкций зависит от поставщика).
Инструкция SQL с параметрами IN или без нее может быть предварительно скомпилирована и сохранена в объекте PreparedStatement
. Затем этот объект можно использовать для эффективного выполнения этой инструкции несколько раз.
<Примечание B>.</B> Этот метод оптимизирован для обработки инструкций параметрического SQL, которые получают преимущество от предварительной компиляции. Если драйвер поддерживает предварительную компиляцию, метод prepareStatement
отправит инструкцию в базу данных для предварительной компиляции. Некоторые драйверы могут не поддерживать предварительную компиляцию. В этом случае инструкция может не отправляться в базу данных, пока PreparedStatement
объект не будет выполнен. Это не имеет прямого влияния на пользователей; Однако это влияет на то, какие методы вызывают определенные экземпляры SQLExceptions.
Результирующие наборы, созданные с помощью возвращаемого PreparedStatement
объекта, по умолчанию будут иметь тип TYPE_FORWARD_ONLY
и уровень CONCUR_READ_ONLY
параллелизма. Удержание созданных результирующих наборов можно определить путем вызова #getHoldability
.
Добавлено в версии 1.4.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String, java.lang.String[])
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
PrepareStatement(String, Int32, Int32)
Создает объект, который создаст ResultSet
объекты с заданным типом PreparedStatement
и параллелизмом.
[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
Параметры
- sql
- String
String
Объект, который является инструкцией SQL для отправки в базу данных; может содержать один или несколько "?" Параметры IN
- resultSetType
- Int32
тип результирующих наборов; одно из ResultSet.TYPE_FORWARD_ONLY
, ResultSet.TYPE_SCROLL_INSENSITIVE
или ResultSet.TYPE_SCROLL_SENSITIVE
- resultSetConcurrency
- Int32
тип параллелизма; одно из ResultSet.CONCUR_READ_ONLY
или ResultSet.CONCUR_UPDATABLE
Возвращаемое значение
новый объект PreparedStatement, содержащий предварительно скомпилированную инструкцию SQL, которая будет создавать ResultSet
объекты с заданным типом и параллелизмом.
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
Создает объект, который создаст ResultSet
объекты с заданным типом PreparedStatement
и параллелизмом. Этот метод совпадает с приведенным выше методом prepareStatement
, но позволяет переопределить тип результирующих наборов по умолчанию и параллелизм. Удержание созданных результирующих наборов можно определить путем вызова #getHoldability
.
Добавлено в версии 1.2.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String, int, int)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Применяется к
PrepareStatement(String, Int32, Int32, Int32)
Создает объект, который создаст ResultSet
объекты с заданным типомPreparedStatement
, параллелизмом и удержанием.
[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
Параметры
- sql
- String
String
Объект, который является инструкцией SQL для отправки в базу данных; может содержать один или несколько "?" Параметры IN
- resultSetType
- Int32
одна из следующих ResultSet
констант: ResultSet.TYPE_FORWARD_ONLY
, ResultSet.TYPE_SCROLL_INSENSITIVE
или ResultSet.TYPE_SCROLL_SENSITIVE
- resultSetConcurrency
- Int32
одна из следующих ResultSet
констант: ResultSet.CONCUR_READ_ONLY
или ResultSet.CONCUR_UPDATABLE
- resultSetHoldability
- Int32
одна из следующих ResultSet
констант: ResultSet.HOLD_CURSORS_OVER_COMMIT
или ResultSet.CLOSE_CURSORS_AT_COMMIT
Возвращаемое значение
новый PreparedStatement
объект, содержащий предварительно скомпилированную инструкцию SQL, которая создаст ResultSet
объекты с заданным типом, параллелизмом и удержанием.
- Атрибуты
Исключения
Если возникла проблема с доступом к базе данных.
Комментарии
Создает объект, который создаст ResultSet
объекты с заданным типомPreparedStatement
, параллелизмом и удержанием.
Этот метод совпадает с приведенным выше методом prepareStatement
, но позволяет переопределить тип результирующих наборов по умолчанию, параллелизм и удержание.
Добавлено в версии 1.4.
Документация по Java для java.sql.Connection.prepareStatement(java.lang.String, int, int, int)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.