ContentResolver.Query Метод

Определение

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

Android.Content

Сборка:

Mono.Android.dll

Перегрузки

Query(Uri, String[], Bundle, CancellationSignal)	Запросите заданный Cursor URI, возвращая результирующий набор с поддержкой отмены.
Query(Uri, String[], String, String[], String)	Запросите заданный универсальный Cursor код ресурса (URI), возвращая результирующий набор.
Query(Uri, String[], String, String[], String, CancellationSignal)	Запросите заданный Cursor URI, возвращая результирующий набор с необязательной поддержкой отмены.

Query(Uri, String[], Bundle, CancellationSignal)

Запросите заданный Cursor URI, возвращая результирующий набор с поддержкой отмены.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, Android.OS.Bundle? queryArgs, Android.OS.CancellationSignal? cancellationSignal);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Landroid/os/Bundle;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "", ApiSince=26)>]
member this.Query : Android.Net.Uri * string[] * Android.OS.Bundle * Android.OS.CancellationSignal -> Android.Database.ICursor

Параметры

uri

Uri

Универсальный код ресурса (URI) с помощью схемы content:// для получения содержимого.

projection

String[]

Список возвращаемых столбцов. Передача null возвращает все столбцы, которые неэффективны.

queryArgs

Bundle

Пакет, содержащий дополнительные сведения, необходимые для операции. Аргументы могут включать аргументы стиля SQL, например ContentResolver#QUERY_ARG_SQL_LIMIT, но обратите внимание, что документация для каждого отдельного поставщика будет указывать, какие аргументы они поддерживают.

cancellationSignal

CancellationSignal

Сигнал для отмены операции во время выполнения или значение NULL, если нет. Если операция отменена, OperationCanceledException при выполнении запроса будет возникать ошибка.

Возвращаемое значение

ICursor

Объект Cursor, расположенный перед первой записью. Может вернуться null , если базовый поставщик содержимого возвращается nullили завершается сбоем.

Атрибуты

RegisterAttribute

Комментарии

Запросите заданный Cursor URI, возвращая результирующий набор с поддержкой отмены.

Чтобы повысить производительность, вызывающий объект должен следовать следующим рекомендациям:

<li>Предоставьте явную проекцию, чтобы предотвратить чтение данных из хранилища, которые не будут использоваться.

Поставщик должен определить, какие аргументы QUERY_ARG_SORT* были выполнены во время подготовки результирующий набор, включив соответствующие ключи аргументов Bundleв Cursor дополнительные. Подробные сведения см. в разделе #EXTRA_HONORED_ARGS.

Документация по Java для android.content.ContentResolver.query(android.net.Uri, java.lang.String[], android.os.Bundle, android.os.CancellationSignal).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Query(Uri, String[], String, String[], String)

Запросите заданный универсальный Cursor код ресурса (URI), возвращая результирующий набор.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string -> Android.Database.ICursor

Параметры

uri

Uri

Универсальный код ресурса (URI) с помощью схемы content:// для получения содержимого.

projection

String[]

Список возвращаемых столбцов. Передача null возвращает все столбцы, которые неэффективны.

selection

String

Фильтр, объявляющий возвращаемые строки, отформатированные как предложение SQL WHERE (за исключением самого WHERE). Передавая значение NULL, возвращает все строки для заданного URI.

selectionArgs

String[]

Вы можете включить ?s в выборку, которая будет заменена значениями из selectionArgs, в том порядке, в котором они отображаются в выделенном фрагменте. Значения будут привязаны как строки.

sortOrder

String

Порядок строк, отформатированных в виде предложения SQL ORDER BY (за исключением самого ORDER BY). Передача null будет использовать порядок сортировки по умолчанию, который может быть неупорядоченным.

Возвращаемое значение

ICursor

Объект Cursor, расположенный перед первой записью. Может вернуться null , если базовый поставщик содержимого возвращается nullили завершается сбоем.

Атрибуты

RegisterAttribute

Комментарии

Запросите заданный универсальный Cursor код ресурса (URI), возвращая результирующий набор.

Для повышения производительности вызывающий объект должен следовать этим рекомендациям: <ul><li>Предоставить явную проекцию, чтобы предотвратить чтение данных из хранилища, которые не будут использоваться.</li><>Использовать маркеры параметров вопросительного знака, такие как phone=? вместо явных значений в selection параметре, поэтому запросы, которые отличаются только этими значениями, будут распознаны как те же для целей кэширования.</li></ul>

Документация по Java для android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

См. также раздел

• ICursor

Query(Uri, String[], String, String[], String, CancellationSignal)

Запросите заданный Cursor URI, возвращая результирующий набор с необязательной поддержкой отмены.

[Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")]
public Android.Database.ICursor? Query (Android.Net.Uri uri, string[]? projection, string? selection, string[]? selectionArgs, string? sortOrder, Android.OS.CancellationSignal? cancellationSignal);

[<Android.Runtime.Register("query", "(Landroid/net/Uri;[Ljava/lang/String;Ljava/lang/String;[Ljava/lang/String;Ljava/lang/String;Landroid/os/CancellationSignal;)Landroid/database/Cursor;", "")>]
member this.Query : Android.Net.Uri * string[] * string * string[] * string * Android.OS.CancellationSignal -> Android.Database.ICursor

Параметры

uri

Uri

Универсальный код ресурса (URI) с помощью схемы content:// для получения содержимого.

projection

String[]

Список возвращаемых столбцов. Передача null возвращает все столбцы, которые неэффективны.

selection

String

Фильтр, объявляющий возвращаемые строки, отформатированные как предложение SQL WHERE (за исключением самого WHERE). Передавая значение NULL, возвращает все строки для заданного URI.

selectionArgs

String[]

Вы можете включить ?s в выборку, которая будет заменена значениями из selectionArgs, в том порядке, в котором они отображаются в выделенном фрагменте. Значения будут привязаны как строки.

sortOrder

String

Порядок строк, отформатированных в виде предложения SQL ORDER BY (за исключением самого ORDER BY). Передача null будет использовать порядок сортировки по умолчанию, который может быть неупорядоченным.

cancellationSignal

CancellationSignal

Сигнал для отмены операции во время выполнения или значение NULL, если нет. Если операция отменена, OperationCanceledException при выполнении запроса будет возникать ошибка.

Возвращаемое значение

ICursor

Объект Cursor, расположенный перед первой записью. Может вернуться null , если базовый поставщик содержимого возвращается nullили завершается сбоем.

Атрибуты

RegisterAttribute

Комментарии

Запросите заданный Cursor URI, возвращая результирующий набор с необязательной поддержкой отмены.

Для повышения производительности вызывающий объект должен следовать этим рекомендациям: <ul><li>Предоставить явную проекцию, чтобы предотвратить чтение данных из хранилища, которые не будут использоваться.</li><>Использовать маркеры параметров вопросительного знака, такие как phone=? вместо явных значений в selection параметре, поэтому запросы, которые отличаются только этими значениями, будут распознаны как те же для целей кэширования.</li></ul>

Документация по Java для android.content.ContentResolver.query(android.net.Uri, java.lang.String[], java.lang.String, java.lang.String[], java.lang.String, android.os.CancellationSignal).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

См. также раздел

• ICursor