ContentResolver.Query Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Query(Uri, String[], Bundle, CancellationSignal) |
Interrogez l’URI donné, en retournant un |
| Query(Uri, String[], String, String[], String) |
Interrogez l’URI donné, en retournant un |
| Query(Uri, String[], String, String[], String, CancellationSignal) |
Interrogez l’URI donné, en retournant un |
Query(Uri, String[], Bundle, CancellationSignal)
Interrogez l’URI donné, en retournant un Cursor jeu de résultats avec prise en charge de l’annulation.
[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.ICursorParamètres
- uri
- Uri
URI, à l’aide du schéma de content://, pour que le contenu soit récupéré.
- projection
- String[]
Liste des colonnes à retourner. Le passage de la valeur Null retourne toutes les colonnes, ce qui est inefficace.
- queryArgs
- Bundle
Bundle contenant des informations supplémentaires nécessaires pour l’opération. Les arguments peuvent inclure des arguments de style SQL, tels que ContentResolver#QUERY_ARG_SQL_LIMIT, mais notez que la documentation de chaque fournisseur individuel indique quels arguments ils prennent en charge.
- cancellationSignal
- CancellationSignal
Signal d’annulation de l’opération en cours, ou null si aucun.
Si l’opération est annulée, elle OperationCanceledException est levée lors de l’exécution de la requête.
Retours
Objet Cursor, positionné avant la première entrée. Peut retourner null si le fournisseur de contenu sous-jacent retourne nullou s’il se bloque.
- Attributs
Remarques
Interrogez l’URI donné, en retournant un Cursor jeu de résultats avec prise en charge de l’annulation.
Pour des performances optimales, l’appelant doit suivre les instructions suivantes :
<li>Fournissez une projection explicite pour empêcher la lecture des données du stockage qui ne seront pas utilisées.
Le fournisseur doit identifier les arguments QUERY_ARG_SORT* qui ont été respectés lors de la préparation du jeu de résultats en incluant les clés d’argument respectives dans les Cursor extras Bundle. Pour plus d'informations, consultez #EXTRA_HONORED_ARGS.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
S’applique à
Query(Uri, String[], String, String[], String)
Interrogez l’URI donné, en retournant un Cursor sur le jeu de résultats.
[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.ICursorParamètres
- uri
- Uri
URI, à l’aide du schéma de content://, pour que le contenu soit récupéré.
- projection
- String[]
Liste des colonnes à retourner. Le passage de la valeur Null retourne toutes les colonnes, ce qui est inefficace.
- selection
- String
Filtre déclarant quelles lignes retourner, mises en forme en tant que clause SQL WHERE (à l’exception de l’instruction WHERE elle-même). Le passage de la valeur Null retourne toutes les lignes de l’URI donné.
- selectionArgs
- String[]
Vous pouvez inclure ?s dans la sélection, qui sera remplacée par les valeurs de selectionArgs, dans l’ordre dans lequel elles apparaissent dans la sélection. Les valeurs seront liées sous forme de chaînes.
- sortOrder
- String
Comment classer les lignes, mises en forme en tant que clause SQL ORDER BY (à l’exclusion de ORDER BY elle-même). La transmission de null utilise l’ordre de tri par défaut, qui peut être non ordonné.
Retours
Objet Cursor, positionné avant la première entrée. Peut retourner null si le fournisseur de contenu sous-jacent retourne nullou s’il se bloque.
- Attributs
Remarques
Interrogez l’URI donné, en retournant un Cursor sur le jeu de résultats.
Pour des performances optimales, l’appelant doit suivre ces instructions : <ul<>li>Fournir une projection explicite pour empêcher la lecture des données du stockage qui ne seront pas utilisées.</li li><>Utiliser des marqueurs de paramètre de point d’interrogation tels que 'phone= ?' Au lieu de valeurs explicites dans le selection paramètre, de sorte que les requêtes qui diffèrent uniquement par ces valeurs seront reconnues comme identiques à des fins de mise en cache.</li></ul>
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Voir aussi
S’applique à
Query(Uri, String[], String, String[], String, CancellationSignal)
Interrogez l’URI donné, en retournant un Cursor jeu de résultats avec prise en charge facultative de l’annulation.
[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.ICursorParamètres
- uri
- Uri
URI, à l’aide du schéma de content://, pour que le contenu soit récupéré.
- projection
- String[]
Liste des colonnes à retourner. Le passage de la valeur Null retourne toutes les colonnes, ce qui est inefficace.
- selection
- String
Filtre déclarant quelles lignes retourner, mises en forme en tant que clause SQL WHERE (à l’exception de l’instruction WHERE elle-même). Le passage de la valeur Null retourne toutes les lignes de l’URI donné.
- selectionArgs
- String[]
Vous pouvez inclure ?s dans la sélection, qui sera remplacée par les valeurs de selectionArgs, dans l’ordre dans lequel elles apparaissent dans la sélection. Les valeurs seront liées sous forme de chaînes.
- sortOrder
- String
Comment classer les lignes, mises en forme en tant que clause SQL ORDER BY (à l’exclusion de ORDER BY elle-même). La transmission de null utilise l’ordre de tri par défaut, qui peut être non ordonné.
- cancellationSignal
- CancellationSignal
Signal d’annulation de l’opération en cours, ou null si aucun.
Si l’opération est annulée, elle OperationCanceledException est levée lors de l’exécution de la requête.
Retours
Objet Cursor, positionné avant la première entrée. Peut retourner null si le fournisseur de contenu sous-jacent retourne nullou s’il se bloque.
- Attributs
Remarques
Interrogez l’URI donné, en retournant un Cursor jeu de résultats avec prise en charge facultative de l’annulation.
Pour des performances optimales, l’appelant doit suivre ces instructions : <ul<>li>Fournir une projection explicite pour empêcher la lecture des données du stockage qui ne seront pas utilisées.</li li><>Utiliser des marqueurs de paramètre de point d’interrogation tels que 'phone= ?' Au lieu de valeurs explicites dans le selection paramètre, de sorte que les requêtes qui diffèrent uniquement par ces valeurs seront reconnues comme identiques à des fins de mise en cache.</li></ul>
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.