ContentResolverCompat

Added in 1.1.0

class ContentResolverCompat


Helper for accessing features in ContentResolver in a backwards compatible fashion.

Summary

Public functions

java-static Cursor?
query(
    resolver: ContentResolver,
    uri: Uri,
    projection: Array<String!>?,
    selection: String?,
    selectionArgs: Array<String!>?,
    sortOrder: String?,
    cancellationSignal: CancellationSignal?
)

Query the given URI, returning a Cursor over the result set with optional support for cancellation.

java-static Cursor?
query(
    resolver: ContentResolver,
    uri: Uri,
    projection: Array<String!>?,
    selection: String?,
    selectionArgs: Array<String!>?,
    sortOrder: String?,
    cancellationSignal: CancellationSignal?
)

This function is deprecated.

Use query

Public functions

query

Added in 1.13.0
java-static fun query(
    resolver: ContentResolver,
    uri: Uri,
    projection: Array<String!>?,
    selection: String?,
    selectionArgs: Array<String!>?,
    sortOrder: String?,
    cancellationSignal: CancellationSignal?
): Cursor?

Query the given URI, returning a Cursor over the result set with optional support for cancellation.

For best performance, the caller should follow these guidelines:

  • Provide an explicit projection, to prevent reading data from storage that aren't going to be used.
  • Use question mark parameter markers such as 'phone=?' instead of explicit values in the selection parameter, so that queries that differ only by those values will be recognized as the same for caching purposes.
Parameters
resolver: ContentResolver

resolver to use for the query.

uri: Uri

The URI, using the content:// scheme, for the content to retrieve.

projection: Array<String!>?

A list of which columns to return. Passing null will return all columns, which is inefficient.

selection: String?

A filter declaring which rows to return, formatted as an SQL WHERE clause (excluding the WHERE itself). Passing null will return all rows for the given URI.

selectionArgs: Array<String!>?

You may include ?s in selection, which will be replaced by the values from selectionArgs, in the order that they appear in the selection. The values will be bound as Strings.

sortOrder: String?

How to order the rows, formatted as an SQL ORDER BY clause (excluding the ORDER BY itself). Passing null will use the default sort order, which may be unordered.

cancellationSignal: CancellationSignal?

A signal to cancel the operation in progress, or null if none. If the operation is canceled, then OperationCanceledException will be thrown when the query is executed.

Returns
Cursor?

A Cursor object, which is positioned before the first entry, or null

See also
Cursor

query

Added in 1.1.0
Deprecated in 1.13.0
java-static fun query(
    resolver: ContentResolver,
    uri: Uri,
    projection: Array<String!>?,
    selection: String?,
    selectionArgs: Array<String!>?,
    sortOrder: String?,
    cancellationSignal: CancellationSignal?
): Cursor?

Query the given URI, returning a Cursor over the result set with optional support for cancellation.

For best performance, the caller should follow these guidelines:

  • Provide an explicit projection, to prevent reading data from storage that aren't going to be used.
  • Use question mark parameter markers such as 'phone=?' instead of explicit values in the selection parameter, so that queries that differ only by those values will be recognized as the same for caching purposes.
Parameters
resolver: ContentResolver

resolver to use for the query.

uri: Uri

The URI, using the content:// scheme, for the content to retrieve.

projection: Array<String!>?

A list of which columns to return. Passing null will return all columns, which is inefficient.

selection: String?

A filter declaring which rows to return, formatted as an SQL WHERE clause (excluding the WHERE itself). Passing null will return all rows for the given URI.

selectionArgs: Array<String!>?

You may include ?s in selection, which will be replaced by the values from selectionArgs, in the order that they appear in the selection. The values will be bound as Strings.

sortOrder: String?

How to order the rows, formatted as an SQL ORDER BY clause (excluding the ORDER BY itself). Passing null will use the default sort order, which may be unordered.

cancellationSignal: CancellationSignal?

A signal to cancel the operation in progress, or null if none. If the operation is canceled, then OperationCanceledException will be thrown when the query is executed.

Returns
Cursor?

A Cursor object, which is positioned before the first entry, or null

See also
Cursor