ContentResolver.Query Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Query(Uri, String[], Bundle, CancellationSignal) |
Fragen Sie den angegebenen URI ab, und geben Sie eine |
| Query(Uri, String[], String, String[], String) |
Fragen Sie den angegebenen URI ab, und geben Sie eine |
| Query(Uri, String[], String, String[], String, CancellationSignal) |
Fragen Sie den angegebenen URI ab, und geben Sie einen |
Query(Uri, String[], Bundle, CancellationSignal)
Fragen Sie den angegebenen URI ab, und geben Sie eine Cursor über das Resultset mit Unterstützung für den Abbruch zurück.
[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.ICursorParameter
- uri
- Uri
Der URI, der das content:// Schema verwendet, um den abzurufenden Inhalt abzurufen.
- projection
- String[]
Eine Liste der spalten, die zurückgegeben werden sollen. Durch das Übergeben von NULL werden alle Spalten zurückgegeben, was ineffizient ist.
- queryArgs
- Bundle
Ein Bundle mit zusätzlichen Informationen, die für den Vorgang erforderlich sind. Argumente können SQL-Formatargumente enthalten, z ContentResolver#QUERY_ARG_SQL_LIMIT. B. , beachten Sie jedoch, dass in der Dokumentation für jeden einzelnen Anbieter angegeben wird, welche Argumente unterstützt werden.
- cancellationSignal
- CancellationSignal
Ein Signal, um den Vorgang in Bearbeitung abzubrechen, oder null, wenn keine.
Wenn der Vorgang abgebrochen wird, wird der OperationCanceledException Vorgang ausgelöst, wenn die Abfrage ausgeführt wird.
Gibt zurück
Ein Cursor-Objekt, das vor dem ersten Eintrag positioniert wird. Kann zurückgegeben werden null , wenn der zugrunde liegende Inhaltsanbieter zurückgibt nulloder abstürzt.
- Attribute
Hinweise
Fragen Sie den angegebenen URI ab, und geben Sie eine Cursor über das Resultset mit Unterstützung für den Abbruch zurück.
Um eine optimale Leistung zu erzielen, sollte der Aufrufer die folgenden Richtlinien befolgen:
<li>Stellen Sie eine explizite Projektion bereit, um zu verhindern, dass Daten gespeichert werden, die nicht verwendet werden.
Der Anbieter muss ermitteln, welche QUERY_ARG_SORT*-Argumente bei der Vorbereitung des Resultsets berücksichtigt wurden, indem die jeweiligen Argumentschlüssel in die Cursor Extras Bundleeingeschlossen werden. Einzelheiten dazu finden Sie unter #EXTRA_HONORED_ARGS.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Gilt für:
Query(Uri, String[], String, String[], String)
Fragen Sie den angegebenen URI ab, und geben Sie eine Cursor über das Resultset zurück.
[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.ICursorParameter
- uri
- Uri
Der URI, der das content:// Schema verwendet, um den abzurufenden Inhalt abzurufen.
- projection
- String[]
Eine Liste der spalten, die zurückgegeben werden sollen. Durch das Übergeben von NULL werden alle Spalten zurückgegeben, was ineffizient ist.
- selection
- String
Ein Filter, der deklariert, welche Zeilen zurückgegeben werden sollen, formatiert als SQL WHERE-Klausel (mit Ausnahme der WHERE selbst). Durch das Übergeben von NULL werden alle Zeilen für den angegebenen URI zurückgegeben.
- selectionArgs
- String[]
Sie können "?s" in der Auswahl einfügen, die durch die Werte aus selectionArgs ersetzt wird, in der Reihenfolge, in der sie in der Auswahl angezeigt werden. Die Werte werden als Zeichenfolgen gebunden.
- sortOrder
- String
So ordnen Sie die Zeilen an, die als SQL ORDER BY-Klausel formatiert sind (mit Ausnahme der ORDER BY-Klausel). Wenn Null übergeben wird, wird die Standardsortierreihenfolge verwendet, die möglicherweise nicht sortiert ist.
Gibt zurück
Ein Cursor-Objekt, das vor dem ersten Eintrag positioniert wird. Kann zurückgegeben werden null , wenn der zugrunde liegende Inhaltsanbieter zurückgibt nulloder abstürzt.
- Attribute
Hinweise
Fragen Sie den angegebenen URI ab, und geben Sie eine Cursor über das Resultset zurück.
Um eine optimale Leistung zu erzielen, sollte der Aufrufer die folgenden Richtlinien befolgen: <ul><li>Geben Sie eine explizite Projektion an, um zu verhindern, dass Daten gespeichert werden, die nicht verwendet< werden./li li><>Verwenden sie Fragezeichenparametermarker wie "phone=?" anstelle expliziter Werte im selection Parameter, sodass Abfragen, die sich nur von diesen Werten unterscheiden, für Zwischenspeicherungszwecke als identisch erkannt werden.</li></ul>
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Weitere Informationen
Gilt für:
Query(Uri, String[], String, String[], String, CancellationSignal)
Fragen Sie den angegebenen URI ab, und geben Sie einen Cursor Überlauf des Resultsets mit optionaler Unterstützung für den Abbruch zurück.
[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.ICursorParameter
- uri
- Uri
Der URI, der das content:// Schema verwendet, um den abzurufenden Inhalt abzurufen.
- projection
- String[]
Eine Liste der spalten, die zurückgegeben werden sollen. Durch das Übergeben von NULL werden alle Spalten zurückgegeben, was ineffizient ist.
- selection
- String
Ein Filter, der deklariert, welche Zeilen zurückgegeben werden sollen, formatiert als SQL WHERE-Klausel (mit Ausnahme der WHERE selbst). Durch das Übergeben von NULL werden alle Zeilen für den angegebenen URI zurückgegeben.
- selectionArgs
- String[]
Sie können "?s" in der Auswahl einfügen, die durch die Werte aus selectionArgs ersetzt wird, in der Reihenfolge, in der sie in der Auswahl angezeigt werden. Die Werte werden als Zeichenfolgen gebunden.
- sortOrder
- String
So ordnen Sie die Zeilen an, die als SQL ORDER BY-Klausel formatiert sind (mit Ausnahme der ORDER BY-Klausel). Wenn Null übergeben wird, wird die Standardsortierreihenfolge verwendet, die möglicherweise nicht sortiert ist.
- cancellationSignal
- CancellationSignal
Ein Signal, um den Vorgang in Bearbeitung abzubrechen, oder null, wenn keine.
Wenn der Vorgang abgebrochen wird, wird der OperationCanceledException Vorgang ausgelöst, wenn die Abfrage ausgeführt wird.
Gibt zurück
Ein Cursor-Objekt, das vor dem ersten Eintrag positioniert wird. Kann zurückgegeben werden null , wenn der zugrunde liegende Inhaltsanbieter zurückgibt nulloder abstürzt.
- Attribute
Hinweise
Fragen Sie den angegebenen URI ab, und geben Sie einen Cursor Überlauf des Resultsets mit optionaler Unterstützung für den Abbruch zurück.
Um eine optimale Leistung zu erzielen, sollte der Aufrufer die folgenden Richtlinien befolgen: <ul><li>Geben Sie eine explizite Projektion an, um zu verhindern, dass Daten gespeichert werden, die nicht verwendet< werden./li li><>Verwenden sie Fragezeichenparametermarker wie "phone=?" anstelle expliziter Werte im selection Parameter, sodass Abfragen, die sich nur von diesen Werten unterscheiden, für Zwischenspeicherungszwecke als identisch erkannt werden.</li></ul>
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.