Most visited

Recently visited

Added in API level 1
Deprecated since API level 17

DatabaseUtils.InsertHelper

public static class DatabaseUtils.InsertHelper
extends Object

java.lang.Object
   ↳ android.database.DatabaseUtils.InsertHelper


此类在API级别17中已被弃用。
改为使用SQLiteStatement

该类允许用户使用相同的语句对表进行多次插入。

这个类不是线程安全的。

Summary

Public constructors

DatabaseUtils.InsertHelper(SQLiteDatabase db, String tableName)

Public methods

void bind(int index, float value)

将该值绑定到索引。

void bind(int index, double value)

将该值绑定到索引。

void bind(int index, int value)

将该值绑定到索引。

void bind(int index, String value)

将该值绑定到索引。

void bind(int index, long value)

将该值绑定到索引。

void bind(int index, byte[] value)

将该值绑定到索引。

void bind(int index, boolean value)

将该值绑定到索引。

void bindNull(int index)

将null绑定到索引。

void close()

关闭此对象并释放与其关联的所有资源。

long execute()

执行先前准备好的插入或使用自上次调用prepareForInsert或prepareForReplace以来的绑定值进行替换。

int getColumnIndex(String key)

返回指定列的索引。

long insert(ContentValues values)

执行插入操作,添加具有给定值的新行。

void prepareForInsert()

为插入准备InsertHelper。

void prepareForReplace()

准备InsertHelper进行替换。

long replace(ContentValues values)

执行插入操作,添加具有给定值的新行。

Inherited methods

From class java.lang.Object

Public constructors

DatabaseUtils.InsertHelper

Added in API level 1
DatabaseUtils.InsertHelper (SQLiteDatabase db, 
                String tableName)

Parameters
db SQLiteDatabase: the SQLiteDatabase to insert into
tableName String: the name of the table to insert into

Public methods

bind

Added in API level 1
void bind (int index, 
                float value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value float: the value to bind

bind

Added in API level 1
void bind (int index, 
                double value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value double: the value to bind

bind

Added in API level 1
void bind (int index, 
                int value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value int: the value to bind

bind

Added in API level 1
void bind (int index, 
                String value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value String: the value to bind

bind

Added in API level 1
void bind (int index, 
                long value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value long: the value to bind

bind

Added in API level 1
void bind (int index, 
                byte[] value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value byte: the value to bind

bind

Added in API level 1
void bind (int index, 
                boolean value)

将该值绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind
value boolean: the value to bind

bindNull

Added in API level 1
void bindNull (int index)

将null绑定到索引。 没有匹配execute()的prepareForInsert()或prepareForReplace()必须已经被调用。

Parameters
index int: the index of the slot to which to bind

close

Added in API level 1
void close ()

关闭此对象并释放与其关联的所有资源。 调用此方法后调用insert()的行为未定义。

execute

Added in API level 1
long execute ()

执行先前准备好的插入或使用自上次调用prepareForInsert或prepareForReplace以来的绑定值进行替换。

请注意,调用bind()然后执行()不是线程安全的。 使用这个类的唯一线程安全的方法是调用insert()或replace()。

Returns
long the row ID of the newly inserted row, or -1 if an error occurred

getColumnIndex

Added in API level 1
int getColumnIndex (String key)

返回指定列的索引。 这是索引适用于调用bind()。

Parameters
key String: the column name
Returns
int the index of the column

insert

Added in API level 1
long insert (ContentValues values)

执行插入操作,添加具有给定值的新行。 如果表中包含冲突的行,则返回错误。

Parameters
values ContentValues: the set of values with which to populate the new row
Returns
long the row ID of the newly inserted row, or -1 if an error occurred

prepareForInsert

Added in API level 1
void prepareForInsert ()

为插入准备InsertHelper。 这种模式是:

  • prepareForInsert()
  • bind(index, value);
  • bind(index, value);
  • ...
  • bind(index, value);
  • execute();

prepareForReplace

Added in API level 1
void prepareForReplace ()

准备InsertHelper进行替换。 这种模式是:

  • prepareForReplace()
  • bind(index, value);
  • bind(index, value);
  • ...
  • bind(index, value);
  • execute();

replace

Added in API level 1
long replace (ContentValues values)

执行插入操作,添加具有给定值的新行。 如果该表包含冲突的行,则它们将被删除并替换为新行。

Parameters
values ContentValues: the set of values with which to populate the new row
Returns
long the row ID of the newly inserted row, or -1 if an error occurred

Hooray!