Most visited

Recently visited

Results for

Added in API level 1

MergeCursor

public class MergeCursor
extends AbstractCursor

java.lang.Object
↳	android.database.AbstractCursor
	↳	android.database.MergeCursor

一个易于理解的类，可以让您将一组游标作为单个线性游标呈现。所提供的游标模式完全取决于MergeCursor的创建者，如果需要的话可能会有所不同。调用getColumns，getColumnIndex等将返回MergeCursor当前指向的行的值。

Summary

Inherited constants

From interface android.database.Cursor

Inherited fields

From class android.database.AbstractCursor

Public constructors
`MergeCursor(Cursor[] cursors)`

Public methods
`void`	`close()` 关闭光标，释放其所有资源并使其完全无效。
`void`	`deactivate()` 取消激活光标，使所有调用失败，直到调用 `requery()` 。
`byte[]`	`getBlob(int column)` 以字节数组的形式返回请求的列的值。
`String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`int`	`getCount()` 返回游标中的行数。
`double`	`getDouble(int column)` 以double形式返回请求的列的值。
`float`	`getFloat(int column)` 以浮点形式返回请求的列的值。
`int`	`getInt(int column)` 以int形式返回请求的列的值。
`long`	`getLong(int column)` 以long形式返回请求列的值。
`short`	`getShort(int column)` 以短为单位返回请求列的值。
`String`	`getString(int column)` 以String形式返回请求的列的值。
`int`	`getType(int column)` 返回给定列值的数据类型。
`boolean`	`isNull(int column)` 如果指定列中的值为空，则返回 `true` 。
`boolean`	`onMove(int oldPosition, int newPosition)` 每次将光标成功滚动到新位置时都会调用此函数，从而使子类有机会更新其可能具有的任何状态。
`void`	`registerContentObserver(ContentObserver observer)` 注册一个观察者，当支持该游标的内容发生更改时调用该观察者。
`void`	`registerDataSetObserver(DataSetObserver observer)` 注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 `requery()` ， `deactivate()` ，或 `close()` 。
`boolean`	`requery()` 执行再次创建光标的查询，刷新其内容。
`void`	`unregisterContentObserver(ContentObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前已使用此光标注册的观察者。
`void`	`unregisterDataSetObserver(DataSetObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前使用此光标注册的观察者。

Inherited methods

From class android.database.AbstractCursor

`void`	`checkPosition()` 如果光标位置超出范围，则此函数将引发CursorIndexOutOfBoundsException。
`void`	`close()` 关闭光标，释放其所有资源并使其完全无效。
`void`	`copyStringToBuffer(int columnIndex, CharArrayBuffer buffer)` 检索请求的列文本并将其存储在提供的缓冲区中。
`void`	`deactivate()` 取消激活光标，使所有调用失败，直到调用 `requery()` 。
`void`	`fillWindow(int position, CursorWindow window)` 将光标数据复制到窗口中。
`void`	`finalize()` 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。
`byte[]`	`getBlob(int column)` 以字节数组的形式返回请求的列的值。
`int`	`getColumnCount()` 返回总列数
`int`	`getColumnIndex(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在，则返回-1。
`int`	`getColumnIndexOrThrow(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在则返回 `IllegalArgumentException` 。
`String`	`getColumnName(int columnIndex)` 返回给定的从零开始的列索引处的列名称。
`abstract String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`abstract int`	`getCount()` 返回游标中的行数。
`abstract double`	`getDouble(int column)` 以double形式返回请求的列的值。
`Bundle`	`getExtras()` 返回一组额外的值。
`abstract float`	`getFloat(int column)` 以浮点形式返回请求的列的值。
`abstract int`	`getInt(int column)` 以int形式返回请求的列的值。
`abstract long`	`getLong(int column)` 以long形式返回请求列的值。
`Uri`	`getNotificationUri()` 返回此游标数据中的更改通知将传递到的URI，如先前由 `setNotificationUri(ContentResolver, Uri)`设置的 `setNotificationUri(ContentResolver, Uri)` 。
`final int`	`getPosition()` 返回行集合中光标的当前位置。
`abstract short`	`getShort(int column)` 以短为单位返回请求列的值。
`abstract String`	`getString(int column)` 以String形式返回请求的列的值。
`int`	`getType(int column)` 返回给定列值的数据类型。
`Object`	`getUpdatedField(int columnIndex)` 此方法在API级别11中已被弃用。始终返回null，因为游标不支持更新行
`boolean`	`getWantsAllOnMoveCalls()` 如果此方法返回true，onMove（）将仅在进程间调用。
`CursorWindow`	`getWindow()` 如果游标由 `CursorWindow`支持，则返回一个预填充窗口，其中包含游标的内容，否则返回null。
`final boolean`	`isAfterLast()` 返回指针是否指向最后一行之后的位置。
`final boolean`	`isBeforeFirst()` 返回光标是否指向第一行之前的位置。
`boolean`	`isClosed()` 如果光标关闭，则返回true
`boolean`	`isFieldUpdated(int columnIndex)` 此方法在API级别11中已弃用。由于游标不支持更新行，因此始终返回false
`final boolean`	`isFirst()` 返回光标是否指向第一行。
`final boolean`	`isLast()` 返回指针是否指向最后一行。
`abstract boolean`	`isNull(int column)` 如果指定列中的值为空，则返回 `true` 。
`final boolean`	`move(int offset)` 从当前位置向前或向后移动光标相对量。
`final boolean`	`moveToFirst()` 将光标移到第一行。
`final boolean`	`moveToLast()` 将光标移到最后一行。
`final boolean`	`moveToNext()` 将光标移到下一行。
`final boolean`	`moveToPosition(int position)` 将光标移到绝对位置。
`final boolean`	`moveToPrevious()` 将光标移到上一行。
`void`	`onChange(boolean selfChange)` 子类在完成提交更新以通知所有观察者时必须调用此方法。
`boolean`	`onMove(int oldPosition, int newPosition)` 每次将光标成功滚动到新位置时都会调用此函数，从而使子类有机会更新其可能具有的任何状态。
`void`	`registerContentObserver(ContentObserver observer)` 注册一个观察者，当支持该游标的内容发生更改时调用该观察者。
`void`	`registerDataSetObserver(DataSetObserver observer)` 注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 `requery()` ， `deactivate()` ，或 `close()` 。
`boolean`	`requery()` 执行再次创建光标的查询，刷新其内容。
`Bundle`	`respond(Bundle extras)` 这是光标与光标通信的用户的一种带外方式。
`void`	`setExtras(Bundle extras)` 设置 `Bundle`返回的 `getExtras()` 。
`void`	`setNotificationUri(ContentResolver cr, Uri notifyUri)` 指定要监视更改的内容URI。
`void`	`unregisterContentObserver(ContentObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前使用此光标注册的观察者。
`void`	`unregisterDataSetObserver(DataSetObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前使用此光标注册的观察者。

From class java.lang.Object

From interface android.database.CrossProcessCursor

From interface android.database.Cursor

`abstract void`	`close()` 关闭光标，释放其所有资源并使其完全无效。
`abstract void`	`copyStringToBuffer(int columnIndex, CharArrayBuffer buffer)` 检索请求的列文本并将其存储在提供的缓冲区中。
`abstract void`	`deactivate()` 此方法在API级别16中已弃用。由于`requery()`已弃用，因此也是如此。
`abstract byte[]`	`getBlob(int columnIndex)` 以字节数组的形式返回请求的列的值。
`abstract int`	`getColumnCount()` 返回总列数
`abstract int`	`getColumnIndex(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在，则返回-1。
`abstract int`	`getColumnIndexOrThrow(String columnName)` 返回给定列名称的从零开始的索引，如果该列不存在，则返回 `IllegalArgumentException` 。
`abstract String`	`getColumnName(int columnIndex)` 返回给定的从零开始的列索引处的列名称。
`abstract String[]`	`getColumnNames()` 以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。
`abstract int`	`getCount()` 返回游标中的行数。
`abstract double`	`getDouble(int columnIndex)` 以double形式返回请求的列的值。
`abstract Bundle`	`getExtras()` 返回一组额外的值。
`abstract float`	`getFloat(int columnIndex)` 以浮点形式返回请求的列的值。
`abstract int`	`getInt(int columnIndex)` 以int形式返回请求的列的值。
`abstract long`	`getLong(int columnIndex)` 以long形式返回请求列的值。
`abstract Uri`	`getNotificationUri()` 返回此游标数据中的更改通知将传递的URI，如先前由 `setNotificationUri(ContentResolver, Uri)`设置的 `setNotificationUri(ContentResolver, Uri)` 。
`abstract int`	`getPosition()` 返回行集合中光标的当前位置。
`abstract short`	`getShort(int columnIndex)` 以短为单位返回请求列的值。
`abstract String`	`getString(int columnIndex)` 以String形式返回请求的列的值。
`abstract int`	`getType(int columnIndex)` 返回给定列值的数据类型。
`abstract boolean`	`getWantsAllOnMoveCalls()` 如果此方法返回true，onMove（）将仅在进程间调用。
`abstract boolean`	`isAfterLast()` 返回指针是否指向最后一行之后的位置。
`abstract boolean`	`isBeforeFirst()` 返回光标是否指向第一行之前的位置。
`abstract boolean`	`isClosed()` 如果光标关闭，则返回true
`abstract boolean`	`isFirst()` 返回光标是否指向第一行。
`abstract boolean`	`isLast()` 返回指针是否指向最后一行。
`abstract boolean`	`isNull(int columnIndex)` 如果指定列中的值为空，则返回 `true` 。
`abstract boolean`	`move(int offset)` 从当前位置向前或向后移动光标相对量。
`abstract boolean`	`moveToFirst()` 将光标移到第一行。
`abstract boolean`	`moveToLast()` 将光标移到最后一行。
`abstract boolean`	`moveToNext()` 将光标移到下一行。
`abstract boolean`	`moveToPosition(int position)` 将光标移到绝对位置。
`abstract boolean`	`moveToPrevious()` 将光标移到上一行。
`abstract void`	`registerContentObserver(ContentObserver observer)` 注册一个观察者，当支持该游标的内容发生更改时调用该观察者。
`abstract void`	`registerDataSetObserver(DataSetObserver observer)` 注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 `requery()` ， `deactivate()` ，或 `close()` 。
`abstract boolean`	`requery()` 此方法在API级别11中已弃用。请勿使用此方法。只需要请求一个新的游标，以便您可以异步执行此操作，并在新游标返回时更新您的列表视图。
`abstract Bundle`	`respond(Bundle extras)` 这是光标与光标通信的用户的一种带外方式。
`abstract void`	`setExtras(Bundle extras)` 设置 `Bundle`返回的 `getExtras()` 。
`abstract void`	`setNotificationUri(ContentResolver cr, Uri uri)` 注册以观看更改的内容URI。
`abstract void`	`unregisterContentObserver(ContentObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前已使用此光标注册的观察者。
`abstract void`	`unregisterDataSetObserver(DataSetObserver observer)` 通过 `registerContentObserver(ContentObserver)`取消注册先前使用此光标注册的观察者。

From interface java.io.Closeable

From interface java.lang.AutoCloseable

Public constructors

MergeCursor

Added in API level 1

MergeCursor (Cursor[] cursors)

Parameters
`cursors`	`Cursor`

Public methods

close

Added in API level 1

void close ()

关闭光标，释放其所有资源并使其完全无效。与deactivate()不同，调用requery()不会使光标再次有效。

deactivate

Added in API level 1

void deactivate ()

取消激活光标，使所有调用失败，直到调用requery() 。非活动游标使用比活动游标更少的资源。调用requery()将使光标再次处于活动状态。

getBlob

Added in API level 1

byte[] getBlob (int column)

以字节数组的形式返回请求的列的值。

结果以及当列值为空或列类型不是blob类型时此方法是否引发异常是实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`byte[]`	the value of that column as a byte array.

getColumnNames

Added in API level 1

String[] getColumnNames ()

以结果中列出的顺序返回一个字符串数组，其中包含结果集中所有列的名称。

Returns
`String[]`	the names of the columns returned in this query.

getCount

Added in API level 1

int getCount ()

返回游标中的行数。

Returns
`int`	the number of rows in the cursor.

getDouble

Added in API level 1

double getDouble (int column)

以double形式返回请求的列的值。

结果以及此方法在列值为空，列类型不是浮点类型或浮点值不可表示时引发异常，或者由于实现定义了 double值，所以浮点值不可表示。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`double`	the value of that column as a double.

getFloat

Added in API level 1

float getFloat (int column)

以浮点形式返回请求的列的值。

结果以及当列值为空，列类型不是浮点类型或浮点值不可表示时，此方法引发异常，或者由于实现定义了 float值，因此浮点值不可表示。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`float`	the value of that column as a float.

getInt

Added in API level 1

int getInt (int column)

以int形式返回请求的列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Integer.MIN_VALUE ， Integer.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`int`	the value of that column as an int.

getLong

Added in API level 1

long getLong (int column)

以long形式返回请求列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Long.MIN_VALUE ， Long.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`long`	the value of that column as a long.

getShort

Added in API level 1

short getShort (int column)

以短为单位返回请求列的值。

结果，这种方法是否抛出异常当列值为空，列类型是不是一个整数类型，或者整数值是范围[外 Short.MIN_VALUE ， Short.MAX_VALUE ]为实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`short`	the value of that column as a short.

getString

Added in API level 1

String getString (int column)

以String形式返回请求的列的值。

结果以及此方法在列值为空或列类型不是字符串类型时是否引发异常是实现定义的。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`String`	the value of that column as a String.

getType

Added in API level 11

int getType (int column)

返回给定列值的数据类型。列的优选类型的返回，但如在get型方法如中记录的数据可以被转换到其它类型的getInt(int) ， getFloat(int)等

返回的列类型是

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`int`	column value type

isNull

Added in API level 1

boolean isNull (int column)

如果指定列中的值为空，则返回 true 。

Parameters
`column`	`int`: the zero-based index of the target column.

Returns
`boolean`	whether the column value is null.

onMove

Added in API level 1

boolean onMove (int oldPosition, 
                int newPosition)

每次将光标成功滚动到新位置时都会调用此函数，从而使子类有机会更新其可能具有的任何状态。如果它返回false，移动功能也会这样做，并且光标将滚动到beforeFirst位置。

Parameters
`oldPosition`	`int`: the position that we're moving from
`newPosition`	`int`: the position that we're moving to

Returns
`boolean`	true if the move is successful, false otherwise

registerContentObserver

Added in API level 1

void registerContentObserver (ContentObserver observer)

注册一个观察者，当支持该游标的内容发生更改时调用该观察者。通常情况下， requery()在调用requery()之前，数据集才会更改。

Parameters
`observer`	`ContentObserver`: the object that gets notified when the content backing the cursor changes.

registerDataSetObserver

Added in API level 1

void registerDataSetObserver (DataSetObserver observer)

注册时的变化发生在该光标数据集的内容被称为，例如一个观察者，当数据集通过改变 requery() ， deactivate() ，或 close() 。

Parameters
`observer`	`DataSetObserver`: the object that gets notified when the cursors data set changes.

requery

Added in API level 1

boolean requery ()

执行再次创建光标的查询，刷新其内容。这可以随时完成，包括在致电deactivate() 。由于此方法可能会在数据库上执行查询并可能需要一段时间，因此如果在Main（UI）线程上调用该方法，则可能会导致ANR。如果在主线程上执行此方法，则会打印警告。

Returns
`boolean`	true if the requery succeeded, false if not, in which case the cursor becomes invalid.

unregisterContentObserver

Added in API level 1

void unregisterContentObserver (ContentObserver observer)

通过 registerContentObserver(ContentObserver)取消注册先前已使用此光标注册的观察者。

Parameters
`observer`	`ContentObserver`: the object to unregister.

unregisterDataSetObserver

Added in API level 1

void unregisterDataSetObserver (DataSetObserver observer)

通过 registerContentObserver(ContentObserver)取消注册先前使用此光标注册的观察者。

Parameters
`observer`	`DataSetObserver`: the object to unregister.

Interfaces

Classes

Enums

Exceptions

Most visited

Recently visited

Results for

MergeCursor

Summary

Inherited constants

Inherited fields

Public constructors

Public methods

Inherited methods

Public constructors

MergeCursor

Public methods

close

deactivate

getBlob

getColumnNames

getCount

getDouble

getFloat

getInt

getLong

getShort

getString

getType

isNull

onMove

registerContentObserver

registerDataSetObserver

requery

unregisterContentObserver

unregisterDataSetObserver