SQLiteOpenHelper Classe
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.
Classe d’assistance pour gérer la création et la gestion des versions de la base de données.
[Android.Runtime.Register("android/database/sqlite/SQLiteOpenHelper", DoNotGenerateAcw=true)]
public abstract class SQLiteOpenHelper : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IAutoCloseable
[<Android.Runtime.Register("android/database/sqlite/SQLiteOpenHelper", DoNotGenerateAcw=true)>]
type SQLiteOpenHelper = class
inherit Object
interface IAutoCloseable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Héritage
- Attributs
- Implémente
Remarques
Classe d’assistance pour gérer la création et la gestion des versions de la base de données.
Vous créez une sous-classe implémentant #onCreate, #onUpgrade et éventuellement #onOpen, et cette classe s’occupe de l’ouverture de la base de données si elle existe, de la créer si ce n’est pas le cas et de la mettre à niveau si nécessaire. Les transactions sont utilisées pour s’assurer que la base de données est toujours dans un état sensible.
Cette classe permet android.content.ContentProvider aux implémentations de différer l’ouverture et la mise à niveau de la base de données jusqu’à la première utilisation, afin d’éviter de bloquer le démarrage de l’application avec des mises à niveau de base de données longues.
Pour obtenir un exemple, consultez la classe NotePadProvider dans l’exemple d’application NotePad, dans le <répertoire em>samples/<em> du Kit de développement logiciel (SDK).
< >strong Remarque :</strong> cette classe part du principe que les numéros de version augmentent monotoniquement pour les mises à niveau.
<strong>Remarque :</strong> l’interface AutoCloseable a été ajoutée pour la première fois dans la android.os.Build.VERSION_CODES#Q version.
Java documentation pour android.database.sqlite.SQLiteOpenHelper.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| SQLiteOpenHelper(Context, String, Int32, SQLiteDatabase+OpenParams) |
Créez un objet d’assistance pour créer, ouvrir et/ou gérer une base de données. |
| SQLiteOpenHelper(Context, String, SQLiteDatabase+ICursorFactory, Int32, IDatabaseErrorHandler) |
Créez un objet d’assistance pour créer, ouvrir et/ou gérer une base de données. |
| SQLiteOpenHelper(Context, String, SQLiteDatabase+ICursorFactory, Int32) |
Créez un objet d’assistance pour créer, ouvrir et/ou gérer une base de données. |
| SQLiteOpenHelper(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| DatabaseName |
Retourne le nom de la base de données SQLite ouverte, comme indiqué au constructeur. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| JniPeerMembers |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. |
| PeerReference |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| ReadableDatabase |
Créez et/ou ouvrez une base de données. |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| WritableDatabase |
Créez et/ou ouvrez une base de données qui sera utilisée pour la lecture et l’écriture. |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Close() |
Fermez n’importe quel objet de base de données ouvert. |
| Dispose() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| Dispose(Boolean) |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| OnConfigure(SQLiteDatabase) |
Appelée lorsque la connexion de base de données est configurée, pour activer des fonctionnalités telles que la journalisation en écriture anticipée ou la prise en charge des clés étrangères. |
| OnCreate(SQLiteDatabase) |
Appelé lorsque la base de données est créée pour la première fois. |
| OnDowngrade(SQLiteDatabase, Int32, Int32) |
Appelé lorsque la base de données doit être rétrogradée. |
| OnOpen(SQLiteDatabase) |
Appelé lorsque la base de données a été ouverte. |
| OnUpgrade(SQLiteDatabase, Int32, Int32) |
Appelé lorsque la base de données doit être mise à niveau. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetIdleConnectionTimeout(Int64) |
Définit le nombre maximal de millisecondes que la connexion SQLite est autorisée à être inactive avant qu’elle ne soit fermée et supprimée du pool. |
| SetLookasideConfig(Int32, Int32) |
Configure l’allocateur de mémoire lookaside |
| SetOpenParams(SQLiteDatabase+OpenParams) |
Définit les paramètres de configuration utilisés pour l’ouverture |
| SetWriteAheadLoggingEnabled(Boolean) |
Active ou désactive l’utilisation de la journalisation en écriture anticipée pour la base de données. |
| ToArray<T>() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.Finalized() |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.JniManagedPeerState |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. (Hérité de Object) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Classe d’assistance pour gérer la création et la gestion des versions de la base de données. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |