ContentResolver.Query 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| Query(Uri, String[], Bundle, CancellationSignal) |
지정된 URI를 쿼리하고 취소를 |
| Query(Uri, String[], String, String[], String) |
지정된 URI를 쿼리하여 |
| Query(Uri, String[], String, String[], String, CancellationSignal) |
지정된 URI를 쿼리하여 취소에 대한 선택적 지원을 사용하여 |
Query(Uri, String[], Bundle, CancellationSignal)
지정된 URI를 쿼리하고 취소를 Cursor 지원하는 결과 집합을 반환합니다.
[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
content:// 체계를 사용하여 콘텐츠를 검색할 URI입니다.
- projection
- String[]
반환할 열 목록입니다. null을 전달하면 비효율적인 모든 열이 반환됩니다.
- queryArgs
- Bundle
작업에 필요한 추가 정보가 포함된 번들입니다. 인수에는 SQL 스타일 인수(예: ContentResolver#QUERY_ARG_SQL_LIMIT)가 포함될 수 있지만 각 개별 공급자에 대한 설명서는 지원하는 인수를 나타냅니다.
- cancellationSignal
- CancellationSignal
진행 중인 작업을 취소하는 신호이거나, 없는 경우 null입니다.
작업이 취소되면 OperationCanceledException 쿼리가 실행될 때 throw됩니다.
반환
첫 번째 항목 앞에 배치되는 커서 개체입니다. 기본 콘텐츠 공급자가 반환되거나 충돌하는 경우 반환 nullnull할 수 있습니다.
- 특성
설명
지정된 URI를 쿼리하고 취소를 Cursor 지원하는 결과 집합을 반환합니다.
최상의 성능을 위해 호출자는 다음 지침을 따라야 합니다.
<li>사용되지 않을 스토리지에서 데이터를 읽지 않도록 명시적 프로젝션을 제공합니다.
공급자는 각 인수 키를 엑스트라에 포함하여 결과 집합을 준비하는 동안 적용된 QUERY_ARG_SORT* 인수를 Cursor 식별해야 합니다 Bundle. 자세한 내용은 #EXTRA_HONORED_ARGS를 참조하세요.
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.
적용 대상
Query(Uri, String[], String, String[], String)
지정된 URI를 쿼리하여 Cursor 결과 집합을 반환합니다.
[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
content:// 체계를 사용하여 콘텐츠를 검색할 URI입니다.
- projection
- String[]
반환할 열 목록입니다. null을 전달하면 비효율적인 모든 열이 반환됩니다.
- selection
- String
반환할 행을 선언하는 필터로, SQL WHERE 절로 형식이 지정됩니다(WHERE 자체 제외). null을 전달하면 지정된 URI에 대한 모든 행이 반환됩니다.
- selectionArgs
- String[]
선택 영역에 ?s를 포함할 수 있습니다. 선택 영역에 표시되는 순서대로 selectionArgs의 값으로 대체됩니다. 값은 문자열로 바인딩됩니다.
- sortOrder
- String
SQL ORDER BY 절로 서식이 지정된 행의 순서를 지정하는 방법(ORDER BY 자체 제외). null을 전달하면 순서가 지정되지 않을 수 있는 기본 정렬 순서가 사용됩니다.
반환
첫 번째 항목 앞에 배치되는 커서 개체입니다. 기본 콘텐츠 공급자가 반환되거나 충돌하는 경우 반환 nullnull할 수 있습니다.
- 특성
설명
지정된 URI를 쿼리하여 Cursor 결과 집합을 반환합니다.
최상의 성능을 위해 호출자는 다음 지침을 <따라야 합니다. ul><li>는 사용되지 않을 스토리지에서 데이터를 읽지 못하도록 명시적 프로젝션을 제공합니다.</li li><>'phone=?' 같은 물음표 매개 변수 표식을 사용합니다. 매개 변수의 명시적 값 대신 해당 값 selection 에 의해서만 다른 쿼리가 캐싱 용도로 동일하게 인식되도록 합니다.</li></ul>
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.
추가 정보
적용 대상
Query(Uri, String[], String, String[], String, CancellationSignal)
지정된 URI를 쿼리하여 취소에 대한 선택적 지원을 사용하여 Cursor 결과 집합을 반환합니다.
[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
content:// 체계를 사용하여 콘텐츠를 검색할 URI입니다.
- 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 쿼리가 실행될 때 throw됩니다.
반환
첫 번째 항목 앞에 배치되는 커서 개체입니다. 기본 콘텐츠 공급자가 반환되거나 충돌하는 경우 반환 nullnull할 수 있습니다.
- 특성
설명
지정된 URI를 쿼리하여 취소에 대한 선택적 지원을 사용하여 Cursor 결과 집합을 반환합니다.
최상의 성능을 위해 호출자는 다음 지침을 <따라야 합니다. ul><li>는 사용되지 않을 스토리지에서 데이터를 읽지 못하도록 명시적 프로젝션을 제공합니다.</li li><>'phone=?' 같은 물음표 매개 변수 표식을 사용합니다. 매개 변수의 명시적 값 대신 해당 값 selection 에 의해서만 다른 쿼리가 캐싱 용도로 동일하게 인식되도록 합니다.</li></ul>
이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.