System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact 3a632814f21617c387134117f2d8d96089d50e29:


0000: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
0010: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0d 0a 20 2a 20 41 44  *********.. * AD
0040: 4f 2e 4e 45 54 20 32 2e 30 20 44 61 74 61 20 50  O.NET 2.0 Data P
0050: 72 6f 76 69 64 65 72 20 66 6f 72 20 53 51 4c 69  rovider for SQLi
0060: 74 65 20 56 65 72 73 69 6f 6e 20 33 2e 58 0d 0a  te Version 3.X..
0070: 20 2a 20 57 72 69 74 74 65 6e 20 62 79 20 52 6f   * Written by Ro
0080: 62 65 72 74 20 53 69 6d 70 73 6f 6e 20 28 72 6f  bert Simpson (ro
0090: 62 65 72 74 40 62 6c 61 63 6b 63 61 73 74 6c 65  bert@blackcastle
00a0: 73 6f 66 74 2e 63 6f 6d 29 0d 0a 20 2a 20 0d 0a  soft.com).. * ..
00b0: 20 2a 20 52 65 6c 65 61 73 65 64 20 74 6f 20 74   * Released to t
00c0: 68 65 20 70 75 62 6c 69 63 20 64 6f 6d 61 69 6e  he public domain
00d0: 2c 20 75 73 65 20 61 74 20 79 6f 75 72 20 6f 77  , use at your ow
00e0: 6e 20 72 69 73 6b 21 0d 0a 20 2a 2a 2a 2a 2a 2a  n risk!.. ******
00f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0100: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0110: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0120: 2a 2a 2f 0d 0a 0d 0a 6e 61 6d 65 73 70 61 63 65  **/....namespace
0130: 20 53 79 73 74 65 6d 2e 44 61 74 61 2e 53 51 4c   System.Data.SQL
0140: 69 74 65 0d 0a 7b 0d 0a 20 20 75 73 69 6e 67 20  ite..{..  using 
0150: 53 79 73 74 65 6d 3b 0d 0a 0d 0a 23 69 66 20 21  System;....#if !
0160: 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54  PLATFORM_COMPACT
0170: 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 75 73 69  FRAMEWORK..  usi
0180: 6e 67 20 53 79 73 74 65 6d 2e 52 75 6e 74 69 6d  ng System.Runtim
0190: 65 2e 49 6e 74 65 72 6f 70 53 65 72 76 69 63 65  e.InteropService
01a0: 73 3b 0d 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 20  s;..#endif....  
01b0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
01c0: 20 2f 2f 2f 20 54 68 69 73 20 69 6e 74 65 72 6e   /// This intern
01d0: 61 6c 20 63 6c 61 73 73 20 70 72 6f 76 69 64 65  al class provide
01e0: 73 20 74 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e  s the foundation
01f0: 20 6f 66 20 53 51 4c 69 74 65 20 73 75 70 70 6f   of SQLite suppo
0200: 72 74 2e 20 20 49 74 20 64 65 66 69 6e 65 73 20  rt.  It defines 
0210: 61 6c 6c 20 74 68 65 20 61 62 73 74 72 61 63 74  all the abstract
0220: 20 6d 65 6d 62 65 72 73 20 6e 65 65 64 65 64 20   members needed 
0230: 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 0d 0a 20 20  to implement..  
0240: 2f 2f 2f 20 61 20 53 51 4c 69 74 65 20 64 61 74  /// a SQLite dat
0250: 61 20 70 72 6f 76 69 64 65 72 2c 20 61 6e 64 20  a provider, and 
0260: 69 6e 68 65 72 69 74 73 20 66 72 6f 6d 20 53 51  inherits from SQ
0270: 4c 69 74 65 43 6f 6e 76 65 72 74 20 77 68 69 63  LiteConvert whic
0280: 68 20 61 6c 6c 6f 77 73 20 66 6f 72 20 73 69 6d  h allows for sim
0290: 70 6c 65 20 74 72 61 6e 73 6c 61 74 69 6f 6e 73  ple translations
02a0: 20 6f 66 20 73 74 72 69 6e 67 20 74 6f 20 61 6e   of string to an
02b0: 64 20 66 72 6f 6d 20 53 51 4c 69 74 65 2e 0d 0a  d from SQLite...
02c0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
02d0: 0d 0a 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73  ..  internal abs
02e0: 74 72 61 63 74 20 63 6c 61 73 73 20 53 51 4c 69  tract class SQLi
02f0: 74 65 42 61 73 65 20 3a 20 53 51 4c 69 74 65 43  teBase : SQLiteC
0300: 6f 6e 76 65 72 74 2c 20 49 44 69 73 70 6f 73 61  onvert, IDisposa
0310: 62 6c 65 0d 0a 20 20 7b 0d 0a 20 20 20 20 23 72  ble..  {..    #r
0320: 65 67 69 6f 6e 20 50 72 69 76 61 74 65 20 43 6f  egion Private Co
0330: 6e 73 74 61 6e 74 73 0d 0a 20 20 20 20 2f 2f 2f  nstants..    ///
0340: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
0350: 2f 2f 2f 20 54 68 65 20 65 72 72 6f 72 20 63 6f  /// The error co
0360: 64 65 20 75 73 65 64 20 66 6f 72 20 6c 6f 67 67  de used for logg
0370: 69 6e 67 20 65 78 63 65 70 74 69 6f 6e 73 20 63  ing exceptions c
0380: 61 75 67 68 74 20 69 6e 20 75 73 65 72 2d 70 72  aught in user-pr
0390: 6f 76 69 64 65 64 0d 0a 20 20 20 20 2f 2f 2f 20  ovided..    /// 
03a0: 63 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  code...    /// <
03b0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69  /summary>..    i
03c0: 6e 74 65 72 6e 61 6c 20 63 6f 6e 73 74 20 69 6e  nternal const in
03d0: 74 20 43 4f 52 5f 45 5f 45 58 43 45 50 54 49 4f  t COR_E_EXCEPTIO
03e0: 4e 20 3d 20 75 6e 63 68 65 63 6b 65 64 28 28 69  N = unchecked((i
03f0: 6e 74 29 30 78 38 30 31 33 31 35 30 30 29 3b 0d  nt)0x80131500);.
0400: 0a 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d  .    #endregion.
0410: 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f  ...    /////////
0420: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
0430: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
0440: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
0450: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
0460: 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  ....    internal
0470: 20 53 51 4c 69 74 65 42 61 73 65 28 53 51 4c 69   SQLiteBase(SQLi
0480: 74 65 44 61 74 65 46 6f 72 6d 61 74 73 20 66 6d  teDateFormats fm
0490: 74 2c 20 44 61 74 65 54 69 6d 65 4b 69 6e 64 20  t, DateTimeKind 
04a0: 6b 69 6e 64 2c 20 73 74 72 69 6e 67 20 66 6d 74  kind, string fmt
04b0: 53 74 72 69 6e 67 29 0d 0a 20 20 20 20 20 20 3a  String)..      :
04c0: 20 62 61 73 65 28 66 6d 74 2c 20 6b 69 6e 64 2c   base(fmt, kind,
04d0: 20 66 6d 74 53 74 72 69 6e 67 29 20 7b 20 7d 0d   fmtString) { }.
04e0: 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ...    /// <summ
04f0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
0500: 74 75 72 6e 73 20 61 20 73 74 72 69 6e 67 20 72  turns a string r
0510: 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20  epresenting the 
0520: 61 63 74 69 76 65 20 76 65 72 73 69 6f 6e 20 6f  active version o
0530: 66 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 2f 2f  f SQLite..    //
0540: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
0550: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
0560: 61 63 74 20 73 74 72 69 6e 67 20 56 65 72 73 69  act string Versi
0570: 6f 6e 20 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20  on { get; }..   
0580: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
0590: 20 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20      /// Returns 
05a0: 61 6e 20 69 6e 74 65 67 65 72 20 72 65 70 72 65  an integer repre
05b0: 73 65 6e 74 69 6e 67 20 74 68 65 20 61 63 74 69  senting the acti
05c0: 76 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 53 51  ve version of SQ
05d0: 4c 69 74 65 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  Lite..    /// </
05e0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
05f0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
0600: 69 6e 74 20 56 65 72 73 69 6f 6e 4e 75 6d 62 65  int VersionNumbe
0610: 72 20 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20  r { get; }..    
0620: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
0630: 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74     /// Returns t
0640: 68 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20  he rowid of the 
0650: 6d 6f 73 74 20 72 65 63 65 6e 74 20 73 75 63 63  most recent succ
0660: 65 73 73 66 75 6c 20 49 4e 53 45 52 54 20 69 6e  essful INSERT in
0670: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20  to the database 
0680: 66 72 6f 6d 20 74 68 69 73 20 63 6f 6e 6e 65 63  from this connec
0690: 74 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  tion...    /// <
06a0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69  /summary>..    i
06b0: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
06c0: 20 6c 6f 6e 67 20 4c 61 73 74 49 6e 73 65 72 74   long LastInsert
06d0: 52 6f 77 49 64 20 7b 20 67 65 74 3b 20 7d 0d 0a  RowId { get; }..
06e0: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
06f0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75 72  >..    /// Retur
0700: 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  ns the number of
0710: 20 63 68 61 6e 67 65 73 20 74 68 65 20 6c 61 73   changes the las
0720: 74 20 65 78 65 63 75 74 69 6e 67 20 69 6e 73 65  t executing inse
0730: 72 74 2f 75 70 64 61 74 65 20 63 61 75 73 65 64  rt/update caused
0740: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  ...    /// </sum
0750: 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72  mary>..    inter
0760: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
0770: 20 43 68 61 6e 67 65 73 20 7b 20 67 65 74 3b 20   Changes { get; 
0780: 7d 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  }..    /// <summ
0790: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
07a0: 74 75 72 6e 73 20 74 68 65 20 61 6d 6f 75 6e 74  turns the amount
07b0: 20 6f 66 20 6d 65 6d 6f 72 79 20 28 69 6e 20 62   of memory (in b
07c0: 79 74 65 73 29 20 63 75 72 72 65 6e 74 6c 79 20  ytes) currently 
07d0: 69 6e 20 75 73 65 20 62 79 20 74 68 65 20 53 51  in use by the SQ
07e0: 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72  Lite core librar
07f0: 79 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 20  y.  This is not 
0800: 72 65 61 6c 6c 79 20 61 20 70 65 72 2d 63 6f 6e  really a per-con
0810: 6e 65 63 74 69 6f 6e 0d 0a 20 20 20 20 2f 2f 2f  nection..    ///
0820: 20 76 61 6c 75 65 2c 20 69 74 20 69 73 20 67 6c   value, it is gl
0830: 6f 62 61 6c 20 74 6f 20 74 68 65 20 70 72 6f 63  obal to the proc
0840: 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ess...    /// </
0850: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
0860: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
0870: 6c 6f 6e 67 20 4d 65 6d 6f 72 79 55 73 65 64 20  long MemoryUsed 
0880: 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f  { get; }..    //
0890: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
08a0: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65   /// Returns the
08b0: 20 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20   maximum amount 
08c0: 6f 66 20 6d 65 6d 6f 72 79 20 28 69 6e 20 62 79  of memory (in by
08d0: 74 65 73 29 20 75 73 65 64 20 62 79 20 74 68 65  tes) used by the
08e0: 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62   SQLite core lib
08f0: 72 61 72 79 20 73 69 6e 63 65 20 74 68 65 20 68  rary since the h
0900: 69 67 68 2d 77 61 74 65 72 20 6d 61 72 6b 20 77  igh-water mark w
0910: 61 73 20 6c 61 73 74 20 72 65 73 65 74 2e 0d 0a  as last reset...
0920: 20 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20      /// This is 
0930: 6e 6f 74 20 72 65 61 6c 6c 79 20 61 20 70 65 72  not really a per
0940: 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 76 61 6c 75  -connection valu
0950: 65 2c 20 69 74 20 69 73 20 67 6c 6f 62 61 6c 20  e, it is global 
0960: 74 6f 20 74 68 65 20 70 72 6f 63 65 73 73 2e 0d  to the process..
0970: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
0980: 72 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ry>..    interna
0990: 6c 20 61 62 73 74 72 61 63 74 20 6c 6f 6e 67 20  l abstract long 
09a0: 4d 65 6d 6f 72 79 48 69 67 68 77 61 74 65 72 20  MemoryHighwater 
09b0: 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f  { get; }..    //
09c0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
09d0: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 6e 6f 6e   /// Returns non
09e0: 2d 7a 65 72 6f 20 69 66 20 74 68 65 20 75 6e 64  -zero if the und
09f0: 65 72 6c 79 69 6e 67 20 6e 61 74 69 76 65 20 63  erlying native c
0a00: 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65  onnection handle
0a10: 20 69 73 20 6f 77 6e 65 64 20 62 79 20 74 68 69   is owned by thi
0a20: 73 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20  s instance...   
0a30: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
0a40: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
0a50: 73 74 72 61 63 74 20 62 6f 6f 6c 20 4f 77 6e 48  stract bool OwnH
0a60: 61 6e 64 6c 65 20 7b 20 67 65 74 3b 20 7d 0d 0a  andle { get; }..
0a70: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
0a80: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53 65 74 73 20  >..    /// Sets 
0a90: 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 74 68  the status of th
0aa0: 65 20 6d 65 6d 6f 72 79 20 75 73 61 67 65 20 74  e memory usage t
0ab0: 72 61 63 6b 69 6e 67 20 73 75 62 73 79 73 74 65  racking subsyste
0ac0: 6d 20 69 6e 20 74 68 65 20 53 51 4c 69 74 65 20  m in the SQLite 
0ad0: 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 20 20 42  core library.  B
0ae0: 79 20 64 65 66 61 75 6c 74 2c 20 74 68 69 73 20  y default, this 
0af0: 69 73 20 65 6e 61 62 6c 65 64 2e 0d 0a 20 20 20  is enabled...   
0b00: 20 2f 2f 2f 20 49 66 20 74 68 69 73 20 69 73 20   /// If this is 
0b10: 64 69 73 61 62 6c 65 64 2c 20 6d 65 6d 6f 72 79  disabled, memory
0b20: 20 75 73 61 67 65 20 74 72 61 63 6b 69 6e 67 20   usage tracking 
0b30: 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 65 72 66  will not be perf
0b40: 6f 72 6d 65 64 2e 20 20 54 68 69 73 20 69 73 20  ormed.  This is 
0b50: 6e 6f 74 20 72 65 61 6c 6c 79 20 61 20 70 65 72  not really a per
0b60: 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 76 61 6c 75  -connection valu
0b70: 65 2c 20 69 74 20 69 73 0d 0a 20 20 20 20 2f 2f  e, it is..    //
0b80: 2f 20 67 6c 6f 62 61 6c 20 74 6f 20 74 68 65 20  / global to the 
0b90: 70 72 6f 63 65 73 73 2e 0d 0a 20 20 20 20 2f 2f  process...    //
0ba0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
0bb0: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d    /// <param nam
0bc0: 65 3d 22 76 61 6c 75 65 22 3e 4e 6f 6e 2d 7a 65  e="value">Non-ze
0bd0: 72 6f 20 74 6f 20 65 6e 61 62 6c 65 20 6d 65 6d  ro to enable mem
0be0: 6f 72 79 20 75 73 61 67 65 20 74 72 61 63 6b 69  ory usage tracki
0bf0: 6e 67 2c 20 7a 65 72 6f 20 6f 74 68 65 72 77 69  ng, zero otherwi
0c00: 73 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  se.</param>..   
0c10: 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 41 20   /// <returns>A 
0c20: 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20  standard SQLite 
0c30: 72 65 74 75 72 6e 20 63 6f 64 65 20 28 69 2e 65  return code (i.e
0c40: 2e 20 7a 65 72 6f 20 66 6f 72 20 73 75 63 63 65  . zero for succe
0c50: 73 73 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20  ss and non-zero 
0c60: 66 6f 72 20 66 61 69 6c 75 72 65 29 2e 3c 2f 72  for failure).</r
0c70: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74  eturns>..    int
0c80: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53  ernal abstract S
0c90: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 53  QLiteErrorCode S
0ca0: 65 74 4d 65 6d 6f 72 79 53 74 61 74 75 73 28 62  etMemoryStatus(b
0cb0: 6f 6f 6c 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20  ool value);..   
0cc0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
0cd0: 20 20 20 20 2f 2f 2f 20 53 68 75 74 64 6f 77 6e      /// Shutdown
0ce0: 20 74 68 65 20 53 51 4c 69 74 65 20 65 6e 67 69   the SQLite engi
0cf0: 6e 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61  ne so that it ca
0d00: 6e 20 62 65 20 72 65 73 74 61 72 74 65 64 20 77  n be restarted w
0d10: 69 74 68 20 64 69 66 66 65 72 65 6e 74 20 63 6f  ith different co
0d20: 6e 66 69 67 20 6f 70 74 69 6f 6e 73 2e 0d 0a 20  nfig options... 
0d30: 20 20 20 2f 2f 2f 20 57 65 20 64 65 70 65 6e 64     /// We depend
0d40: 20 6f 6e 20 61 75 74 6f 20 69 6e 69 74 69 61 6c   on auto initial
0d50: 69 7a 61 74 69 6f 6e 20 74 6f 20 72 65 63 6f 76  ization to recov
0d60: 65 72 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  er...    /// </s
0d70: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e 74  ummary>..    int
0d80: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53  ernal abstract S
0d90: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 53  QLiteErrorCode S
0da0: 68 75 74 64 6f 77 6e 28 29 3b 0d 0a 20 20 20 20  hutdown();..    
0db0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
0dc0: 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 6e     /// Returns n
0dd0: 6f 6e 2d 7a 65 72 6f 20 69 66 20 61 20 64 61 74  on-zero if a dat
0de0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
0df0: 20 69 73 20 6f 70 65 6e 2e 0d 0a 20 20 20 20 2f   is open...    /
0e00: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
0e10: 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e     /// <returns>
0e20: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20  </returns>..    
0e30: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
0e40: 74 20 62 6f 6f 6c 20 49 73 4f 70 65 6e 28 29 3b  t bool IsOpen();
0e50: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
0e60: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 4f 70 65  ry>..    /// Ope
0e70: 6e 73 20 61 20 64 61 74 61 62 61 73 65 2e 0d 0a  ns a database...
0e80: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
0e90: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 6d  y>..    /// <rem
0ea0: 61 72 6b 73 3e 0d 0a 20 20 20 20 2f 2f 2f 20 49  arks>..    /// I
0eb0: 6d 70 6c 65 6d 65 6e 74 65 72 73 20 73 68 6f 75  mplementers shou
0ec0: 6c 64 20 63 61 6c 6c 20 53 51 4c 69 74 65 46 75  ld call SQLiteFu
0ed0: 6e 63 74 69 6f 6e 2e 42 69 6e 64 46 75 6e 63 74  nction.BindFunct
0ee0: 69 6f 6e 73 28 29 20 61 6e 64 20 73 61 76 65 20  ions() and save 
0ef0: 74 68 65 20 61 72 72 61 79 20 61 66 74 65 72 20  the array after 
0f00: 6f 70 65 6e 69 6e 67 20 61 20 63 6f 6e 6e 65 63  opening a connec
0f10: 74 69 6f 6e 0d 0a 20 20 20 20 2f 2f 2f 20 74 6f  tion..    /// to
0f20: 20 62 69 6e 64 20 61 6c 6c 20 61 74 74 72 69 62   bind all attrib
0f30: 75 74 65 64 20 75 73 65 72 2d 64 65 66 69 6e 65  uted user-define
0f40: 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20  d functions and 
0f50: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
0f60: 63 65 73 20 74 6f 20 74 68 65 20 6e 65 77 20 63  ces to the new c
0f70: 6f 6e 6e 65 63 74 69 6f 6e 2e 0d 0a 20 20 20 20  onnection...    
0f80: 2f 2f 2f 20 3c 2f 72 65 6d 61 72 6b 73 3e 0d 0a  /// </remarks>..
0f90: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
0fa0: 61 6d 65 3d 22 73 74 72 46 69 6c 65 6e 61 6d 65  ame="strFilename
0fb0: 22 3e 54 68 65 20 66 69 6c 65 6e 61 6d 65 20 6f  ">The filename o
0fc0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 74  f the database t
0fd0: 6f 20 6f 70 65 6e 2e 20 20 53 51 4c 69 74 65 20  o open.  SQLite 
0fe0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63 72  automatically cr
0ff0: 65 61 74 65 73 20 69 74 20 69 66 20 69 74 20 64  eates it if it d
1000: 6f 65 73 6e 27 74 20 65 78 69 73 74 2e 3c 2f 70  oesn't exist.</p
1010: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
1020: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63 6f 6e 6e  param name="conn
1030: 65 63 74 69 6f 6e 46 6c 61 67 73 22 3e 54 68 65  ectionFlags">The
1040: 20 66 6c 61 67 73 20 61 73 73 6f 63 69 61 74 65   flags associate
1050: 64 20 77 69 74 68 20 74 68 65 20 70 61 72 65 6e  d with the paren
1060: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a  t connection obj
1070: 65 63 74 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  ect</param>..   
1080: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
1090: 3d 22 6f 70 65 6e 46 6c 61 67 73 22 3e 54 68 65  ="openFlags">The
10a0: 20 6f 70 65 6e 20 66 6c 61 67 73 20 74 6f 20 75   open flags to u
10b0: 73 65 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67  se when creating
10c0: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c   the connection<
10d0: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f  /param>..    ///
10e0: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6d 61   <param name="ma
10f0: 78 50 6f 6f 6c 53 69 7a 65 22 3e 54 68 65 20 6d  xPoolSize">The m
1100: 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 74  aximum size of t
1110: 68 65 20 70 6f 6f 6c 20 66 6f 72 20 74 68 65 20  he pool for the 
1120: 67 69 76 65 6e 20 66 69 6c 65 6e 61 6d 65 3c 2f  given filename</
1130: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
1140: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 75 73 65  <param name="use
1150: 50 6f 6f 6c 22 3e 49 66 20 74 72 75 65 2c 20 74  Pool">If true, t
1160: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 63 61  he connection ca
1170: 6e 20 62 65 20 70 75 6c 6c 65 64 20 66 72 6f 6d  n be pulled from
1180: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   the connection 
1190: 70 6f 6f 6c 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  pool</param>..  
11a0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
11b0: 61 63 74 20 76 6f 69 64 20 4f 70 65 6e 28 73 74  act void Open(st
11c0: 72 69 6e 67 20 73 74 72 46 69 6c 65 6e 61 6d 65  ring strFilename
11d0: 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  , SQLiteConnecti
11e0: 6f 6e 46 6c 61 67 73 20 63 6f 6e 6e 65 63 74 69  onFlags connecti
11f0: 6f 6e 46 6c 61 67 73 2c 20 53 51 4c 69 74 65 4f  onFlags, SQLiteO
1200: 70 65 6e 46 6c 61 67 73 45 6e 75 6d 20 6f 70 65  penFlagsEnum ope
1210: 6e 46 6c 61 67 73 2c 20 69 6e 74 20 6d 61 78 50  nFlags, int maxP
1220: 6f 6f 6c 53 69 7a 65 2c 20 62 6f 6f 6c 20 75 73  oolSize, bool us
1230: 65 50 6f 6f 6c 29 3b 0d 0a 20 20 20 20 2f 2f 2f  ePool);..    ///
1240: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
1250: 2f 2f 2f 20 43 6c 6f 73 65 73 20 74 68 65 20 63  /// Closes the c
1260: 75 72 72 65 6e 74 6c 79 2d 6f 70 65 6e 20 64 61  urrently-open da
1270: 74 61 62 61 73 65 2e 0d 0a 20 20 20 20 2f 2f 2f  tabase...    ///
1280: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
1290: 20 2f 2f 2f 20 3c 72 65 6d 61 72 6b 73 3e 0d 0a   /// <remarks>..
12a0: 20 20 20 20 2f 2f 2f 20 41 66 74 65 72 20 74 68      /// After th
12b0: 65 20 64 61 74 61 62 61 73 65 20 68 61 73 20 62  e database has b
12c0: 65 65 6e 20 63 6c 6f 73 65 64 20 69 6d 70 6c 65  een closed imple
12d0: 6d 65 74 65 72 73 20 73 68 6f 75 6c 64 20 63 61  meters should ca
12e0: 6c 6c 20 53 51 4c 69 74 65 46 75 6e 63 74 69 6f  ll SQLiteFunctio
12f0: 6e 2e 55 6e 62 69 6e 64 46 75 6e 63 74 69 6f 6e  n.UnbindFunction
1300: 73 28 29 20 74 6f 20 64 65 61 6c 6c 6f 63 61 74  s() to deallocat
1310: 65 20 61 6c 6c 20 69 6e 74 65 72 6f 70 20 61 6c  e all interop al
1320: 6c 6f 63 61 74 65 64 0d 0a 20 20 20 20 2f 2f 2f  located..    ///
1330: 20 6d 65 6d 6f 72 79 20 61 73 73 6f 63 69 61 74   memory associat
1340: 65 64 20 77 69 74 68 20 74 68 65 20 75 73 65 72  ed with the user
1350: 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f  -defined functio
1360: 6e 73 20 61 6e 64 20 63 6f 6c 6c 61 74 69 6e 67  ns and collating
1370: 20 73 65 71 75 65 6e 63 65 73 20 74 69 65 64 20   sequences tied 
1380: 74 6f 20 74 68 65 20 63 6c 6f 73 65 64 20 63 6f  to the closed co
1390: 6e 6e 65 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 2f  nnection...    /
13a0: 2f 2f 20 3c 2f 72 65 6d 61 72 6b 73 3e 0d 0a 20  // </remarks>.. 
13b0: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61     /// <param na
13c0: 6d 65 3d 22 63 61 6e 54 68 72 6f 77 22 3e 4e 6f  me="canThrow">No
13d0: 6e 2d 7a 65 72 6f 20 69 66 20 74 68 65 20 6f 70  n-zero if the op
13e0: 65 72 61 74 69 6f 6e 20 69 73 20 61 6c 6c 6f 77  eration is allow
13f0: 65 64 20 74 6f 20 74 68 72 6f 77 20 65 78 63 65  ed to throw exce
1400: 70 74 69 6f 6e 73 2c 20 7a 65 72 6f 20 6f 74 68  ptions, zero oth
1410: 65 72 77 69 73 65 2e 3c 2f 70 61 72 61 6d 3e 0d  erwise.</param>.
1420: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
1430: 73 74 72 61 63 74 20 76 6f 69 64 20 43 6c 6f 73  stract void Clos
1440: 65 28 62 6f 6f 6c 20 63 61 6e 54 68 72 6f 77 29  e(bool canThrow)
1450: 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ;..    /// <summ
1460: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53 65  ary>..    /// Se
1470: 74 73 20 74 68 65 20 62 75 73 79 20 74 69 6d 65  ts the busy time
1480: 6f 75 74 20 6f 6e 20 74 68 65 20 63 6f 6e 6e 65  out on the conne
1490: 63 74 69 6f 6e 2e 20 20 53 51 4c 69 74 65 43 6f  ction.  SQLiteCo
14a0: 6d 6d 61 6e 64 20 77 69 6c 6c 20 63 61 6c 6c 20  mmand will call 
14b0: 74 68 69 73 20 62 65 66 6f 72 65 20 65 78 65 63  this before exec
14c0: 75 74 69 6e 67 20 61 6e 79 20 63 6f 6d 6d 61 6e  uting any comman
14d0: 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  d...    /// </su
14e0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
14f0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6e 54 69  <param name="nTi
1500: 6d 65 6f 75 74 4d 53 22 3e 54 68 65 20 6e 75 6d  meoutMS">The num
1510: 62 65 72 20 6f 66 20 6d 69 6c 6c 69 73 65 63 6f  ber of milliseco
1520: 6e 64 73 20 74 6f 20 77 61 69 74 20 62 65 66 6f  nds to wait befo
1530: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 53 51 4c  re returning SQL
1540: 49 54 45 5f 42 55 53 59 3c 2f 70 61 72 61 6d 3e  ITE_BUSY</param>
1550: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
1560: 62 73 74 72 61 63 74 20 76 6f 69 64 20 53 65 74  bstract void Set
1570: 54 69 6d 65 6f 75 74 28 69 6e 74 20 6e 54 69 6d  Timeout(int nTim
1580: 65 6f 75 74 4d 53 29 3b 0d 0a 20 20 20 20 2f 2f  eoutMS);..    //
1590: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
15a0: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65   /// Returns the
15b0: 20 74 65 78 74 20 6f 66 20 74 68 65 20 6c 61 73   text of the las
15c0: 74 20 65 72 72 6f 72 20 69 73 73 75 65 64 20 62  t error issued b
15d0: 79 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 2f 2f  y SQLite..    //
15e0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
15f0: 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 3c    /// <returns><
1600: 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69  /returns>..    i
1610: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
1620: 20 73 74 72 69 6e 67 20 47 65 74 4c 61 73 74 45   string GetLastE
1630: 72 72 6f 72 28 29 3b 0d 0a 0d 0a 20 20 20 20 2f  rror();....    /
1640: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
1650: 20 20 2f 2f 2f 20 57 68 65 6e 20 70 6f 6f 6c 69    /// When pooli
1660: 6e 67 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 66  ng is enabled, f
1670: 6f 72 63 65 20 74 68 69 73 20 63 6f 6e 6e 65 63  orce this connec
1680: 74 69 6f 6e 20 74 6f 20 62 65 20 64 69 73 70 6f  tion to be dispo
1690: 73 65 64 20 72 61 74 68 65 72 20 74 68 61 6e 20  sed rather than 
16a0: 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 65 20  returned to the 
16b0: 70 6f 6f 6c 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  pool..    /// </
16c0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
16d0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
16e0: 76 6f 69 64 20 43 6c 65 61 72 50 6f 6f 6c 28 29  void ClearPool()
16f0: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
1700: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
1710: 57 68 65 6e 20 70 6f 6f 6c 69 6e 67 20 69 73 20  When pooling is 
1720: 65 6e 61 62 6c 65 64 2c 20 72 65 74 75 72 6e 73  enabled, returns
1730: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   the number of p
1740: 6f 6f 6c 20 65 6e 74 72 69 65 73 20 6d 61 74 63  ool entries matc
1750: 68 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74  hing the current
1760: 20 66 69 6c 65 20 6e 61 6d 65 2e 0d 0a 20 20 20   file name...   
1770: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
1780: 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e  .    /// <return
1790: 73 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s>The number of 
17a0: 70 6f 6f 6c 20 65 6e 74 72 69 65 73 20 6d 61 74  pool entries mat
17b0: 63 68 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e  ching the curren
17c0: 74 20 66 69 6c 65 20 6e 61 6d 65 2e 3c 2f 72 65  t file name.</re
17d0: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65  turns>..    inte
17e0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e  rnal abstract in
17f0: 74 20 43 6f 75 6e 74 50 6f 6f 6c 28 29 3b 0d 0a  t CountPool();..
1800: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
1810: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 50 72 65  ry>..    /// Pre
1820: 70 61 72 65 73 20 61 20 53 51 4c 20 73 74 61 74  pares a SQL stat
1830: 65 6d 65 6e 74 20 66 6f 72 20 65 78 65 63 75 74  ement for execut
1840: 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ion...    /// </
1850: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
1860: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63  / <param name="c
1870: 6e 6e 22 3e 54 68 65 20 73 6f 75 72 63 65 20 63  nn">The source c
1880: 6f 6e 6e 65 63 74 69 6f 6e 20 70 72 65 70 61 72  onnection prepar
1890: 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e  ing the command.
18a0: 20 20 43 61 6e 20 62 65 20 6e 75 6c 6c 20 66 6f    Can be null fo
18b0: 72 20 61 6e 79 20 63 61 6c 6c 65 72 20 65 78 63  r any caller exc
18c0: 65 70 74 20 4c 49 4e 51 3c 2f 70 61 72 61 6d 3e  ept LINQ</param>
18d0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
18e0: 20 6e 61 6d 65 3d 22 73 74 72 53 71 6c 22 3e 54   name="strSql">T
18f0: 68 65 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 20 74  he SQL command t
1900: 65 78 74 20 74 6f 20 70 72 65 70 61 72 65 3c 2f  ext to prepare</
1910: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
1920: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 72 65  <param name="pre
1930: 76 69 6f 75 73 22 3e 54 68 65 20 70 72 65 76 69  vious">The previ
1940: 6f 75 73 20 73 74 61 74 65 6d 65 6e 74 20 69 6e  ous statement in
1950: 20 61 20 6d 75 6c 74 69 2d 73 74 61 74 65 6d 65   a multi-stateme
1960: 6e 74 20 63 6f 6d 6d 61 6e 64 2c 20 6f 72 20 6e  nt command, or n
1970: 75 6c 6c 20 69 66 20 6e 6f 20 70 72 65 76 69 6f  ull if no previo
1980: 75 73 20 73 74 61 74 65 6d 65 6e 74 20 65 78 69  us statement exi
1990: 73 74 73 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  sts</param>..   
19a0: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
19b0: 3d 22 74 69 6d 65 6f 75 74 4d 53 22 3e 54 68 65  ="timeoutMS">The
19c0: 20 74 69 6d 65 6f 75 74 20 74 6f 20 77 61 69 74   timeout to wait
19d0: 20 62 65 66 6f 72 65 20 61 62 6f 72 74 69 6e 67   before aborting
19e0: 20 74 68 65 20 70 72 65 70 61 72 65 3c 2f 70 61   the prepare</pa
19f0: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ram>..    /// <p
1a00: 61 72 61 6d 20 6e 61 6d 65 3d 22 73 74 72 52 65  aram name="strRe
1a10: 6d 61 69 6e 22 3e 54 68 65 20 72 65 6d 61 69 6e  main">The remain
1a20: 64 65 72 20 6f 66 20 74 68 65 20 73 74 61 74 65  der of the state
1a30: 6d 65 6e 74 20 74 68 61 74 20 77 61 73 20 6e 6f  ment that was no
1a40: 74 20 70 72 6f 63 65 73 73 65 64 2e 20 20 45 61  t processed.  Ea
1a50: 63 68 20 63 61 6c 6c 20 74 6f 20 70 72 65 70 61  ch call to prepa
1a60: 72 65 20 70 61 72 73 65 73 20 74 68 65 0d 0a 20  re parses the.. 
1a70: 20 20 20 2f 2f 2f 20 53 51 4c 20 75 70 20 74 6f     /// SQL up to
1a80: 20 74 6f 20 65 69 74 68 65 72 20 74 68 65 20 65   to either the e
1a90: 6e 64 20 6f 66 20 74 68 65 20 74 65 78 74 20 6f  nd of the text o
1aa0: 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 73  r to the first s
1ab0: 65 6d 69 2d 63 6f 6c 6f 6e 20 64 65 6c 69 6d 69  emi-colon delimi
1ac0: 74 65 72 2e 20 20 54 68 65 20 72 65 6d 61 69 6e  ter.  The remain
1ad0: 69 6e 67 20 74 65 78 74 20 69 73 20 72 65 74 75  ing text is retu
1ae0: 72 6e 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 68 65  rned..    /// he
1af0: 72 65 20 66 6f 72 20 61 20 73 75 62 73 65 71 75  re for a subsequ
1b00: 65 6e 74 20 63 61 6c 6c 20 74 6f 20 50 72 65 70  ent call to Prep
1b10: 61 72 65 28 29 20 75 6e 74 69 6c 20 61 6c 6c 20  are() until all 
1b20: 74 68 65 20 74 65 78 74 20 68 61 73 20 62 65 65  the text has bee
1b30: 6e 20 70 72 6f 63 65 73 73 65 64 2e 3c 2f 70 61  n processed.</pa
1b40: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72  ram>..    /// <r
1b50: 65 74 75 72 6e 73 3e 52 65 74 75 72 6e 73 20 61  eturns>Returns a
1b60: 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 53 51  n initialized SQ
1b70: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 2e 3c 2f  LiteStatement.</
1b80: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e  returns>..    in
1b90: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
1ba0: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
1bb0: 50 72 65 70 61 72 65 28 53 51 4c 69 74 65 43 6f  Prepare(SQLiteCo
1bc0: 6e 6e 65 63 74 69 6f 6e 20 63 6e 6e 2c 20 73 74  nnection cnn, st
1bd0: 72 69 6e 67 20 73 74 72 53 71 6c 2c 20 53 51 4c  ring strSql, SQL
1be0: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 70 72 65  iteStatement pre
1bf0: 76 69 6f 75 73 2c 20 75 69 6e 74 20 74 69 6d 65  vious, uint time
1c00: 6f 75 74 4d 53 2c 20 6f 75 74 20 73 74 72 69 6e  outMS, out strin
1c10: 67 20 73 74 72 52 65 6d 61 69 6e 29 3b 0d 0a 20  g strRemain);.. 
1c20: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
1c30: 0d 0a 20 20 20 20 2f 2f 2f 20 53 74 65 70 73 20  ..    /// Steps 
1c40: 74 68 72 6f 75 67 68 20 61 20 70 72 65 70 61 72  through a prepar
1c50: 65 64 20 73 74 61 74 65 6d 65 6e 74 2e 0d 0a 20  ed statement... 
1c60: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
1c70: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61  >..    /// <para
1c80: 6d 20 6e 61 6d 65 3d 22 73 74 6d 74 22 3e 54 68  m name="stmt">Th
1c90: 65 20 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  e SQLiteStatemen
1ca0: 74 20 74 6f 20 73 74 65 70 20 74 68 72 6f 75 67  t to step throug
1cb0: 68 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f  h</param>..    /
1cc0: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54 72 75 65  // <returns>True
1cd0: 20 69 66 20 61 20 72 6f 77 20 77 61 73 20 72 65   if a row was re
1ce0: 74 75 72 6e 65 64 2c 20 46 61 6c 73 65 20 69 66  turned, False if
1cf0: 20 6e 6f 74 2e 3c 2f 72 65 74 75 72 6e 73 3e 0d   not.</returns>.
1d00: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
1d10: 73 74 72 61 63 74 20 62 6f 6f 6c 20 53 74 65 70  stract bool Step
1d20: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
1d30: 20 73 74 6d 74 29 3b 0d 0a 20 20 20 20 2f 2f 2f   stmt);..    ///
1d40: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
1d50: 2f 2f 2f 20 52 65 73 65 74 73 20 61 20 70 72 65  /// Resets a pre
1d60: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
1d70: 73 6f 20 69 74 20 63 61 6e 20 62 65 20 65 78 65  so it can be exe
1d80: 63 75 74 65 64 20 61 67 61 69 6e 2e 20 20 49 66  cuted again.  If
1d90: 20 74 68 65 20 65 72 72 6f 72 20 72 65 74 75 72   the error retur
1da0: 6e 65 64 20 69 73 20 53 51 4c 49 54 45 5f 53 43  ned is SQLITE_SC
1db0: 48 45 4d 41 2c 20 0d 0a 20 20 20 20 2f 2f 2f 20  HEMA, ..    /// 
1dc0: 74 72 61 6e 73 70 61 72 65 6e 74 6c 79 20 61 74  transparently at
1dd0: 74 65 6d 70 74 20 74 6f 20 72 65 62 75 69 6c 64  tempt to rebuild
1de0: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65   the SQL stateme
1df0: 6e 74 20 61 6e 64 20 74 68 72 6f 77 20 61 6e 20  nt and throw an 
1e00: 65 72 72 6f 72 20 69 66 20 74 68 61 74 20 77 61  error if that wa
1e10: 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 2e 0d  s not possible..
1e20: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
1e30: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61  ry>..    /// <pa
1e40: 72 61 6d 20 6e 61 6d 65 3d 22 73 74 6d 74 22 3e  ram name="stmt">
1e50: 54 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 6f  The statement to
1e60: 20 72 65 73 65 74 3c 2f 70 61 72 61 6d 3e 0d 0a   reset</param>..
1e70: 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73      /// <returns
1e80: 3e 52 65 74 75 72 6e 73 20 2d 31 20 69 66 20 74  >Returns -1 if t
1e90: 68 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  he schema change
1ea0: 64 20 77 68 69 6c 65 20 72 65 73 65 74 74 69 6e  d while resettin
1eb0: 67 2c 20 30 20 69 66 20 74 68 65 20 72 65 73 65  g, 0 if the rese
1ec0: 74 20 77 61 73 20 73 75 63 65 73 73 66 75 6c 20  t was sucessful 
1ed0: 6f 72 20 36 20 28 53 51 4c 49 54 45 5f 4c 4f 43  or 6 (SQLITE_LOC
1ee0: 4b 45 44 29 20 69 66 20 74 68 65 20 72 65 73 65  KED) if the rese
1ef0: 74 20 66 61 69 6c 65 64 20 64 75 65 20 74 6f 20  t failed due to 
1f00: 61 20 6c 6f 63 6b 3c 2f 72 65 74 75 72 6e 73 3e  a lock</returns>
1f10: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
1f20: 62 73 74 72 61 63 74 20 53 51 4c 69 74 65 45 72  bstract SQLiteEr
1f30: 72 6f 72 43 6f 64 65 20 52 65 73 65 74 28 53 51  rorCode Reset(SQ
1f40: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74  LiteStatement st
1f50: 6d 74 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  mt);..    intern
1f60: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
1f70: 20 43 61 6e 63 65 6c 28 29 3b 0d 0a 0d 0a 20 20   Cancel();....  
1f80: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
1f90: 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f 44 6f  act void Bind_Do
1fa0: 75 62 6c 65 28 53 51 4c 69 74 65 53 74 61 74 65  uble(SQLiteState
1fb0: 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74  ment stmt, SQLit
1fc0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
1fd0: 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65   flags, int inde
1fe0: 78 2c 20 64 6f 75 62 6c 65 20 76 61 6c 75 65 29  x, double value)
1ff0: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
2000: 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42 69  abstract void Bi
2010: 6e 64 5f 49 6e 74 33 32 28 53 51 4c 69 74 65 53  nd_Int32(SQLiteS
2020: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53  tatement stmt, S
2030: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46  QLiteConnectionF
2040: 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20  lags flags, int 
2050: 69 6e 64 65 78 2c 20 49 6e 74 33 32 20 76 61 6c  index, Int32 val
2060: 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ue);..    intern
2070: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
2080: 20 42 69 6e 64 5f 55 49 6e 74 33 32 28 53 51 4c   Bind_UInt32(SQL
2090: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
20a0: 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  t, SQLiteConnect
20b0: 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20  ionFlags flags, 
20c0: 69 6e 74 20 69 6e 64 65 78 2c 20 55 49 6e 74 33  int index, UInt3
20d0: 32 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69  2 value);..    i
20e0: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
20f0: 20 76 6f 69 64 20 42 69 6e 64 5f 49 6e 74 36 34   void Bind_Int64
2100: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
2110: 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e   stmt, SQLiteCon
2120: 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61  nectionFlags fla
2130: 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20 49  gs, int index, I
2140: 6e 74 36 34 20 76 61 6c 75 65 29 3b 0d 0a 20 20  nt64 value);..  
2150: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2160: 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f 55 49  act void Bind_UI
2170: 6e 74 36 34 28 53 51 4c 69 74 65 53 74 61 74 65  nt64(SQLiteState
2180: 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74  ment stmt, SQLit
2190: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
21a0: 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65   flags, int inde
21b0: 78 2c 20 55 49 6e 74 36 34 20 76 61 6c 75 65 29  x, UInt64 value)
21c0: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
21d0: 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42 69  abstract void Bi
21e0: 6e 64 5f 54 65 78 74 28 53 51 4c 69 74 65 53 74  nd_Text(SQLiteSt
21f0: 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51  atement stmt, SQ
2200: 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c  LiteConnectionFl
2210: 61 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69  ags flags, int i
2220: 6e 64 65 78 2c 20 73 74 72 69 6e 67 20 76 61 6c  ndex, string val
2230: 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ue);..    intern
2240: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
2250: 20 42 69 6e 64 5f 42 6c 6f 62 28 53 51 4c 69 74   Bind_Blob(SQLit
2260: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2270: 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f   SQLiteConnectio
2280: 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e  nFlags flags, in
2290: 74 20 69 6e 64 65 78 2c 20 62 79 74 65 5b 5d 20  t index, byte[] 
22a0: 62 6c 6f 62 44 61 74 61 29 3b 0d 0a 20 20 20 20  blobData);..    
22b0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
22c0: 74 20 76 6f 69 64 20 42 69 6e 64 5f 44 61 74 65  t void Bind_Date
22d0: 54 69 6d 65 28 53 51 4c 69 74 65 53 74 61 74 65  Time(SQLiteState
22e0: 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74  ment stmt, SQLit
22f0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
2300: 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65   flags, int inde
2310: 78 2c 20 44 61 74 65 54 69 6d 65 20 64 74 29 3b  x, DateTime dt);
2320: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2330: 62 73 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e  bstract void Bin
2340: 64 5f 4e 75 6c 6c 28 53 51 4c 69 74 65 53 74 61  d_Null(SQLiteSta
2350: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c  tement stmt, SQL
2360: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
2370: 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e  gs flags, int in
2380: 64 65 78 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74  dex);....    int
2390: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69  ernal abstract i
23a0: 6e 74 20 42 69 6e 64 5f 50 61 72 61 6d 43 6f 75  nt Bind_ParamCou
23b0: 6e 74 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  nt(SQLiteStateme
23c0: 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43  nt stmt, SQLiteC
23d0: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66  onnectionFlags f
23e0: 6c 61 67 73 29 3b 0d 0a 20 20 20 20 69 6e 74 65  lags);..    inte
23f0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 73 74  rnal abstract st
2400: 72 69 6e 67 20 42 69 6e 64 5f 50 61 72 61 6d 4e  ring Bind_ParamN
2410: 61 6d 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d  ame(SQLiteStatem
2420: 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65  ent stmt, SQLite
2430: 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20  ConnectionFlags 
2440: 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78  flags, int index
2450: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2460: 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 42 69   abstract int Bi
2470: 6e 64 5f 50 61 72 61 6d 49 6e 64 65 78 28 53 51  nd_ParamIndex(SQ
2480: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74  LiteStatement st
2490: 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63  mt, SQLiteConnec
24a0: 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c  tionFlags flags,
24b0: 20 73 74 72 69 6e 67 20 70 61 72 61 6d 4e 61 6d   string paramNam
24c0: 65 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72  e);....    inter
24d0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
24e0: 20 43 6f 6c 75 6d 6e 43 6f 75 6e 74 28 53 51 4c   ColumnCount(SQL
24f0: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
2500: 74 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  t);..    interna
2510: 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e  l abstract strin
2520: 67 20 43 6f 6c 75 6d 6e 4e 61 6d 65 28 53 51 4c  g ColumnName(SQL
2530: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
2540: 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a  t, int index);..
2550: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2560: 74 72 61 63 74 20 54 79 70 65 41 66 66 69 6e 69  tract TypeAffini
2570: 74 79 20 43 6f 6c 75 6d 6e 41 66 66 69 6e 69 74  ty ColumnAffinit
2580: 79 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  y(SQLiteStatemen
2590: 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65  t stmt, int inde
25a0: 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  x);..    interna
25b0: 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e  l abstract strin
25c0: 67 20 43 6f 6c 75 6d 6e 54 79 70 65 28 53 51 4c  g ColumnType(SQL
25d0: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
25e0: 74 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20 6f 75  t, int index, ou
25f0: 74 20 54 79 70 65 41 66 66 69 6e 69 74 79 20 6e  t TypeAffinity n
2600: 41 66 66 69 6e 69 74 79 29 3b 0d 0a 20 20 20 20  Affinity);..    
2610: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
2620: 74 20 69 6e 74 20 43 6f 6c 75 6d 6e 49 6e 64 65  t int ColumnInde
2630: 78 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  x(SQLiteStatemen
2640: 74 20 73 74 6d 74 2c 20 73 74 72 69 6e 67 20 63  t stmt, string c
2650: 6f 6c 75 6d 6e 4e 61 6d 65 29 3b 0d 0a 20 20 20  olumnName);..   
2660: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
2670: 63 74 20 73 74 72 69 6e 67 20 43 6f 6c 75 6d 6e  ct string Column
2680: 4f 72 69 67 69 6e 61 6c 4e 61 6d 65 28 53 51 4c  OriginalName(SQL
2690: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
26a0: 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a  t, int index);..
26b0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
26c0: 74 72 61 63 74 20 73 74 72 69 6e 67 20 43 6f 6c  tract string Col
26d0: 75 6d 6e 44 61 74 61 62 61 73 65 4e 61 6d 65 28  umnDatabaseName(
26e0: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
26f0: 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29  stmt, int index)
2700: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
2710: 61 62 73 74 72 61 63 74 20 73 74 72 69 6e 67 20  abstract string 
2720: 43 6f 6c 75 6d 6e 54 61 62 6c 65 4e 61 6d 65 28  ColumnTableName(
2730: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
2740: 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29  stmt, int index)
2750: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
2760: 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 43 6f  abstract void Co
2770: 6c 75 6d 6e 4d 65 74 61 44 61 74 61 28 73 74 72  lumnMetaData(str
2780: 69 6e 67 20 64 61 74 61 42 61 73 65 2c 20 73 74  ing dataBase, st
2790: 72 69 6e 67 20 74 61 62 6c 65 2c 20 73 74 72 69  ring table, stri
27a0: 6e 67 20 63 6f 6c 75 6d 6e 2c 20 6f 75 74 20 73  ng column, out s
27b0: 74 72 69 6e 67 20 64 61 74 61 54 79 70 65 2c 20  tring dataType, 
27c0: 6f 75 74 20 73 74 72 69 6e 67 20 63 6f 6c 6c 61  out string colla
27d0: 74 65 53 65 71 75 65 6e 63 65 2c 20 6f 75 74 20  teSequence, out 
27e0: 62 6f 6f 6c 20 6e 6f 74 4e 75 6c 6c 2c 20 6f 75  bool notNull, ou
27f0: 74 20 62 6f 6f 6c 20 70 72 69 6d 61 72 79 4b 65  t bool primaryKe
2800: 79 2c 20 6f 75 74 20 62 6f 6f 6c 20 61 75 74 6f  y, out bool auto
2810: 49 6e 63 72 65 6d 65 6e 74 29 3b 0d 0a 20 20 20  Increment);..   
2820: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
2830: 63 74 20 76 6f 69 64 20 47 65 74 49 6e 64 65 78  ct void GetIndex
2840: 43 6f 6c 75 6d 6e 45 78 74 65 6e 64 65 64 49 6e  ColumnExtendedIn
2850: 66 6f 28 73 74 72 69 6e 67 20 64 61 74 61 62 61  fo(string databa
2860: 73 65 2c 20 73 74 72 69 6e 67 20 69 6e 64 65 78  se, string index
2870: 2c 20 73 74 72 69 6e 67 20 63 6f 6c 75 6d 6e 2c  , string column,
2880: 20 6f 75 74 20 69 6e 74 20 73 6f 72 74 4d 6f 64   out int sortMod
2890: 65 2c 20 6f 75 74 20 69 6e 74 20 6f 6e 45 72 72  e, out int onErr
28a0: 6f 72 2c 20 6f 75 74 20 73 74 72 69 6e 67 20 63  or, out string c
28b0: 6f 6c 6c 61 74 69 6f 6e 53 65 71 75 65 6e 63 65  ollationSequence
28c0: 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e  );....    intern
28d0: 61 6c 20 61 62 73 74 72 61 63 74 20 64 6f 75 62  al abstract doub
28e0: 6c 65 20 47 65 74 44 6f 75 62 6c 65 28 53 51 4c  le GetDouble(SQL
28f0: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
2900: 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a  t, int index);..
2910: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2920: 74 72 61 63 74 20 53 42 79 74 65 20 47 65 74 53  tract SByte GetS
2930: 42 79 74 65 28 53 51 4c 69 74 65 53 74 61 74 65  Byte(SQLiteState
2940: 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69  ment stmt, int i
2950: 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65  ndex);..    inte
2960: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 42 79  rnal abstract By
2970: 74 65 20 47 65 74 42 79 74 65 28 53 51 4c 69 74  te GetByte(SQLit
2980: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2990: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
29a0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
29b0: 61 63 74 20 49 6e 74 31 36 20 47 65 74 49 6e 74  act Int16 GetInt
29c0: 31 36 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  16(SQLiteStateme
29d0: 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64  nt stmt, int ind
29e0: 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ex);..    intern
29f0: 61 6c 20 61 62 73 74 72 61 63 74 20 55 49 6e 74  al abstract UInt
2a00: 31 36 20 47 65 74 55 49 6e 74 31 36 28 53 51 4c  16 GetUInt16(SQL
2a10: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
2a20: 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a  t, int index);..
2a30: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2a40: 74 72 61 63 74 20 49 6e 74 33 32 20 47 65 74 49  tract Int32 GetI
2a50: 6e 74 33 32 28 53 51 4c 69 74 65 53 74 61 74 65  nt32(SQLiteState
2a60: 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69  ment stmt, int i
2a70: 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65  ndex);..    inte
2a80: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 55 49  rnal abstract UI
2a90: 6e 74 33 32 20 47 65 74 55 49 6e 74 33 32 28 53  nt32 GetUInt32(S
2aa0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2ab0: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
2ac0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2ad0: 62 73 74 72 61 63 74 20 49 6e 74 36 34 20 47 65  bstract Int64 Ge
2ae0: 74 49 6e 74 36 34 28 53 51 4c 69 74 65 53 74 61  tInt64(SQLiteSta
2af0: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74  tement stmt, int
2b00: 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e   index);..    in
2b10: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2b20: 55 49 6e 74 36 34 20 47 65 74 55 49 6e 74 36 34  UInt64 GetUInt64
2b30: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
2b40: 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78   stmt, int index
2b50: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2b60: 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e 67   abstract string
2b70: 20 47 65 74 54 65 78 74 28 53 51 4c 69 74 65 53   GetText(SQLiteS
2b80: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69  tatement stmt, i
2b90: 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20  nt index);..    
2ba0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
2bb0: 74 20 6c 6f 6e 67 20 47 65 74 42 79 74 65 73 28  t long GetBytes(
2bc0: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
2bd0: 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 2c  stmt, int index,
2be0: 20 69 6e 74 20 6e 44 61 74 61 6f 66 66 73 65 74   int nDataoffset
2bf0: 2c 20 62 79 74 65 5b 5d 20 62 44 65 73 74 2c 20  , byte[] bDest, 
2c00: 69 6e 74 20 6e 53 74 61 72 74 2c 20 69 6e 74 20  int nStart, int 
2c10: 6e 4c 65 6e 67 74 68 29 3b 0d 0a 20 20 20 20 69  nLength);..    i
2c20: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
2c30: 20 6c 6f 6e 67 20 47 65 74 43 68 61 72 73 28 53   long GetChars(S
2c40: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2c50: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20  tmt, int index, 
2c60: 69 6e 74 20 6e 44 61 74 61 6f 66 66 73 65 74 2c  int nDataoffset,
2c70: 20 63 68 61 72 5b 5d 20 62 44 65 73 74 2c 20 69   char[] bDest, i
2c80: 6e 74 20 6e 53 74 61 72 74 2c 20 69 6e 74 20 6e  nt nStart, int n
2c90: 4c 65 6e 67 74 68 29 3b 0d 0a 20 20 20 20 69 6e  Length);..    in
2ca0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2cb0: 44 61 74 65 54 69 6d 65 20 47 65 74 44 61 74 65  DateTime GetDate
2cc0: 54 69 6d 65 28 53 51 4c 69 74 65 53 74 61 74 65  Time(SQLiteState
2cd0: 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69  ment stmt, int i
2ce0: 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65  ndex);..    inte
2cf0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 62 6f  rnal abstract bo
2d00: 6f 6c 20 49 73 4e 75 6c 6c 28 53 51 4c 69 74 65  ol IsNull(SQLite
2d10: 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20  Statement stmt, 
2d20: 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 0d 0a 20  int index);.... 
2d30: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2d40: 72 61 63 74 20 76 6f 69 64 20 43 72 65 61 74 65  ract void Create
2d50: 43 6f 6c 6c 61 74 69 6f 6e 28 73 74 72 69 6e 67  Collation(string
2d60: 20 73 74 72 43 6f 6c 6c 61 74 69 6f 6e 2c 20 53   strCollation, S
2d70: 51 4c 69 74 65 43 6f 6c 6c 61 74 69 6f 6e 20 66  QLiteCollation f
2d80: 75 6e 63 2c 20 53 51 4c 69 74 65 43 6f 6c 6c 61  unc, SQLiteColla
2d90: 74 69 6f 6e 20 66 75 6e 63 31 36 29 3b 0d 0a 20  tion func16);.. 
2da0: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2db0: 72 61 63 74 20 76 6f 69 64 20 43 72 65 61 74 65  ract void Create
2dc0: 46 75 6e 63 74 69 6f 6e 28 73 74 72 69 6e 67 20  Function(string 
2dd0: 73 74 72 46 75 6e 63 74 69 6f 6e 2c 20 69 6e 74  strFunction, int
2de0: 20 6e 41 72 67 73 2c 20 62 6f 6f 6c 20 6e 65 65   nArgs, bool nee
2df0: 64 43 6f 6c 6c 53 65 71 2c 20 53 51 4c 69 74 65  dCollSeq, SQLite
2e00: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 2c 20 53  Callback func, S
2e10: 51 4c 69 74 65 43 61 6c 6c 62 61 63 6b 20 66 75  QLiteCallback fu
2e20: 6e 63 73 74 65 70 2c 20 53 51 4c 69 74 65 46 69  ncstep, SQLiteFi
2e30: 6e 61 6c 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63  nalCallback func
2e40: 66 69 6e 61 6c 29 3b 0d 0a 20 20 20 20 69 6e 74  final);..    int
2e50: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 43  ernal abstract C
2e60: 6f 6c 6c 61 74 69 6f 6e 53 65 71 75 65 6e 63 65  ollationSequence
2e70: 20 47 65 74 43 6f 6c 6c 61 74 69 6f 6e 53 65 71   GetCollationSeq
2e80: 75 65 6e 63 65 28 53 51 4c 69 74 65 46 75 6e 63  uence(SQLiteFunc
2e90: 74 69 6f 6e 20 66 75 6e 63 2c 20 49 6e 74 50 74  tion func, IntPt
2ea0: 72 20 63 6f 6e 74 65 78 74 29 3b 0d 0a 20 20 20  r context);..   
2eb0: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
2ec0: 63 74 20 69 6e 74 20 43 6f 6e 74 65 78 74 43 6f  ct int ContextCo
2ed0: 6c 6c 61 74 65 43 6f 6d 70 61 72 65 28 43 6f 6c  llateCompare(Col
2ee0: 6c 61 74 69 6f 6e 45 6e 63 6f 64 69 6e 67 45 6e  lationEncodingEn
2ef0: 75 6d 20 65 6e 63 2c 20 49 6e 74 50 74 72 20 63  um enc, IntPtr c
2f00: 6f 6e 74 65 78 74 2c 20 73 74 72 69 6e 67 20 73  ontext, string s
2f10: 31 2c 20 73 74 72 69 6e 67 20 73 32 29 3b 0d 0a  1, string s2);..
2f20: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2f30: 74 72 61 63 74 20 69 6e 74 20 43 6f 6e 74 65 78  tract int Contex
2f40: 74 43 6f 6c 6c 61 74 65 43 6f 6d 70 61 72 65 28  tCollateCompare(
2f50: 43 6f 6c 6c 61 74 69 6f 6e 45 6e 63 6f 64 69 6e  CollationEncodin
2f60: 67 45 6e 75 6d 20 65 6e 63 2c 20 49 6e 74 50 74  gEnum enc, IntPt
2f70: 72 20 63 6f 6e 74 65 78 74 2c 20 63 68 61 72 5b  r context, char[
2f80: 5d 20 63 31 2c 20 63 68 61 72 5b 5d 20 63 32 29  ] c1, char[] c2)
2f90: 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ;....    interna
2fa0: 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 41  l abstract int A
2fb0: 67 67 72 65 67 61 74 65 43 6f 75 6e 74 28 49 6e  ggregateCount(In
2fc0: 74 50 74 72 20 63 6f 6e 74 65 78 74 29 3b 0d 0a  tPtr context);..
2fd0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2fe0: 74 72 61 63 74 20 49 6e 74 50 74 72 20 41 67 67  tract IntPtr Agg
2ff0: 72 65 67 61 74 65 43 6f 6e 74 65 78 74 28 49 6e  regateContext(In
3000: 74 50 74 72 20 63 6f 6e 74 65 78 74 29 3b 0d 0a  tPtr context);..
3010: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
3020: 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 47 65 74  bstract long Get
3030: 50 61 72 61 6d 56 61 6c 75 65 42 79 74 65 73 28  ParamValueBytes(
3040: 49 6e 74 50 74 72 20 70 74 72 2c 20 69 6e 74 20  IntPtr ptr, int 
3050: 6e 44 61 74 61 4f 66 66 73 65 74 2c 20 62 79 74  nDataOffset, byt
3060: 65 5b 5d 20 62 44 65 73 74 2c 20 69 6e 74 20 6e  e[] bDest, int n
3070: 53 74 61 72 74 2c 20 69 6e 74 20 6e 4c 65 6e 67  Start, int nLeng
3080: 74 68 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  th);..    intern
3090: 61 6c 20 61 62 73 74 72 61 63 74 20 64 6f 75 62  al abstract doub
30a0: 6c 65 20 47 65 74 50 61 72 61 6d 56 61 6c 75 65  le GetParamValue
30b0: 44 6f 75 62 6c 65 28 49 6e 74 50 74 72 20 70 74  Double(IntPtr pt
30c0: 72 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  r);..    interna
30d0: 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 47  l abstract int G
30e0: 65 74 50 61 72 61 6d 56 61 6c 75 65 49 6e 74 33  etParamValueInt3
30f0: 32 28 49 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a  2(IntPtr ptr);..
3100: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
3110: 74 72 61 63 74 20 49 6e 74 36 34 20 47 65 74 50  tract Int64 GetP
3120: 61 72 61 6d 56 61 6c 75 65 49 6e 74 36 34 28 49  aramValueInt64(I
3130: 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a 20 20 20  ntPtr ptr);..   
3140: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
3150: 63 74 20 73 74 72 69 6e 67 20 47 65 74 50 61 72  ct string GetPar
3160: 61 6d 56 61 6c 75 65 54 65 78 74 28 49 6e 74 50  amValueText(IntP
3170: 74 72 20 70 74 72 29 3b 0d 0a 20 20 20 20 69 6e  tr ptr);..    in
3180: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3190: 54 79 70 65 41 66 66 69 6e 69 74 79 20 47 65 74  TypeAffinity Get
31a0: 50 61 72 61 6d 56 61 6c 75 65 54 79 70 65 28 49  ParamValueType(I
31b0: 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a 0d 0a 20  ntPtr ptr);.... 
31c0: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
31d0: 72 61 63 74 20 76 6f 69 64 20 52 65 74 75 72 6e  ract void Return
31e0: 42 6c 6f 62 28 49 6e 74 50 74 72 20 63 6f 6e 74  Blob(IntPtr cont
31f0: 65 78 74 2c 20 62 79 74 65 5b 5d 20 76 61 6c 75  ext, byte[] valu
3200: 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  e);..    interna
3210: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
3220: 52 65 74 75 72 6e 44 6f 75 62 6c 65 28 49 6e 74  ReturnDouble(Int
3230: 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 64 6f 75  Ptr context, dou
3240: 62 6c 65 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20  ble value);..   
3250: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
3260: 63 74 20 76 6f 69 64 20 52 65 74 75 72 6e 45 72  ct void ReturnEr
3270: 72 6f 72 28 49 6e 74 50 74 72 20 63 6f 6e 74 65  ror(IntPtr conte
3280: 78 74 2c 20 73 74 72 69 6e 67 20 76 61 6c 75 65  xt, string value
3290: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
32a0: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 52   abstract void R
32b0: 65 74 75 72 6e 49 6e 74 33 32 28 49 6e 74 50 74  eturnInt32(IntPt
32c0: 72 20 63 6f 6e 74 65 78 74 2c 20 49 6e 74 33 32  r context, Int32
32d0: 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e   value);..    in
32e0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
32f0: 76 6f 69 64 20 52 65 74 75 72 6e 49 6e 74 36 34  void ReturnInt64
3300: 28 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 2c  (IntPtr context,
3310: 20 49 6e 74 36 34 20 76 61 6c 75 65 29 3b 0d 0a   Int64 value);..
3320: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
3330: 74 72 61 63 74 20 76 6f 69 64 20 52 65 74 75 72  tract void Retur
3340: 6e 4e 75 6c 6c 28 49 6e 74 50 74 72 20 63 6f 6e  nNull(IntPtr con
3350: 74 65 78 74 29 3b 0d 0a 20 20 20 20 69 6e 74 65  text);..    inte
3360: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
3370: 69 64 20 52 65 74 75 72 6e 54 65 78 74 28 49 6e  id ReturnText(In
3380: 74 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 73 74  tPtr context, st
3390: 72 69 6e 67 20 76 61 6c 75 65 29 3b 0d 0a 0d 0a  ring value);....
33a0: 23 69 66 20 49 4e 54 45 52 4f 50 5f 56 49 52 54  #if INTEROP_VIRT
33b0: 55 41 4c 5f 54 41 42 4c 45 0d 0a 20 20 20 20 2f  UAL_TABLE..    /
33c0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
33d0: 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 74 68 65 20    /// Calls the 
33e0: 6e 61 74 69 76 65 20 53 51 4c 69 74 65 20 63 6f  native SQLite co
33f0: 72 65 20 6c 69 62 72 61 72 79 20 69 6e 20 6f 72  re library in or
3400: 64 65 72 20 74 6f 20 63 72 65 61 74 65 20 61 20  der to create a 
3410: 64 69 73 70 6f 73 61 62 6c 65 0d 0a 20 20 20 20  disposable..    
3420: 2f 2f 2f 20 6d 6f 64 75 6c 65 20 63 6f 6e 74 61  /// module conta
3430: 69 6e 69 6e 67 20 74 68 65 20 69 6d 70 6c 65 6d  ining the implem
3440: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 20 76 69  entation of a vi
3450: 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20  rtual table...  
3460: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
3470: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
3480: 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e 0d   name="module">.
3490: 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6d 6f 64  .    /// The mod
34a0: 75 6c 65 20 6f 62 6a 65 63 74 20 74 6f 20 62 65  ule object to be
34b0: 20 75 73 65 64 20 77 68 65 6e 20 63 72 65 61 74   used when creat
34c0: 69 6e 67 20 74 68 65 20 6e 61 74 69 76 65 20 64  ing the native d
34d0: 69 73 70 6f 73 61 62 6c 65 20 6d 6f 64 75 6c 65  isposable module
34e0: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72  ...    /// </par
34f0: 61 6d 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  am>..    interna
3500: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
3510: 43 72 65 61 74 65 4d 6f 64 75 6c 65 28 53 51 4c  CreateModule(SQL
3520: 69 74 65 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65  iteModule module
3530: 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73  );....    /// <s
3540: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
3550: 20 43 61 6c 6c 73 20 74 68 65 20 6e 61 74 69 76   Calls the nativ
3560: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69  e SQLite core li
3570: 62 72 61 72 79 20 69 6e 20 6f 72 64 65 72 20 74  brary in order t
3580: 6f 20 63 6c 65 61 6e 75 70 20 74 68 65 20 72 65  o cleanup the re
3590: 73 6f 75 72 63 65 73 0d 0a 20 20 20 20 2f 2f 2f  sources..    ///
35a0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
35b0: 20 61 20 6d 6f 64 75 6c 65 20 63 6f 6e 74 61 69   a module contai
35c0: 6e 69 6e 67 20 74 68 65 20 69 6d 70 6c 65 6d 65  ning the impleme
35d0: 6e 74 61 74 69 6f 6e 20 6f 66 20 61 20 76 69 72  ntation of a vir
35e0: 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a 20 20 20  tual table...   
35f0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
3600: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
3610: 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e 0d 0a  name="module">..
3620: 20 20 20 20 2f 2f 2f 20 54 68 65 20 6d 6f 64 75      /// The modu
3630: 6c 65 20 6f 62 6a 65 63 74 20 70 72 65 76 69 6f  le object previo
3640: 75 73 6c 79 20 70 61 73 73 65 64 20 74 6f 20 74  usly passed to t
3650: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 43 72  he <see cref="Cr
3660: 65 61 74 65 4d 6f 64 75 6c 65 22 20 2f 3e 0d 0a  eateModule" />..
3670: 20 20 20 20 2f 2f 2f 20 6d 65 74 68 6f 64 2e 0d      /// method..
3680: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d  .    /// </param
3690: 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  >..    internal 
36a0: 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 44 69  abstract void Di
36b0: 73 70 6f 73 65 4d 6f 64 75 6c 65 28 53 51 4c 69  sposeModule(SQLi
36c0: 74 65 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 29  teModule module)
36d0: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
36e0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
36f0: 43 61 6c 6c 73 20 74 68 65 20 6e 61 74 69 76 65  Calls the native
3700: 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62   SQLite core lib
3710: 72 61 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f  rary in order to
3720: 20 64 65 63 6c 61 72 65 20 61 20 76 69 72 74 75   declare a virtu
3730: 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 2f 2f  al table..    //
3740: 2f 20 69 6e 20 72 65 73 70 6f 6e 73 65 20 74 6f  / in response to
3750: 20 61 20 63 61 6c 6c 20 69 6e 74 6f 20 74 68 65   a call into the
3760: 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c   <see cref="ISQL
3770: 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e  iteNativeModule.
3780: 78 43 72 65 61 74 65 22 20 2f 3e 0d 0a 20 20 20  xCreate" />..   
3790: 20 2f 2f 2f 20 6f 72 20 3c 73 65 65 20 63 72 65   /// or <see cre
37a0: 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76 65  f="ISQLiteNative
37b0: 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 63 74 22  Module.xConnect"
37c0: 20 2f 3e 20 76 69 72 74 75 61 6c 20 74 61 62 6c   /> virtual tabl
37d0: 65 20 6d 65 74 68 6f 64 73 2e 0d 0a 20 20 20 20  e methods...    
37e0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
37f0: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
3800: 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e 0d 0a 20  ame="module">.. 
3810: 20 20 20 2f 2f 2f 20 54 68 65 20 76 69 72 74 75     /// The virtu
3820: 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 6c 65 20  al table module 
3830: 74 68 61 74 20 69 73 20 74 6f 20 62 65 20 72 65  that is to be re
3840: 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 74 68  sponsible for th
3850: 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0d  e virtual table.
3860: 0a 20 20 20 20 2f 2f 2f 20 62 65 69 6e 67 20 64  .    /// being d
3870: 65 63 6c 61 72 65 64 2e 0d 0a 20 20 20 20 2f 2f  eclared...    //
3880: 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  / </param>..    
3890: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
38a0: 22 73 74 72 53 71 6c 22 3e 0d 0a 20 20 20 20 2f  "strSql">..    /
38b0: 2f 2f 20 54 68 65 20 73 74 72 69 6e 67 20 63 6f  // The string co
38c0: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 53 51 4c  ntaining the SQL
38d0: 20 73 74 61 74 65 6d 65 6e 74 20 64 65 73 63 72   statement descr
38e0: 69 62 69 6e 67 20 74 68 65 20 76 69 72 74 75 61  ibing the virtua
38f0: 6c 20 74 61 62 6c 65 20 74 6f 0d 0a 20 20 20 20  l table to..    
3900: 2f 2f 2f 20 62 65 20 64 65 63 6c 61 72 65 64 2e  /// be declared.
3910: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61  ..    /// </para
3920: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  m>..    /// <par
3930: 61 6d 20 6e 61 6d 65 3d 22 65 72 72 6f 72 22 3e  am name="error">
3940: 0d 0a 20 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 73  ..    /// Upon s
3950: 75 63 63 65 73 73 2c 20 74 68 65 20 63 6f 6e 74  uccess, the cont
3960: 65 6e 74 73 20 6f 66 20 74 68 69 73 20 70 61 72  ents of this par
3970: 61 6d 65 74 65 72 20 61 72 65 20 75 6e 64 65 66  ameter are undef
3980: 69 6e 65 64 2e 20 20 55 70 6f 6e 20 66 61 69 6c  ined.  Upon fail
3990: 75 72 65 2c 0d 0a 20 20 20 20 2f 2f 2f 20 69 74  ure,..    /// it
39a0: 20 73 68 6f 75 6c 64 20 63 6f 6e 74 61 69 6e 20   should contain 
39b0: 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 65  an appropriate e
39c0: 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 0d 0a 20  rror message... 
39d0: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d     /// </param>.
39e0: 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e  .    /// <return
39f0: 73 3e 0d 0a 20 20 20 20 2f 2f 2f 20 41 20 73 74  s>..    /// A st
3a00: 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72 65  andard SQLite re
3a10: 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20  turn code...    
3a20: 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a  /// </returns>..
3a30: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
3a40: 74 72 61 63 74 20 53 51 4c 69 74 65 45 72 72 6f  tract SQLiteErro
3a50: 72 43 6f 64 65 20 44 65 63 6c 61 72 65 56 69 72  rCode DeclareVir
3a60: 74 75 61 6c 54 61 62 6c 65 28 53 51 4c 69 74 65  tualTable(SQLite
3a70: 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 2c 20 73  Module module, s
3a80: 74 72 69 6e 67 20 73 74 72 53 71 6c 2c 20 72 65  tring strSql, re
3a90: 66 20 73 74 72 69 6e 67 20 65 72 72 6f 72 29 3b  f string error);
3aa0: 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  ....    /// <sum
3ab0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43  mary>..    /// C
3ac0: 61 6c 6c 73 20 74 68 65 20 6e 61 74 69 76 65 20  alls the native 
3ad0: 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 72  SQLite core libr
3ae0: 61 72 79 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  ary in order to 
3af0: 64 65 63 6c 61 72 65 20 61 20 76 69 72 74 75 61  declare a virtua
3b00: 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 2f 2f 2f  l table..    ///
3b10: 20 66 75 6e 63 74 69 6f 6e 20 69 6e 20 72 65 73   function in res
3b20: 70 6f 6e 73 65 20 74 6f 20 61 20 63 61 6c 6c 20  ponse to a call 
3b30: 69 6e 74 6f 20 74 68 65 20 3c 73 65 65 20 63 72  into the <see cr
3b40: 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69 76  ef="ISQLiteNativ
3b50: 65 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74 65 22  eModule.xCreate"
3b60: 20 2f 3e 0d 0a 20 20 20 20 2f 2f 2f 20 6f 72 20   />..    /// or 
3b70: 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51 4c 69  <see cref="ISQLi
3b80: 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65 2e 78  teNativeModule.x
3b90: 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 76 69 72 74  Connect" /> virt
3ba0: 75 61 6c 20 74 61 62 6c 65 20 6d 65 74 68 6f 64  ual table method
3bb0: 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  s...    /// </su
3bc0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
3bd0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6d 6f 64  <param name="mod
3be0: 75 6c 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54  ule">..    /// T
3bf0: 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65  he virtual table
3c00: 20 6d 6f 64 75 6c 65 20 74 68 61 74 20 69 73 20   module that is 
3c10: 74 6f 20 62 65 20 72 65 73 70 6f 6e 73 69 62 6c  to be responsibl
3c20: 65 20 66 6f 72 20 74 68 65 20 76 69 72 74 75 61  e for the virtua
3c30: 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 2f 2f 2f  l table..    ///
3c40: 20 66 75 6e 63 74 69 6f 6e 20 62 65 69 6e 67 20   function being 
3c50: 64 65 63 6c 61 72 65 64 2e 0d 0a 20 20 20 20 2f  declared...    /
3c60: 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  // </param>..   
3c70: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
3c80: 3d 22 61 72 67 75 6d 65 6e 74 43 6f 75 6e 74 22  ="argumentCount"
3c90: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e  >..    /// The n
3ca0: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e  umber of argumen
3cb0: 74 73 20 74 6f 20 74 68 65 20 66 75 6e 63 74 69  ts to the functi
3cc0: 6f 6e 20 62 65 69 6e 67 20 64 65 63 6c 61 72 65  on being declare
3cd0: 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61  d...    /// </pa
3ce0: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ram>..    /// <p
3cf0: 61 72 61 6d 20 6e 61 6d 65 3d 22 6e 61 6d 65 22  aram name="name"
3d00: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e  >..    /// The n
3d10: 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74  ame of the funct
3d20: 69 6f 6e 20 62 65 69 6e 67 20 64 65 63 6c 61 72  ion being declar
3d30: 65 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70  ed...    /// </p
3d40: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
3d50: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 65 72 72 6f  param name="erro
3d60: 72 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 55 70 6f  r">..    /// Upo
3d70: 6e 20 73 75 63 63 65 73 73 2c 20 74 68 65 20 63  n success, the c
3d80: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 69 73 20  ontents of this 
3d90: 70 61 72 61 6d 65 74 65 72 20 61 72 65 20 75 6e  parameter are un
3da0: 64 65 66 69 6e 65 64 2e 20 20 55 70 6f 6e 20 66  defined.  Upon f
3db0: 61 69 6c 75 72 65 2c 0d 0a 20 20 20 20 2f 2f 2f  ailure,..    ///
3dc0: 20 69 74 20 73 68 6f 75 6c 64 20 63 6f 6e 74 61   it should conta
3dd0: 69 6e 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74  in an appropriat
3de0: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e  e error message.
3df0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61  ..    /// </para
3e00: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74  m>..    /// <ret
3e10: 75 72 6e 73 3e 0d 0a 20 20 20 20 2f 2f 2f 20 41  urns>..    /// A
3e20: 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65   standard SQLite
3e30: 20 72 65 74 75 72 6e 20 63 6f 64 65 2e 0d 0a 20   return code... 
3e40: 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73     /// </returns
3e50: 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  >..    internal 
3e60: 61 62 73 74 72 61 63 74 20 53 51 4c 69 74 65 45  abstract SQLiteE
3e70: 72 72 6f 72 43 6f 64 65 20 44 65 63 6c 61 72 65  rrorCode Declare
3e80: 56 69 72 74 75 61 6c 46 75 6e 63 74 69 6f 6e 28  VirtualFunction(
3e90: 53 51 4c 69 74 65 4d 6f 64 75 6c 65 20 6d 6f 64  SQLiteModule mod
3ea0: 75 6c 65 2c 20 69 6e 74 20 61 72 67 75 6d 65 6e  ule, int argumen
3eb0: 74 43 6f 75 6e 74 2c 20 73 74 72 69 6e 67 20 6e  tCount, string n
3ec0: 61 6d 65 2c 20 72 65 66 20 73 74 72 69 6e 67 20  ame, ref string 
3ed0: 65 72 72 6f 72 29 3b 0d 0a 23 65 6e 64 69 66 0d  error);..#endif.
3ee0: 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ...    /// <summ
3ef0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 45 6e  ary>..    /// En
3f00: 61 62 6c 65 73 20 6f 72 20 64 69 73 61 62 6c 65  ables or disable
3f10: 64 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64  d extension load
3f20: 69 6e 67 20 62 79 20 53 51 4c 69 74 65 2e 0d 0a  ing by SQLite...
3f30: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
3f40: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
3f50: 61 6d 20 6e 61 6d 65 3d 22 62 4f 6e 4f 66 66 22  am name="bOnOff"
3f60: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 72 75 65 20  >..    /// True 
3f70: 74 6f 20 65 6e 61 62 6c 65 20 6c 6f 61 64 69 6e  to enable loadin
3f80: 67 20 6f 66 20 65 78 74 65 6e 73 69 6f 6e 73 2c  g of extensions,
3f90: 20 66 61 6c 73 65 20 74 6f 20 64 69 73 61 62 6c   false to disabl
3fa0: 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61  e...    /// </pa
3fb0: 72 61 6d 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ram>..    intern
3fc0: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
3fd0: 20 53 65 74 4c 6f 61 64 45 78 74 65 6e 73 69 6f   SetLoadExtensio
3fe0: 6e 28 62 6f 6f 6c 20 62 4f 6e 4f 66 66 29 3b 0d  n(bool bOnOff);.
3ff0: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
4000: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 4c 6f 61 64  y>..    /// Load
4010: 73 20 61 20 53 51 4c 69 74 65 20 65 78 74 65 6e  s a SQLite exten
4020: 73 69 6f 6e 20 6c 69 62 72 61 72 79 20 66 72 6f  sion library fro
4030: 6d 20 74 68 65 20 6e 61 6d 65 64 20 66 69 6c 65  m the named file
4040: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  ...    /// </sum
4050: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  mary>..    /// <
4060: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 66 69 6c 65  param name="file
4070: 4e 61 6d 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20  Name">..    /// 
4080: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
4090: 64 79 6e 61 6d 69 63 20 6c 69 6e 6b 20 6c 69 62  dynamic link lib
40a0: 72 61 72 79 20 66 69 6c 65 20 63 6f 6e 74 61 69  rary file contai
40b0: 6e 69 6e 67 20 74 68 65 20 65 78 74 65 6e 73 69  ning the extensi
40c0: 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70  on...    /// </p
40d0: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
40e0: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 70 72 6f 63  param name="proc
40f0: 4e 61 6d 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20  Name">..    /// 
4100: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  The name of the 
4110: 65 78 70 6f 72 74 65 64 20 66 75 6e 63 74 69 6f  exported functio
4120: 6e 20 75 73 65 64 20 74 6f 20 69 6e 69 74 69 61  n used to initia
4130: 6c 69 7a 65 20 74 68 65 20 65 78 74 65 6e 73 69  lize the extensi
4140: 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 49 66 20  on...    /// If 
4150: 6e 75 6c 6c 2c 20 74 68 65 20 64 65 66 61 75 6c  null, the defaul
4160: 74 20 22 73 71 6c 69 74 65 33 5f 65 78 74 65 6e  t "sqlite3_exten
4170: 73 69 6f 6e 5f 69 6e 69 74 22 20 77 69 6c 6c 20  sion_init" will 
4180: 62 65 20 75 73 65 64 2e 0d 0a 20 20 20 20 2f 2f  be used...    //
4190: 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  / </param>..    
41a0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
41b0: 74 20 76 6f 69 64 20 4c 6f 61 64 45 78 74 65 6e  t void LoadExten
41c0: 73 69 6f 6e 28 73 74 72 69 6e 67 20 66 69 6c 65  sion(string file
41d0: 4e 61 6d 65 2c 20 73 74 72 69 6e 67 20 70 72 6f  Name, string pro
41e0: 63 4e 61 6d 65 29 3b 0d 0a 20 20 20 20 2f 2f 2f  cName);..    ///
41f0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
4200: 2f 2f 2f 20 45 6e 61 62 6c 65 73 20 6f 72 20 64  /// Enables or d
4210: 69 73 61 62 6c 65 64 20 65 78 74 65 6e 65 64 20  isabled extened 
4220: 72 65 73 75 6c 74 20 63 6f 64 65 73 20 72 65 74  result codes ret
4230: 75 72 6e 65 64 20 62 79 20 53 51 4c 69 74 65 0d  urned by SQLite.
4240: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
4250: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61  ry>..    /// <pa
4260: 72 61 6d 20 6e 61 6d 65 3d 22 62 4f 6e 4f 66 66  ram name="bOnOff
4270: 22 3e 74 72 75 65 20 74 6f 20 65 6e 61 62 6c 65  ">true to enable
4280: 20 65 78 74 65 6e 64 65 64 20 72 65 73 75 6c 74   extended result
4290: 20 63 6f 64 65 73 2c 20 66 61 6c 73 65 20 74 6f   codes, false to
42a0: 20 64 69 73 61 62 6c 65 2e 3c 2f 70 61 72 61 6d   disable.</param
42b0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75  >..    /// <retu
42c0: 72 6e 73 3e 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a  rns></returns>..
42d0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
42e0: 74 72 61 63 74 20 76 6f 69 64 20 53 65 74 45 78  tract void SetEx
42f0: 74 65 6e 64 65 64 52 65 73 75 6c 74 43 6f 64 65  tendedResultCode
4300: 73 28 62 6f 6f 6c 20 62 4f 6e 4f 66 66 29 3b 0d  s(bool bOnOff);.
4310: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
4320: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75  y>..    /// Retu
4330: 72 6e 73 20 74 68 65 20 6e 75 6d 65 72 69 63 20  rns the numeric 
4340: 72 65 73 75 6c 74 20 63 6f 64 65 20 66 6f 72 20  result code for 
4350: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20  the most recent 
4360: 66 61 69 6c 65 64 20 53 51 4c 69 74 65 20 41 50  failed SQLite AP
4370: 49 20 63 61 6c 6c 20 0d 0a 20 20 20 20 2f 2f 2f  I call ..    ///
4380: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
4390: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f   the database co
43a0: 6e 6e 65 63 74 69 6f 6e 2e 20 0d 0a 20 20 20 20  nnection. ..    
43b0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
43c0: 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73      /// <returns
43d0: 3e 52 65 73 75 6c 74 20 63 6f 64 65 3c 2f 72 65  >Result code</re
43e0: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65  turns>..    inte
43f0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53 51  rnal abstract SQ
4400: 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 52 65  LiteErrorCode Re
4410: 73 75 6c 74 43 6f 64 65 28 29 3b 0d 0a 20 20 20  sultCode();..   
4420: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
4430: 20 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20      /// Returns 
4440: 74 68 65 20 65 78 74 65 6e 64 65 64 20 6e 75 6d  the extended num
4450: 65 72 69 63 20 72 65 73 75 6c 74 20 63 6f 64 65  eric result code
4460: 20 66 6f 72 20 74 68 65 20 6d 6f 73 74 20 72 65   for the most re
4470: 63 65 6e 74 20 66 61 69 6c 65 64 20 53 51 4c 69  cent failed SQLi
4480: 74 65 20 41 50 49 20 63 61 6c 6c 20 0d 0a 20 20  te API call ..  
4490: 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 74 65 64    /// associated
44a0: 20 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61   with the databa
44b0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 0d  se connection. .
44c0: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
44d0: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65  ry>..    /// <re
44e0: 74 75 72 6e 73 3e 45 78 74 65 6e 64 65 64 20 72  turns>Extended r
44f0: 65 73 75 6c 74 20 63 6f 64 65 3c 2f 72 65 74 75  esult code</retu
4500: 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  rns>..    intern
4510: 61 6c 20 61 62 73 74 72 61 63 74 20 53 51 4c 69  al abstract SQLi
4520: 74 65 45 72 72 6f 72 43 6f 64 65 20 45 78 74 65  teErrorCode Exte
4530: 6e 64 65 64 52 65 73 75 6c 74 43 6f 64 65 28 29  ndedResultCode()
4540: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
4550: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
4560: 41 64 64 20 61 20 6c 6f 67 20 6d 65 73 73 61 67  Add a log messag
4570: 65 20 76 69 61 20 74 68 65 20 53 51 4c 69 74 65  e via the SQLite
4580: 20 73 71 6c 69 74 65 33 5f 6c 6f 67 20 69 6e 74   sqlite3_log int
4590: 65 72 66 61 63 65 2e 0d 0a 20 20 20 20 2f 2f 2f  erface...    ///
45a0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
45b0: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
45c0: 3d 22 69 45 72 72 43 6f 64 65 22 3e 45 72 72 6f  ="iErrCode">Erro
45d0: 72 20 63 6f 64 65 20 74 6f 20 62 65 20 6c 6f 67  r code to be log
45e0: 67 65 64 20 77 69 74 68 20 74 68 65 20 6d 65 73  ged with the mes
45f0: 73 61 67 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20  sage.</param>.. 
4600: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61     /// <param na
4610: 6d 65 3d 22 7a 4d 65 73 73 61 67 65 22 3e 53 74  me="zMessage">St
4620: 72 69 6e 67 20 74 6f 20 62 65 20 6c 6f 67 67 65  ring to be logge
4630: 64 2e 20 20 55 6e 6c 69 6b 65 20 74 68 65 20 53  d.  Unlike the S
4640: 51 4c 69 74 65 20 73 71 6c 69 74 65 33 5f 6c 6f  QLite sqlite3_lo
4650: 67 28 29 20 0d 0a 20 20 20 20 2f 2f 2f 20 69 6e  g() ..    /// in
4660: 74 65 72 66 61 63 65 2c 20 74 68 69 73 20 73 68  terface, this sh
4670: 6f 75 6c 64 20 62 65 20 70 72 65 2d 66 6f 72 6d  ould be pre-form
4680: 61 74 74 65 64 2e 20 20 43 6f 6e 73 69 64 65 72  atted.  Consider
4690: 20 75 73 69 6e 67 20 74 68 65 20 0d 0a 20 20 20   using the ..   
46a0: 20 2f 2f 2f 20 53 74 72 69 6e 67 2e 46 6f 72 6d   /// String.Form
46b0: 61 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 3c 2f  at() function.</
46c0: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
46d0: 3c 72 65 74 75 72 6e 73 3e 3c 2f 72 65 74 75 72  <returns></retur
46e0: 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ns>..    interna
46f0: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
4700: 4c 6f 67 4d 65 73 73 61 67 65 28 53 51 4c 69 74  LogMessage(SQLit
4710: 65 45 72 72 6f 72 43 6f 64 65 20 69 45 72 72 43  eErrorCode iErrC
4720: 6f 64 65 2c 20 73 74 72 69 6e 67 20 7a 4d 65 73  ode, string zMes
4730: 73 61 67 65 29 3b 0d 0a 0d 0a 23 69 66 20 49 4e  sage);....#if IN
4740: 54 45 52 4f 50 5f 43 4f 44 45 43 0d 0a 20 20 20  TEROP_CODEC..   
4750: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
4760: 63 74 20 76 6f 69 64 20 53 65 74 50 61 73 73 77  ct void SetPassw
4770: 6f 72 64 28 62 79 74 65 5b 5d 20 70 61 73 73 77  ord(byte[] passw
4780: 6f 72 64 42 79 74 65 73 29 3b 0d 0a 20 20 20 20  ordBytes);..    
4790: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
47a0: 74 20 76 6f 69 64 20 43 68 61 6e 67 65 50 61 73  t void ChangePas
47b0: 73 77 6f 72 64 28 62 79 74 65 5b 5d 20 6e 65 77  sword(byte[] new
47c0: 50 61 73 73 77 6f 72 64 42 79 74 65 73 29 3b 0d  PasswordBytes);.
47d0: 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 20 20 20 69  .#endif....    i
47e0: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
47f0: 20 76 6f 69 64 20 53 65 74 55 70 64 61 74 65 48   void SetUpdateH
4800: 6f 6f 6b 28 53 51 4c 69 74 65 55 70 64 61 74 65  ook(SQLiteUpdate
4810: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 29 3b 0d  Callback func);.
4820: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
4830: 73 74 72 61 63 74 20 76 6f 69 64 20 53 65 74 43  stract void SetC
4840: 6f 6d 6d 69 74 48 6f 6f 6b 28 53 51 4c 69 74 65  ommitHook(SQLite
4850: 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 20 66  CommitCallback f
4860: 75 6e 63 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  unc);..    inter
4870: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69  nal abstract voi
4880: 64 20 53 65 74 54 72 61 63 65 43 61 6c 6c 62 61  d SetTraceCallba
4890: 63 6b 28 53 51 4c 69 74 65 54 72 61 63 65 43 61  ck(SQLiteTraceCa
48a0: 6c 6c 62 61 63 6b 20 66 75 6e 63 29 3b 0d 0a 20  llback func);.. 
48b0: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
48c0: 72 61 63 74 20 76 6f 69 64 20 53 65 74 52 6f 6c  ract void SetRol
48d0: 6c 62 61 63 6b 48 6f 6f 6b 28 53 51 4c 69 74 65  lbackHook(SQLite
48e0: 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b  RollbackCallback
48f0: 20 66 75 6e 63 29 3b 0d 0a 20 20 20 20 69 6e 74   func);..    int
4900: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53  ernal abstract S
4910: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 53  QLiteErrorCode S
4920: 65 74 4c 6f 67 43 61 6c 6c 62 61 63 6b 28 53 51  etLogCallback(SQ
4930: 4c 69 74 65 4c 6f 67 43 61 6c 6c 62 61 63 6b 20  LiteLogCallback 
4940: 66 75 6e 63 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f  func);....    //
4950: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
4960: 20 2f 2f 2f 20 43 68 65 63 6b 73 20 69 66 20 74   /// Checks if t
4970: 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c  he SQLite core l
4980: 69 62 72 61 72 79 20 68 61 73 20 62 65 65 6e 20  ibrary has been 
4990: 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 6e 20 74  initialized in t
49a0: 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63 65  he current proce
49b0: 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ss...    /// </s
49c0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
49d0: 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20   <returns>..    
49e0: 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20  /// Non-zero if 
49f0: 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20  the SQLite core 
4a00: 6c 69 62 72 61 72 79 20 68 61 73 20 62 65 65 6e  library has been
4a10: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 6e 20   initialized in 
4a20: 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63  the current proc
4a30: 65 73 73 2c 0d 0a 20 20 20 20 2f 2f 2f 20 7a 65  ess,..    /// ze
4a40: 72 6f 20 6f 74 68 65 72 77 69 73 65 2e 0d 0a 20  ro otherwise... 
4a50: 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e 73     /// </returns
4a60: 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  >..    internal 
4a70: 61 62 73 74 72 61 63 74 20 62 6f 6f 6c 20 49 73  abstract bool Is
4a80: 49 6e 69 74 69 61 6c 69 7a 65 64 28 29 3b 0d 0a  Initialized();..
4a90: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
4aa0: 62 73 74 72 61 63 74 20 69 6e 74 20 47 65 74 43  bstract int GetC
4ab0: 75 72 73 6f 72 46 6f 72 54 61 62 6c 65 28 53 51  ursorForTable(SQ
4ac0: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74  LiteStatement st
4ad0: 6d 74 2c 20 69 6e 74 20 64 61 74 61 62 61 73 65  mt, int database
4ae0: 2c 20 69 6e 74 20 72 6f 6f 74 50 61 67 65 29 3b  , int rootPage);
4af0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
4b00: 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 47 65 74  bstract long Get
4b10: 52 6f 77 49 64 46 6f 72 43 75 72 73 6f 72 28 53  RowIdForCursor(S
4b20: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
4b30: 74 6d 74 2c 20 69 6e 74 20 63 75 72 73 6f 72 29  tmt, int cursor)
4b40: 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ;....    interna
4b50: 6c 20 61 62 73 74 72 61 63 74 20 6f 62 6a 65 63  l abstract objec
4b60: 74 20 47 65 74 56 61 6c 75 65 28 53 51 4c 69 74  t GetValue(SQLit
4b70: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
4b80: 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f   SQLiteConnectio
4b90: 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e  nFlags flags, in
4ba0: 74 20 69 6e 64 65 78 2c 20 53 51 4c 69 74 65 54  t index, SQLiteT
4bb0: 79 70 65 20 74 79 70 29 3b 0d 0a 0d 0a 20 20 20  ype typ);....   
4bc0: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
4bd0: 63 74 20 62 6f 6f 6c 20 41 75 74 6f 43 6f 6d 6d  ct bool AutoComm
4be0: 69 74 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  it..    {..     
4bf0: 20 67 65 74 3b 0d 0a 20 20 20 20 7d 0d 0a 0d 0a   get;..    }....
4c00: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
4c10: 74 72 61 63 74 20 53 51 4c 69 74 65 45 72 72 6f  tract SQLiteErro
4c20: 72 43 6f 64 65 20 46 69 6c 65 43 6f 6e 74 72 6f  rCode FileContro
4c30: 6c 28 73 74 72 69 6e 67 20 7a 44 62 4e 61 6d 65  l(string zDbName
4c40: 2c 20 69 6e 74 20 6f 70 2c 20 49 6e 74 50 74 72  , int op, IntPtr
4c50: 20 70 41 72 67 29 3b 0d 0a 0d 0a 20 20 20 20 2f   pArg);....    /
4c60: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
4c70: 20 20 2f 2f 2f 20 43 72 65 61 74 65 73 20 61 20    /// Creates a 
4c80: 6e 65 77 20 53 51 4c 69 74 65 20 62 61 63 6b 75  new SQLite backu
4c90: 70 20 6f 62 6a 65 63 74 20 62 61 73 65 64 20 6f  p object based o
4ca0: 6e 20 74 68 65 20 70 72 6f 76 69 64 65 64 20 64  n the provided d
4cb0: 65 73 74 69 6e 61 74 69 6f 6e 0d 0a 20 20 20 20  estination..    
4cc0: 2f 2f 2f 20 64 61 74 61 62 61 73 65 20 63 6f 6e  /// database con
4cd0: 6e 65 63 74 69 6f 6e 2e 20 20 54 68 65 20 73 6f  nection.  The so
4ce0: 75 72 63 65 20 64 61 74 61 62 61 73 65 20 63 6f  urce database co
4cf0: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 74 68 65 20  nnection is the 
4d00: 6f 6e 65 0d 0a 20 20 20 20 2f 2f 2f 20 61 73 73  one..    /// ass
4d10: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69  ociated with thi
4d20: 73 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 20 73  s object.  The s
4d30: 6f 75 72 63 65 20 61 6e 64 20 64 65 73 74 69 6e  ource and destin
4d40: 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65 0d 0a  ation database..
4d50: 20 20 20 20 2f 2f 2f 20 63 6f 6e 6e 65 63 74 69      /// connecti
4d60: 6f 6e 73 20 63 61 6e 6e 6f 74 20 62 65 20 74 68  ons cannot be th
4d70: 65 20 73 61 6d 65 2e 0d 0a 20 20 20 20 2f 2f 2f  e same...    ///
4d80: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
4d90: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
4da0: 3d 22 64 65 73 74 43 6e 6e 22 3e 54 68 65 20 64  ="destCnn">The d
4db0: 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62  estination datab
4dc0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 3c  ase connection.<
4dd0: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f  /param>..    ///
4de0: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 64 65   <param name="de
4df0: 73 74 4e 61 6d 65 22 3e 54 68 65 20 64 65 73 74  stName">The dest
4e00: 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65  ination database
4e10: 20 6e 61 6d 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a   name.</param>..
4e20: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
4e30: 61 6d 65 3d 22 73 6f 75 72 63 65 4e 61 6d 65 22  ame="sourceName"
4e40: 3e 54 68 65 20 73 6f 75 72 63 65 20 64 61 74 61  >The source data
4e50: 62 61 73 65 20 6e 61 6d 65 2e 3c 2f 70 61 72 61  base name.</para
4e60: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74  m>..    /// <ret
4e70: 75 72 6e 73 3e 54 68 65 20 6e 65 77 6c 79 20 63  urns>The newly c
4e80: 72 65 61 74 65 64 20 62 61 63 6b 75 70 20 6f 62  reated backup ob
4e90: 6a 65 63 74 2e 3c 2f 72 65 74 75 72 6e 73 3e 0d  ject.</returns>.
4ea0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
4eb0: 73 74 72 61 63 74 20 53 51 4c 69 74 65 42 61 63  stract SQLiteBac
4ec0: 6b 75 70 20 49 6e 69 74 69 61 6c 69 7a 65 42 61  kup InitializeBa
4ed0: 63 6b 75 70 28 0d 0a 20 20 20 20 20 20 20 20 53  ckup(..        S
4ee0: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 20  QLiteConnection 
4ef0: 64 65 73 74 43 6e 6e 2c 20 73 74 72 69 6e 67 20  destCnn, string 
4f00: 64 65 73 74 4e 61 6d 65 2c 0d 0a 20 20 20 20 20  destName,..     
4f10: 20 20 20 73 74 72 69 6e 67 20 73 6f 75 72 63 65     string source
4f20: 4e 61 6d 65 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f  Name);....    //
4f30: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
4f40: 20 2f 2f 2f 20 43 6f 70 69 65 73 20 75 70 20 74   /// Copies up t
4f50: 6f 20 4e 20 70 61 67 65 73 20 66 72 6f 6d 20 74  o N pages from t
4f60: 68 65 20 73 6f 75 72 63 65 20 64 61 74 61 62 61  he source databa
4f70: 73 65 20 74 6f 20 74 68 65 20 64 65 73 74 69 6e  se to the destin
4f80: 61 74 69 6f 6e 0d 0a 20 20 20 20 2f 2f 2f 20 64  ation..    /// d
4f90: 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 61 74  atabase associat
4fa0: 65 64 20 77 69 74 68 20 74 68 65 20 73 70 65 63  ed with the spec
4fb0: 69 66 69 65 64 20 62 61 63 6b 75 70 20 6f 62 6a  ified backup obj
4fc0: 65 63 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ect...    /// </
4fd0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
4fe0: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 62  / <param name="b
4ff0: 61 63 6b 75 70 22 3e 54 68 65 20 62 61 63 6b 75  ackup">The backu
5000: 70 20 6f 62 6a 65 63 74 20 74 6f 20 75 73 65 2e  p object to use.
5010: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f  </param>..    //
5020: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6e  / <param name="n
5030: 50 61 67 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20  Page">..    /// 
5040: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61  The number of pa
5050: 67 65 73 20 74 6f 20 63 6f 70 79 20 6f 72 20 6e  ges to copy or n
5060: 65 67 61 74 69 76 65 20 74 6f 20 63 6f 70 79 20  egative to copy 
5070: 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20 70 61  all remaining pa
5080: 67 65 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ges...    /// </
5090: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
50a0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 72 65 74  <param name="ret
50b0: 72 79 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53 65  ry">..    /// Se
50c0: 74 20 74 6f 20 74 72 75 65 20 69 66 20 74 68 65  t to true if the
50d0: 20 6f 70 65 72 61 74 69 6f 6e 20 6e 65 65 64 73   operation needs
50e0: 20 74 6f 20 62 65 20 72 65 74 72 69 65 64 20 64   to be retried d
50f0: 75 65 20 74 6f 20 64 61 74 61 62 61 73 65 0d 0a  ue to database..
5100: 20 20 20 20 2f 2f 2f 20 6c 6f 63 6b 69 6e 67 20      /// locking 
5110: 69 73 73 75 65 73 2e 0d 0a 20 20 20 20 2f 2f 2f  issues...    ///
5120: 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f   </param>..    /
5130: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20  // <returns>..  
5140: 20 20 2f 2f 2f 20 54 72 75 65 20 69 66 20 74 68    /// True if th
5150: 65 72 65 20 61 72 65 20 6d 6f 72 65 20 70 61 67  ere are more pag
5160: 65 73 20 74 6f 20 62 65 20 63 6f 70 69 65 64 2c  es to be copied,
5170: 20 66 61 6c 73 65 20 6f 74 68 65 72 77 69 73 65   false otherwise
5180: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74  ...    /// </ret
5190: 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72  urns>..    inter
51a0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 62 6f 6f  nal abstract boo
51b0: 6c 20 53 74 65 70 42 61 63 6b 75 70 28 53 51 4c  l StepBackup(SQL
51c0: 69 74 65 42 61 63 6b 75 70 20 62 61 63 6b 75 70  iteBackup backup
51d0: 2c 20 69 6e 74 20 6e 50 61 67 65 2c 20 6f 75 74  , int nPage, out
51e0: 20 62 6f 6f 6c 20 72 65 74 72 79 29 3b 0d 0a 0d   bool retry);...
51f0: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
5200: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75  y>..    /// Retu
5210: 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  rns the number o
5220: 66 20 70 61 67 65 73 20 72 65 6d 61 69 6e 69 6e  f pages remainin
5230: 67 20 74 6f 20 62 65 20 63 6f 70 69 65 64 20 66  g to be copied f
5240: 72 6f 6d 20 74 68 65 20 73 6f 75 72 63 65 0d 0a  rom the source..
5250: 20 20 20 20 2f 2f 2f 20 64 61 74 61 62 61 73 65      /// database
5260: 20 74 6f 20 74 68 65 20 64 65 73 74 69 6e 61 74   to the destinat
5270: 69 6f 6e 20 64 61 74 61 62 61 73 65 20 61 73 73  ion database ass
5280: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65  ociated with the
5290: 20 73 70 65 63 69 66 69 65 64 0d 0a 20 20 20 20   specified..    
52a0: 2f 2f 2f 20 62 61 63 6b 75 70 20 6f 62 6a 65 63  /// backup objec
52b0: 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  t...    /// </su
52c0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
52d0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 62 61 63  <param name="bac
52e0: 6b 75 70 22 3e 54 68 65 20 62 61 63 6b 75 70 20  kup">The backup 
52f0: 6f 62 6a 65 63 74 20 74 6f 20 63 68 65 63 6b 2e  object to check.
5300: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f  </param>..    //
5310: 2f 20 3c 72 65 74 75 72 6e 73 3e 54 68 65 20 6e  / <returns>The n
5320: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 72  umber of pages r
5330: 65 6d 61 69 6e 69 6e 67 20 74 6f 20 62 65 20 63  emaining to be c
5340: 6f 70 69 65 64 2e 3c 2f 72 65 74 75 72 6e 73 3e  opied.</returns>
5350: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
5360: 62 73 74 72 61 63 74 20 69 6e 74 20 52 65 6d 61  bstract int Rema
5370: 69 6e 69 6e 67 42 61 63 6b 75 70 28 53 51 4c 69  iningBackup(SQLi
5380: 74 65 42 61 63 6b 75 70 20 62 61 63 6b 75 70 29  teBackup backup)
5390: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
53a0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
53b0: 52 65 74 75 72 6e 73 20 74 68 65 20 74 6f 74 61  Returns the tota
53c0: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  l number of page
53d0: 73 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20  s in the source 
53e0: 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 61  database associa
53f0: 74 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 77 69 74  ted..    /// wit
5400: 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20  h the specified 
5410: 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 2e 0d 0a  backup object...
5420: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
5430: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
5440: 61 6d 20 6e 61 6d 65 3d 22 62 61 63 6b 75 70 22  am name="backup"
5450: 3e 54 68 65 20 62 61 63 6b 75 70 20 6f 62 6a 65  >The backup obje
5460: 63 74 20 74 6f 20 63 68 65 63 6b 2e 3c 2f 70 61  ct to check.</pa
5470: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72  ram>..    /// <r
5480: 65 74 75 72 6e 73 3e 54 68 65 20 74 6f 74 61 6c  eturns>The total
5490: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73   number of pages
54a0: 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 64   in the source d
54b0: 61 74 61 62 61 73 65 2e 3c 2f 72 65 74 75 72 6e  atabase.</return
54c0: 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  s>..    internal
54d0: 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 50 61   abstract int Pa
54e0: 67 65 43 6f 75 6e 74 42 61 63 6b 75 70 28 53 51  geCountBackup(SQ
54f0: 4c 69 74 65 42 61 63 6b 75 70 20 62 61 63 6b 75  LiteBackup backu
5500: 70 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c  p);....    /// <
5510: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
5520: 2f 20 44 65 73 74 72 6f 79 73 20 74 68 65 20 62  / Destroys the b
5530: 61 63 6b 75 70 20 6f 62 6a 65 63 74 2c 20 72 6f  ackup object, ro
5540: 6c 6c 69 6e 67 20 62 61 63 6b 20 61 6e 79 20 62  lling back any b
5550: 61 63 6b 75 70 20 74 68 61 74 20 6d 61 79 20 62  ackup that may b
5560: 65 20 69 6e 0d 0a 20 20 20 20 2f 2f 2f 20 70 72  e in..    /// pr
5570: 6f 67 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20  ogess...    /// 
5580: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
5590: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
55a0: 22 62 61 63 6b 75 70 22 3e 54 68 65 20 62 61 63  "backup">The bac
55b0: 6b 75 70 20 6f 62 6a 65 63 74 20 74 6f 20 64 65  kup object to de
55c0: 73 74 72 6f 79 2e 3c 2f 70 61 72 61 6d 3e 0d 0a  stroy.</param>..
55d0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
55e0: 74 72 61 63 74 20 76 6f 69 64 20 46 69 6e 69 73  tract void Finis
55f0: 68 42 61 63 6b 75 70 28 53 51 4c 69 74 65 42 61  hBackup(SQLiteBa
5600: 63 6b 75 70 20 62 61 63 6b 75 70 29 3b 0d 0a 0d  ckup backup);...
5610: 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  .    ///////////
5620: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5630: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5640: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5650: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5660: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5670: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67  ////....    #reg
5680: 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c 65 20  ion IDisposable 
5690: 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 70 75 62  Members..    pub
56a0: 6c 69 63 20 76 6f 69 64 20 44 69 73 70 6f 73 65  lic void Dispose
56b0: 28 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  ()..    {..     
56c0: 20 20 20 44 69 73 70 6f 73 65 28 74 72 75 65 29     Dispose(true)
56d0: 3b 0d 0a 20 20 20 20 20 20 20 20 47 43 2e 53 75  ;..        GC.Su
56e0: 70 70 72 65 73 73 46 69 6e 61 6c 69 7a 65 28 74  ppressFinalize(t
56f0: 68 69 73 29 3b 0d 0a 20 20 20 20 7d 0d 0a 20 20  his);..    }..  
5700: 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a    #endregion....
5710: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f      ////////////
5720: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5730: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5740: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5750: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5760: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5770: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67 69  ///....    #regi
5780: 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c 65 20 22  on IDisposable "
5790: 50 61 74 74 65 72 6e 22 20 4d 65 6d 62 65 72 73  Pattern" Members
57a0: 0d 0a 20 20 20 20 70 72 69 76 61 74 65 20 62 6f  ..    private bo
57b0: 6f 6c 20 64 69 73 70 6f 73 65 64 3b 0d 0a 20 20  ol disposed;..  
57c0: 20 20 70 72 69 76 61 74 65 20 76 6f 69 64 20 43    private void C
57d0: 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 20 2f  heckDisposed() /
57e0: 2a 20 74 68 72 6f 77 20 2a 2f 0d 0a 20 20 20 20  * throw */..    
57f0: 7b 0d 0a 23 69 66 20 54 48 52 4f 57 5f 4f 4e 5f  {..#if THROW_ON_
5800: 44 49 53 50 4f 53 45 44 0d 0a 20 20 20 20 20 20  DISPOSED..      
5810: 20 20 69 66 20 28 64 69 73 70 6f 73 65 64 29 0d    if (disposed).
5820: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72  .            thr
5830: 6f 77 20 6e 65 77 20 4f 62 6a 65 63 74 44 69 73  ow new ObjectDis
5840: 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 28 74  posedException(t
5850: 79 70 65 6f 66 28 53 51 4c 69 74 65 42 61 73 65  ypeof(SQLiteBase
5860: 29 2e 4e 61 6d 65 29 3b 0d 0a 23 65 6e 64 69 66  ).Name);..#endif
5870: 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 2f  ..    }....    /
5880: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5890: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
58a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
58b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
58c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
58d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a  //////////////..
58e0: 0d 0a 20 20 20 20 70 72 6f 74 65 63 74 65 64 20  ..    protected 
58f0: 76 69 72 74 75 61 6c 20 76 6f 69 64 20 44 69 73  virtual void Dis
5900: 70 6f 73 65 28 62 6f 6f 6c 20 64 69 73 70 6f 73  pose(bool dispos
5910: 69 6e 67 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20  ing)..    {..   
5920: 20 20 20 20 20 69 66 20 28 21 64 69 73 70 6f 73       if (!dispos
5930: 65 64 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a  ed)..        {..
5940: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 69 66              //if
5950: 20 28 64 69 73 70 6f 73 69 6e 67 29 0d 0a 20 20   (disposing)..  
5960: 20 20 20 20 20 20 20 20 20 20 2f 2f 7b 0d 0a 20            //{.. 
5970: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 20             //   
5980: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f   ///////////////
5990: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
59a0: 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20  /////..         
59b0: 20 20 20 2f 2f 20 20 20 20 2f 2f 20 64 69 73 70     //    // disp
59c0: 6f 73 65 20 6d 61 6e 61 67 65 64 20 72 65 73 6f  ose managed reso
59d0: 75 72 63 65 73 20 68 65 72 65 2e 2e 2e 0d 0a 20  urces here..... 
59e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 20             //   
59f0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f   ///////////////
5a00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5a10: 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20  /////..         
5a20: 20 20 20 2f 2f 7d 0d 0a 0d 0a 20 20 20 20 20 20     //}....      
5a30: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f        //////////
5a40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5a50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20 20  ////////////..  
5a60: 20 20 20 20 20 20 20 20 20 20 2f 2f 20 72 65 6c            // rel
5a70: 65 61 73 65 20 75 6e 6d 61 6e 61 67 65 64 20 72  ease unmanaged r
5a80: 65 73 6f 75 72 63 65 73 20 68 65 72 65 2e 2e 2e  esources here...
5a90: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f  ..            //
5aa0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5ab0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5ac0: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20 20  ////....        
5ad0: 20 20 20 20 64 69 73 70 6f 73 65 64 20 3d 20 74      disposed = t
5ae0: 72 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d  rue;..        }.
5af0: 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e 64  .    }..    #end
5b00: 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f 2f  region....    //
5b10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5b20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5b30: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5b40: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5b50: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5b60: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d  /////////////...
5b70: 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 44 65 73  .    #region Des
5b80: 74 72 75 63 74 6f 72 0d 0a 20 20 20 20 7e 53 51  tructor..    ~SQ
5b90: 4c 69 74 65 42 61 73 65 28 29 0d 0a 20 20 20 20  LiteBase()..    
5ba0: 7b 0d 0a 20 20 20 20 20 20 20 20 44 69 73 70 6f  {..        Dispo
5bb0: 73 65 28 66 61 6c 73 65 29 3b 0d 0a 20 20 20 20  se(false);..    
5bc0: 7d 0d 0a 20 20 20 20 23 65 6e 64 72 65 67 69 6f  }..    #endregio
5bd0: 6e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f  n....    ///////
5be0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5bf0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5c00: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5c10: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5c20: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5c30: 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20  ////////....    
5c40: 2f 2f 20 54 68 65 73 65 20 73 74 61 74 69 63 73  // These statics
5c50: 20 61 72 65 20 68 65 72 65 20 66 6f 72 20 6c 61   are here for la
5c60: 63 6b 20 6f 66 20 61 20 62 65 74 74 65 72 20 70  ck of a better p
5c70: 6c 61 63 65 20 74 6f 20 70 75 74 20 74 68 65 6d  lace to put them
5c80: 2e 0d 0a 20 20 20 20 2f 2f 20 54 68 65 79 20 65  ...    // They e
5c90: 78 69 73 74 20 68 65 72 65 20 62 65 63 61 75 73  xist here becaus
5ca0: 65 20 74 68 65 79 20 61 72 65 20 63 61 6c 6c 65  e they are calle
5cb0: 64 20 64 75 72 69 6e 67 20 74 68 65 20 66 69 6e  d during the fin
5cc0: 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 0d 0a 20 20  alization of..  
5cd0: 20 20 2f 2f 20 61 20 53 51 4c 69 74 65 53 74 61    // a SQLiteSta
5ce0: 74 65 6d 65 6e 74 48 61 6e 64 6c 65 2c 20 53 51  tementHandle, SQ
5cf0: 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48 61  LiteConnectionHa
5d00: 6e 64 6c 65 2c 20 61 6e 64 20 53 51 4c 69 74 65  ndle, and SQLite
5d10: 46 75 6e 63 74 69 6f 6e 43 6f 6f 6b 69 65 48 61  FunctionCookieHa
5d20: 6e 64 6c 65 2e 0d 0a 20 20 20 20 2f 2f 20 54 68  ndle...    // Th
5d30: 65 72 65 66 6f 72 65 20 74 68 65 73 65 20 66 75  erefore these fu
5d40: 6e 63 74 69 6f 6e 73 20 68 61 76 65 20 74 6f 20  nctions have to 
5d50: 62 65 20 73 74 61 74 69 63 2c 20 61 6e 64 20 68  be static, and h
5d60: 61 76 65 20 74 6f 20 62 65 20 6c 6f 77 2d 6c 65  ave to be low-le
5d70: 76 65 6c 2e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f  vel.....    ////
5d80: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5d90: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5da0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5db0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5dc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
5dd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20  ///////////.... 
5de0: 20 20 20 70 72 69 76 61 74 65 20 73 74 61 74 69     private stati
5df0: 63 20 73 74 72 69 6e 67 5b 5d 20 5f 65 72 72 6f  c string[] _erro
5e00: 72 4d 65 73 73 61 67 65 73 20 3d 20 7b 0a 20 20  rMessages = {.  
5e10: 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f        /* SQLITE_
5e20: 4f 4b 20 20 20 20 20 20 20 20 20 20 2a 2f 20 22  OK          */ "
5e30: 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 2c 0d 0a  not an error",..
5e40: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54          /* SQLIT
5e50: 45 5f 45 52 52 4f 52 20 20 20 20 20 20 20 2a 2f  E_ERROR       */
5e60: 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f   "SQL logic erro
5e70: 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64 61 74  r or missing dat
5e80: 61 62 61 73 65 22 2c 0d 0a 20 20 20 20 20 20 20  abase",..       
5e90: 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52   /* SQLITE_INTER
5ea0: 4e 41 4c 20 20 20 20 2a 2f 20 22 69 6e 74 65 72  NAL    */ "inter
5eb0: 6e 61 6c 20 6c 6f 67 69 63 20 65 72 72 6f 72 22  nal logic error"
5ec0: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51  ,..        /* SQ
5ed0: 4c 49 54 45 5f 50 45 52 4d 20 20 20 20 20 20 20  LITE_PERM       
5ee0: 20 2a 2f 20 22 61 63 63 65 73 73 20 70 65 72 6d   */ "access perm
5ef0: 69 73 73 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0d  ission denied",.
5f00: 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49  .        /* SQLI
5f10: 54 45 5f 41 42 4f 52 54 20 20 20 20 20 20 20 2a  TE_ABORT       *
5f20: 2f 20 22 63 61 6c 6c 62 61 63 6b 20 72 65 71 75  / "callback requ
5f30: 65 73 74 65 64 20 71 75 65 72 79 20 61 62 6f 72  ested query abor
5f40: 74 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20  t",..        /* 
5f50: 53 51 4c 49 54 45 5f 42 55 53 59 20 20 20 20 20  SQLITE_BUSY     
5f60: 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73 65 20     */ "database 
5f70: 69 73 20 6c 6f 63 6b 65 64 22 2c 0d 0a 20 20 20  is locked",..   
5f80: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4c       /* SQLITE_L
5f90: 4f 43 4b 45 44 20 20 20 20 20 20 2a 2f 20 22 64  OCKED      */ "d
5fa0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 69 73  atabase table is
5fb0: 20 6c 6f 63 6b 65 64 22 2c 0d 0a 20 20 20 20 20   locked",..     
5fc0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d     /* SQLITE_NOM
5fd0: 45 4d 20 20 20 20 20 20 20 2a 2f 20 22 6f 75 74  EM       */ "out
5fe0: 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 0d 0a 20 20   of memory",..  
5ff0: 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f        /* SQLITE_
6000: 52 45 41 44 4f 4e 4c 59 20 20 20 20 2a 2f 20 22  READONLY    */ "
6010: 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65  attempt to write
6020: 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61 74 61   a readonly data
6030: 62 61 73 65 22 2c 0d 0a 20 20 20 20 20 20 20 20  base",..        
6040: 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45 52 52  /* SQLITE_INTERR
6050: 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65 72 72  UPT   */ "interr
6060: 75 70 74 65 64 22 2c 0d 0a 20 20 20 20 20 20 20  upted",..       
6070: 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52   /* SQLITE_IOERR
6080: 20 20 20 20 20 20 20 2a 2f 20 22 64 69 73 6b 20         */ "disk 
6090: 49 2f 4f 20 65 72 72 6f 72 22 2c 0d 0a 20 20 20  I/O error",..   
60a0: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43       /* SQLITE_C
60b0: 4f 52 52 55 50 54 20 20 20 20 20 2a 2f 20 22 64  ORRUPT     */ "d
60c0: 61 74 61 62 61 73 65 20 64 69 73 6b 20 69 6d 61  atabase disk ima
60d0: 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65 64 22  ge is malformed"
60e0: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51  ,..        /* SQ
60f0: 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 20 20  LITE_NOTFOUND   
6100: 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 6f 70 65   */ "unknown ope
6110: 72 61 74 69 6f 6e 22 2c 0d 0a 20 20 20 20 20 20  ration",..      
6120: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 46 55 4c 4c    /* SQLITE_FULL
6130: 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61 74 61          */ "data
6140: 62 61 73 65 20 6f 72 20 64 69 73 6b 20 69 73 20  base or disk is 
6150: 66 75 6c 6c 22 2c 0d 0a 20 20 20 20 20 20 20 20  full",..        
6160: 2f 2a 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50  /* SQLITE_CANTOP
6170: 45 4e 20 20 20 20 2a 2f 20 22 75 6e 61 62 6c 65  EN    */ "unable
6180: 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62 61 73   to open databas
6190: 65 20 66 69 6c 65 22 2c 0d 0a 20 20 20 20 20 20  e file",..      
61a0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 4f 54    /* SQLITE_PROT
61b0: 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 6c 6f 63 6b  OCOL    */ "lock
61c0: 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 22 2c 0d 0a  ing protocol",..
61d0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54          /* SQLIT
61e0: 45 5f 45 4d 50 54 59 20 20 20 20 20 20 20 2a 2f  E_EMPTY       */
61f0: 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69 6e 73   "table contains
6200: 20 6e 6f 20 64 61 74 61 22 2c 0d 0a 20 20 20 20   no data",..    
6210: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 53 43      /* SQLITE_SC
6220: 48 45 4d 41 20 20 20 20 20 20 2a 2f 20 22 64 61  HEMA      */ "da
6230: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61  tabase schema ha
6240: 73 20 63 68 61 6e 67 65 64 22 2c 0d 0a 20 20 20  s changed",..   
6250: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 54       /* SQLITE_T
6260: 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f 20 22 73  OOBIG      */ "s
6270: 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 74 6f  tring or blob to
6280: 6f 20 62 69 67 22 2c 0d 0a 20 20 20 20 20 20 20  o big",..       
6290: 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54   /* SQLITE_CONST
62a0: 52 41 49 4e 54 20 20 2a 2f 20 22 63 6f 6e 73 74  RAINT  */ "const
62b0: 72 61 69 6e 74 20 66 61 69 6c 65 64 22 2c 0d 0a  raint failed",..
62c0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54          /* SQLIT
62d0: 45 5f 4d 49 53 4d 41 54 43 48 20 20 20 20 2a 2f  E_MISMATCH    */
62e0: 20 22 64 61 74 61 74 79 70 65 20 6d 69 73 6d 61   "datatype misma
62f0: 74 63 68 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f  tch",..        /
6300: 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20  * SQLITE_MISUSE 
6310: 20 20 20 20 20 2a 2f 20 22 6c 69 62 72 61 72 79       */ "library
6320: 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65 64 20   routine called 
6330: 6f 75 74 20 6f 66 20 73 65 71 75 65 6e 63 65 22  out of sequence"
6340: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51  ,..        /* SQ
6350: 4c 49 54 45 5f 4e 4f 4c 46 53 20 20 20 20 20 20  LITE_NOLFS      
6360: 20 2a 2f 20 22 6c 61 72 67 65 20 66 69 6c 65 20   */ "large file 
6370: 73 75 70 70 6f 72 74 20 69 73 20 64 69 73 61 62  support is disab
6380: 6c 65 64 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f  led",..        /
6390: 2a 20 53 51 4c 49 54 45 5f 41 55 54 48 20 20 20  * SQLITE_AUTH   
63a0: 20 20 20 20 20 2a 2f 20 22 61 75 74 68 6f 72 69       */ "authori
63b0: 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64 22 2c 0d  zation denied",.
63c0: 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49  .        /* SQLI
63d0: 54 45 5f 46 4f 52 4d 41 54 20 20 20 20 20 20 2a  TE_FORMAT      *
63e0: 2f 20 22 61 75 78 69 6c 69 61 72 79 20 64 61 74  / "auxiliary dat
63f0: 61 62 61 73 65 20 66 6f 72 6d 61 74 20 65 72 72  abase format err
6400: 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a  or",..        /*
6410: 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20 20 20   SQLITE_RANGE   
6420: 20 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f 72 20      */ "bind or 
6430: 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f 75 74  column index out
6440: 20 6f 66 20 72 61 6e 67 65 22 2c 0d 0a 20 20 20   of range",..   
6450: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e       /* SQLITE_N
6460: 4f 54 41 44 42 20 20 20 20 20 20 2a 2f 20 22 66  OTADB      */ "f
6470: 69 6c 65 20 69 73 20 65 6e 63 72 79 70 74 65 64  ile is encrypted
6480: 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 64 61 74   or is not a dat
6490: 61 62 61 73 65 22 0a 20 20 20 20 7d 3b 0a 0d 0a  abase".    };...
64a0: 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f      ////////////
64b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
64c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
64d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
64e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
64f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6500: 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c  ///....    /// <
6510: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
6520: 2f 20 52 65 74 75 72 6e 73 20 74 68 65 20 65 72  / Returns the er
6530: 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f 72 20  ror message for 
6540: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 53 51  the specified SQ
6550: 4c 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65  Lite return code
6560: 20 75 73 69 6e 67 0d 0a 20 20 20 20 2f 2f 2f 20   using..    /// 
6570: 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 74 61  the internal sta
6580: 74 69 63 20 6c 6f 6f 6b 75 70 20 74 61 62 6c 65  tic lookup table
6590: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  ...    /// </sum
65a0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  mary>..    /// <
65b0: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 72 63 22 3e  param name="rc">
65c0: 54 68 65 20 53 51 4c 69 74 65 20 72 65 74 75 72  The SQLite retur
65d0: 6e 20 63 6f 64 65 2e 3c 2f 70 61 72 61 6d 3e 0d  n code.</param>.
65e0: 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e  .    /// <return
65f0: 73 3e 54 68 65 20 65 72 72 6f 72 20 6d 65 73 73  s>The error mess
6600: 61 67 65 20 6f 72 20 6e 75 6c 6c 20 69 66 20 69  age or null if i
6610: 74 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e  t cannot be foun
6620: 64 2e 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20  d.</returns>..  
6630: 20 20 70 72 69 76 61 74 65 20 73 74 61 74 69 63    private static
6640: 20 73 74 72 69 6e 67 20 46 61 6c 6c 62 61 63 6b   string Fallback
6650: 47 65 74 45 72 72 6f 72 53 74 72 69 6e 67 28 53  GetErrorString(S
6660: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 72  QLiteErrorCode r
6670: 63 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  c)..    {..     
6680: 20 20 20 69 66 20 28 5f 65 72 72 6f 72 4d 65 73     if (_errorMes
6690: 73 61 67 65 73 20 3d 3d 20 6e 75 6c 6c 29 0d 0a  sages == null)..
66a0: 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75              retu
66b0: 72 6e 20 6e 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20  rn null;....    
66c0: 20 20 20 20 69 6e 74 20 69 6e 64 65 78 20 3d 20      int index = 
66d0: 28 69 6e 74 29 72 63 3b 0d 0a 0d 0a 20 20 20 20  (int)rc;....    
66e0: 20 20 20 20 69 66 20 28 28 69 6e 64 65 78 20 3c      if ((index <
66f0: 20 30 29 20 7c 7c 20 28 69 6e 64 65 78 20 3e 3d   0) || (index >=
6700: 20 5f 65 72 72 6f 72 4d 65 73 73 61 67 65 73 2e   _errorMessages.
6710: 4c 65 6e 67 74 68 29 29 0d 0a 20 20 20 20 20 20  Length))..      
6720: 20 20 20 20 20 20 69 6e 64 65 78 20 3d 20 28 69        index = (i
6730: 6e 74 29 53 51 4c 69 74 65 45 72 72 6f 72 43 6f  nt)SQLiteErrorCo
6740: 64 65 2e 45 72 72 6f 72 3b 20 2f 2a 20 4d 61 6b  de.Error; /* Mak
6750: 65 20 69 6e 74 6f 20 67 65 6e 65 72 69 63 20 65  e into generic e
6760: 72 72 6f 72 2e 20 2a 2f 0d 0a 0d 0a 20 20 20 20  rror. */....    
6770: 20 20 20 20 72 65 74 75 72 6e 20 5f 65 72 72 6f      return _erro
6780: 72 4d 65 73 73 61 67 65 73 5b 69 6e 64 65 78 5d  rMessages[index]
6790: 3b 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 2f  ;.    }....    /
67a0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
67b0: 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68    /// Returns th
67c0: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  e error message 
67d0: 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 65  for the specifie
67e0: 64 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20  d SQLite return 
67f0: 63 6f 64 65 20 75 73 69 6e 67 0d 0a 20 20 20 20  code using..    
6800: 2f 2f 2f 20 74 68 65 20 73 71 6c 69 74 65 33 5f  /// the sqlite3_
6810: 65 72 72 73 74 72 28 29 20 66 75 6e 63 74 69 6f  errstr() functio
6820: 6e 2c 20 66 61 6c 6c 69 6e 67 20 62 61 63 6b 20  n, falling back 
6830: 74 6f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20  to the internal 
6840: 6c 6f 6f 6b 75 70 0d 0a 20 20 20 20 2f 2f 2f 20  lookup..    /// 
6850: 74 61 62 6c 65 20 69 66 20 6e 65 63 65 73 73 61  table if necessa
6860: 72 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ry...    /// </s
6870: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
6880: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 72 63   <param name="rc
6890: 22 3e 54 68 65 20 53 51 4c 69 74 65 20 72 65 74  ">The SQLite ret
68a0: 75 72 6e 20 63 6f 64 65 2e 3c 2f 70 61 72 61 6d  urn code.</param
68b0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75  >..    /// <retu
68c0: 72 6e 73 3e 54 68 65 20 65 72 72 6f 72 20 6d 65  rns>The error me
68d0: 73 73 61 67 65 20 6f 72 20 6e 75 6c 6c 20 69 66  ssage or null if
68e0: 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f   it cannot be fo
68f0: 75 6e 64 2e 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a  und.</returns>..
6900: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74 61      internal sta
6910: 74 69 63 20 73 74 72 69 6e 67 20 47 65 74 45 72  tic string GetEr
6920: 72 6f 72 53 74 72 69 6e 67 28 53 51 4c 69 74 65  rorString(SQLite
6930: 45 72 72 6f 72 43 6f 64 65 20 72 63 29 0d 0a 20  ErrorCode rc).. 
6940: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 74 72     {..        tr
6950: 79 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20  y..        {..  
6960: 20 20 20 20 20 20 20 20 20 20 49 6e 74 50 74 72            IntPtr
6970: 20 70 74 72 20 3d 20 55 6e 73 61 66 65 4e 61 74   ptr = UnsafeNat
6980: 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74  iveMethods.sqlit
6990: 65 33 5f 65 72 72 73 74 72 28 72 63 29 3b 0d 0a  e3_errstr(rc);..
69a0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  ..            if
69b0: 20 28 70 74 72 20 21 3d 20 49 6e 74 50 74 72 2e   (ptr != IntPtr.
69c0: 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20  Zero)..         
69d0: 20 20 20 7b 0d 0a 23 69 66 20 21 50 4c 41 54 46     {..#if !PLATF
69e0: 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45  ORM_COMPACTFRAME
69f0: 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20 20 20  WORK..          
6a00: 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 61 72        return Mar
6a10: 73 68 61 6c 2e 50 74 72 54 6f 53 74 72 69 6e 67  shal.PtrToString
6a20: 41 6e 73 69 28 70 74 72 29 3b 0d 0a 23 65 6c 73  Ansi(ptr);..#els
6a30: 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  e..             
6a40: 20 20 20 72 65 74 75 72 6e 20 55 54 46 38 54 6f     return UTF8To
6a50: 53 74 72 69 6e 67 28 70 74 72 2c 20 2d 31 29 3b  String(ptr, -1);
6a60: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20  ..#endif..      
6a70: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20        }..       
6a80: 20 7d 0d 0a 20 20 20 20 20 20 20 20 63 61 74 63   }..        catc
6a90: 68 20 28 45 6e 74 72 79 50 6f 69 6e 74 4e 6f 74  h (EntryPointNot
6aa0: 46 6f 75 6e 64 45 78 63 65 70 74 69 6f 6e 29 0d  FoundException).
6ab0: 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20  .        {..    
6ac0: 20 20 20 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f          // do no
6ad0: 74 68 69 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20  thing...        
6ae0: 7d 0d 0a 0d 0a 20 20 20 20 20 20 20 20 72 65 74  }....        ret
6af0: 75 72 6e 20 46 61 6c 6c 62 61 63 6b 47 65 74 45  urn FallbackGetE
6b00: 72 72 6f 72 53 74 72 69 6e 67 28 72 63 29 3b 0d  rrorString(rc);.
6b10: 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e  .    }....    in
6b20: 74 65 72 6e 61 6c 20 73 74 61 74 69 63 20 73 74  ternal static st
6b30: 72 69 6e 67 20 47 65 74 4c 61 73 74 45 72 72 6f  ring GetLastErro
6b40: 72 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  r(SQLiteConnecti
6b50: 6f 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e  onHandle hdl, In
6b60: 74 50 74 72 20 64 62 29 0d 0a 20 20 20 20 7b 0d  tPtr db)..    {.
6b70: 0a 20 20 20 20 20 20 20 20 69 66 20 28 28 68 64  .        if ((hd
6b80: 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28 64  l == null) || (d
6b90: 62 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f  b == IntPtr.Zero
6ba0: 29 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  ))..            
6bb0: 72 65 74 75 72 6e 20 22 6e 75 6c 6c 20 63 6f 6e  return "null con
6bc0: 6e 65 63 74 69 6f 6e 20 6f 72 20 64 61 74 61 62  nection or datab
6bd0: 61 73 65 20 68 61 6e 64 6c 65 22 3b 0d 0a 0d 0a  ase handle";....
6be0: 20 20 20 20 20 20 20 20 73 74 72 69 6e 67 20 72          string r
6bf0: 65 73 75 6c 74 20 3d 20 6e 75 6c 6c 3b 0d 0a 0d  esult = null;...
6c00: 0a 20 20 20 20 20 20 20 20 74 72 79 0d 0a 20 20  .        try..  
6c10: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20        {..       
6c20: 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f 74 68 69       // do nothi
6c30: 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a  ng...        }..
6c40: 20 20 20 20 20 20 20 20 66 69 6e 61 6c 6c 79 20          finally 
6c50: 2f 2a 20 4e 4f 54 45 3a 20 54 68 72 65 61 64 2e  /* NOTE: Thread.
6c60: 41 62 6f 72 74 28 29 20 70 72 6f 74 65 63 74 69  Abort() protecti
6c70: 6f 6e 2e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20  on. */..        
6c80: 7b 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52 4d 5f  {..#if PLATFORM_
6c90: 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 4b  COMPACTFRAMEWORK
6ca0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f  ..            lo
6cb0: 63 6b 20 28 68 64 6c 2e 73 79 6e 63 52 6f 6f 74  ck (hdl.syncRoot
6cc0: 29 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20  )..#else..      
6cd0: 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c 29        lock (hdl)
6ce0: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20  ..#endif..      
6cf0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20        {..       
6d00: 20 20 20 20 20 20 20 20 20 69 66 20 28 21 68 64           if (!hd
6d10: 6c 2e 49 73 49 6e 76 61 6c 69 64 20 26 26 20 21  l.IsInvalid && !
6d20: 68 64 6c 2e 49 73 43 6c 6f 73 65 64 29 0d 0a 20  hdl.IsClosed).. 
6d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b                 {
6d40: 0d 0a 23 69 66 20 21 53 51 4c 49 54 45 5f 53 54  ..#if !SQLITE_ST
6d50: 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20 20 20  ANDARD..        
6d60: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20              int 
6d70: 6c 65 6e 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  len;..          
6d80: 20 20 20 20 20 20 20 20 20 20 72 65 73 75 6c 74            result
6d90: 20 3d 20 55 54 46 38 54 6f 53 74 72 69 6e 67 28   = UTF8ToString(
6da0: 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68  UnsafeNativeMeth
6db0: 6f 64 73 2e 73 71 6c 69 74 65 33 5f 65 72 72 6d  ods.sqlite3_errm
6dc0: 73 67 5f 69 6e 74 65 72 6f 70 28 64 62 2c 20 6f  sg_interop(db, o
6dd0: 75 74 20 6c 65 6e 29 2c 20 6c 65 6e 29 3b 0d 0a  ut len), len);..
6de0: 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20  #else..         
6df0: 20 20 20 20 20 20 20 20 20 20 20 72 65 73 75 6c             resul
6e00: 74 20 3d 20 55 54 46 38 54 6f 53 74 72 69 6e 67  t = UTF8ToString
6e10: 28 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74  (UnsafeNativeMet
6e20: 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 65 72 72  hods.sqlite3_err
6e30: 6d 73 67 28 64 62 29 2c 20 2d 31 29 3b 0d 0a 23  msg(db), -1);..#
6e40: 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 20  endif..         
6e50: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
6e60: 20 20 20 20 20 20 20 20 20 20 65 6c 73 65 0d 0a            else..
6e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6e80: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  {..             
6e90: 20 20 20 20 20 20 20 72 65 73 75 6c 74 20 3d 20         result = 
6ea0: 22 63 6c 6f 73 65 64 20 6f 72 20 69 6e 76 61 6c  "closed or inval
6eb0: 69 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61  id connection ha
6ec0: 6e 64 6c 65 22 3b 0d 0a 20 20 20 20 20 20 20 20  ndle";..        
6ed0: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20          }..     
6ee0: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
6ef0: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 47 43 2e    }..        GC.
6f00: 4b 65 65 70 41 6c 69 76 65 28 68 64 6c 29 3b 0d  KeepAlive(hdl);.
6f10: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
6f20: 72 65 73 75 6c 74 3b 0d 0a 20 20 20 20 7d 0d 0a  result;..    }..
6f30: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 73  ..    internal s
6f40: 74 61 74 69 63 20 76 6f 69 64 20 46 69 6e 69 73  tatic void Finis
6f50: 68 42 61 63 6b 75 70 28 53 51 4c 69 74 65 43 6f  hBackup(SQLiteCo
6f60: 6e 6e 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20 68  nnectionHandle h
6f70: 64 6c 2c 20 49 6e 74 50 74 72 20 62 61 63 6b 75  dl, IntPtr backu
6f80: 70 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  p)..    {..     
6f90: 20 20 20 69 66 20 28 28 68 64 6c 20 3d 3d 20 6e     if ((hdl == n
6fa0: 75 6c 6c 29 20 7c 7c 20 28 62 61 63 6b 75 70 20  ull) || (backup 
6fb0: 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 29  == IntPtr.Zero))
6fc0: 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20 20   return;....    
6fd0: 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20 20 20      try..       
6fe0: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
6ff0: 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a  // do nothing...
7000: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20          }..     
7010: 20 20 20 66 69 6e 61 6c 6c 79 20 2f 2a 20 4e 4f     finally /* NO
7020: 54 45 3a 20 54 68 72 65 61 64 2e 41 62 6f 72 74  TE: Thread.Abort
7030: 28 29 20 70 72 6f 74 65 63 74 69 6f 6e 2e 20 2a  () protection. *
7040: 2f 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 69  /..        {..#i
7050: 66 20 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41  f PLATFORM_COMPA
7060: 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 20  CTFRAMEWORK..   
7070: 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68           lock (h
7080: 64 6c 2e 73 79 6e 63 52 6f 6f 74 29 0d 0a 23 65  dl.syncRoot)..#e
7090: 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20  lse..           
70a0: 20 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 23 65 6e   lock (hdl)..#en
70b0: 64 69 66 0d 0a 20 20 20 20 20 20 20 20 20 20 20  dif..           
70c0: 20 7b 0d 0a 23 69 66 20 21 53 51 4c 49 54 45 5f   {..#if !SQLITE_
70d0: 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20  STANDARD..      
70e0: 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65            SQLite
70f0: 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e  ErrorCode n = Un
7100: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
7110: 73 2e 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70  s.sqlite3_backup
7120: 5f 66 69 6e 69 73 68 5f 69 6e 74 65 72 6f 70 28  _finish_interop(
7130: 62 61 63 6b 75 70 29 3b 0d 0a 23 65 6c 73 65 0d  backup);..#else.
7140: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
7150: 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65   SQLiteErrorCode
7160: 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76   n = UnsafeNativ
7170: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33  eMethods.sqlite3
7180: 5f 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 62  _backup_finish(b
7190: 61 63 6b 75 70 29 3b 0d 0a 23 65 6e 64 69 66 0d  ackup);..#endif.
71a0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
71b0: 20 69 66 20 28 6e 20 21 3d 20 53 51 4c 69 74 65   if (n != SQLite
71c0: 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 29 20 74 68  ErrorCode.Ok) th
71d0: 72 6f 77 20 6e 65 77 20 53 51 4c 69 74 65 45 78  row new SQLiteEx
71e0: 63 65 70 74 69 6f 6e 28 6e 2c 20 6e 75 6c 6c 29  ception(n, null)
71f0: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d  ;..            }
7200: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20  ..        }..   
7210: 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e   }....    intern
7220: 61 6c 20 73 74 61 74 69 63 20 76 6f 69 64 20 46  al static void F
7230: 69 6e 61 6c 69 7a 65 53 74 61 74 65 6d 65 6e 74  inalizeStatement
7240: 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f  (SQLiteConnectio
7250: 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74  nHandle hdl, Int
7260: 50 74 72 20 73 74 6d 74 29 0d 0a 20 20 20 20 7b  Ptr stmt)..    {
7270: 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28 28 68  ..        if ((h
7280: 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28  dl == null) || (
7290: 73 74 6d 74 20 3d 3d 20 49 6e 74 50 74 72 2e 5a  stmt == IntPtr.Z
72a0: 65 72 6f 29 29 20 72 65 74 75 72 6e 3b 0d 0a 0d  ero)) return;...
72b0: 0a 20 20 20 20 20 20 20 20 74 72 79 0d 0a 20 20  .        try..  
72c0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20        {..       
72d0: 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f 74 68 69       // do nothi
72e0: 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a  ng...        }..
72f0: 20 20 20 20 20 20 20 20 66 69 6e 61 6c 6c 79 20          finally 
7300: 2f 2a 20 4e 4f 54 45 3a 20 54 68 72 65 61 64 2e  /* NOTE: Thread.
7310: 41 62 6f 72 74 28 29 20 70 72 6f 74 65 63 74 69  Abort() protecti
7320: 6f 6e 2e 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20  on. */..        
7330: 7b 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52 4d 5f  {..#if PLATFORM_
7340: 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52 4b  COMPACTFRAMEWORK
7350: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f  ..            lo
7360: 63 6b 20 28 68 64 6c 2e 73 79 6e 63 52 6f 6f 74  ck (hdl.syncRoot
7370: 29 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20  )..#else..      
7380: 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c 29        lock (hdl)
7390: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20  ..#endif..      
73a0: 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 53 51        {..#if !SQ
73b0: 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a 20  LITE_STANDARD.. 
73c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53                 S
73d0: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 6e  QLiteErrorCode n
73e0: 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d   = UnsafeNativeM
73f0: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 66  ethods.sqlite3_f
7400: 69 6e 61 6c 69 7a 65 5f 69 6e 74 65 72 6f 70 28  inalize_interop(
7410: 73 74 6d 74 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20  stmt);..#else.. 
7420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53                 S
7430: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 6e  QLiteErrorCode n
7440: 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d   = UnsafeNativeM
7450: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 66  ethods.sqlite3_f
7460: 69 6e 61 6c 69 7a 65 28 73 74 6d 74 29 3b 0d 0a  inalize(stmt);..
7470: 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20  #endif..        
7480: 20 20 20 20 20 20 20 20 69 66 20 28 6e 20 21 3d          if (n !=
7490: 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65   SQLiteErrorCode
74a0: 2e 4f 6b 29 20 74 68 72 6f 77 20 6e 65 77 20 53  .Ok) throw new S
74b0: 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 28 6e  QLiteException(n
74c0: 2c 20 6e 75 6c 6c 29 3b 0d 0a 20 20 20 20 20 20  , null);..      
74d0: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20        }..       
74e0: 20 7d 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20   }..    }....   
74f0: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63   internal static
7500: 20 76 6f 69 64 20 43 6c 6f 73 65 43 6f 6e 6e 65   void CloseConne
7510: 63 74 69 6f 6e 28 53 51 4c 69 74 65 43 6f 6e 6e  ction(SQLiteConn
7520: 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20 68 64 6c  ectionHandle hdl
7530: 2c 20 49 6e 74 50 74 72 20 64 62 29 0d 0a 20 20  , IntPtr db)..  
7540: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 69 66 20    {..        if 
7550: 28 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c  ((hdl == null) |
7560: 7c 20 28 64 62 20 3d 3d 20 49 6e 74 50 74 72 2e  | (db == IntPtr.
7570: 5a 65 72 6f 29 29 20 72 65 74 75 72 6e 3b 0d 0a  Zero)) return;..
7580: 0d 0a 20 20 20 20 20 20 20 20 74 72 79 0d 0a 20  ..        try.. 
7590: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20         {..      
75a0: 20 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f 74 68        // do noth
75b0: 69 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 7d 0d  ing...        }.
75c0: 0a 20 20 20 20 20 20 20 20 66 69 6e 61 6c 6c 79  .        finally
75d0: 20 2f 2a 20 4e 4f 54 45 3a 20 54 68 72 65 61 64   /* NOTE: Thread
75e0: 2e 41 62 6f 72 74 28 29 20 70 72 6f 74 65 63 74  .Abort() protect
75f0: 69 6f 6e 2e 20 2a 2f 0d 0a 20 20 20 20 20 20 20  ion. */..       
7600: 20 7b 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52 4d   {..#if PLATFORM
7610: 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52  _COMPACTFRAMEWOR
7620: 4b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c  K..            l
7630: 6f 63 6b 20 28 68 64 6c 2e 73 79 6e 63 52 6f 6f  ock (hdl.syncRoo
7640: 74 29 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20  t)..#else..     
7650: 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c         lock (hdl
7660: 29 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20  )..#endif..     
7670: 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 53         {..#if !S
7680: 51 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a  QLITE_STANDARD..
7690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
76a0: 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20  SQLiteErrorCode 
76b0: 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65  n = UnsafeNative
76c0: 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f  Methods.sqlite3_
76d0: 63 6c 6f 73 65 5f 69 6e 74 65 72 6f 70 28 64 62  close_interop(db
76e0: 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20  );..#else..     
76f0: 20 20 20 20 20 20 20 20 20 20 20 52 65 73 65 74             Reset
7700: 43 6f 6e 6e 65 63 74 69 6f 6e 28 68 64 6c 2c 20  Connection(hdl, 
7710: 64 62 2c 20 66 61 6c 73 65 29 3b 0d 0a 0d 0a 20  db, false);.... 
7720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53                 S
7730: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 6e  QLiteErrorCode n
7740: 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d   = UnsafeNativeM
7750: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 63  ethods.sqlite3_c
7760: 6c 6f 73 65 28 64 62 29 3b 0d 0a 23 65 6e 64 69  lose(db);..#endi
7770: 66 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  f..             
7780: 20 20 20 69 66 20 28 6e 20 21 3d 20 53 51 4c 69     if (n != SQLi
7790: 74 65 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 29 20  teErrorCode.Ok) 
77a0: 74 68 72 6f 77 20 6e 65 77 20 53 51 4c 69 74 65  throw new SQLite
77b0: 45 78 63 65 70 74 69 6f 6e 28 6e 2c 20 47 65 74  Exception(n, Get
77c0: 4c 61 73 74 45 72 72 6f 72 28 68 64 6c 2c 20 64  LastError(hdl, d
77d0: 62 29 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  b));..          
77e0: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a    }..        }..
77f0: 20 20 20 20 7d 0d 0a 0d 0a 23 69 66 20 21 49 4e      }....#if !IN
7800: 54 45 52 4f 50 5f 4c 45 47 41 43 59 5f 43 4c 4f  TEROP_LEGACY_CLO
7810: 53 45 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  SE..    internal
7820: 20 73 74 61 74 69 63 20 76 6f 69 64 20 43 6c 6f   static void Clo
7830: 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 56 32 28 53  seConnectionV2(S
7840: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48  QLiteConnectionH
7850: 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74 50 74  andle hdl, IntPt
7860: 72 20 64 62 29 0d 0a 20 20 20 20 7b 0d 0a 20 20  r db)..    {..  
7870: 20 20 20 20 20 20 69 66 20 28 28 68 64 6c 20 3d        if ((hdl =
7880: 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28 64 62 20 3d  = null) || (db =
7890: 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 29 20  = IntPtr.Zero)) 
78a0: 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20 20 20  return;....     
78b0: 20 20 20 74 72 79 0d 0a 20 20 20 20 20 20 20 20     try..        
78c0: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f  {..            /
78d0: 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20  / do nothing... 
78e0: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
78f0: 20 20 66 69 6e 61 6c 6c 79 20 2f 2a 20 4e 4f 54    finally /* NOT
7900: 45 3a 20 54 68 72 65 61 64 2e 41 62 6f 72 74 28  E: Thread.Abort(
7910: 29 20 70 72 6f 74 65 63 74 69 6f 6e 2e 20 2a 2f  ) protection. */
7920: 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 69 66  ..        {..#if
7930: 20 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43   PLATFORM_COMPAC
7940: 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20  TFRAMEWORK..    
7950: 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64          lock (hd
7960: 6c 2e 73 79 6e 63 52 6f 6f 74 29 0d 0a 23 65 6c  l.syncRoot)..#el
7970: 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  se..            
7980: 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 23 65 6e 64  lock (hdl)..#end
7990: 69 66 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  if..            
79a0: 7b 0d 0a 23 69 66 20 21 53 51 4c 49 54 45 5f 53  {..#if !SQLITE_S
79b0: 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20 20  TANDARD..       
79c0: 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45           SQLiteE
79d0: 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e 73  rrorCode n = Uns
79e0: 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73  afeNativeMethods
79f0: 2e 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 69  .sqlite3_close_i
7a00: 6e 74 65 72 6f 70 28 64 62 29 3b 0d 0a 23 65 6c  nterop(db);..#el
7a10: 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  se..            
7a20: 20 20 20 20 52 65 73 65 74 43 6f 6e 6e 65 63 74      ResetConnect
7a30: 69 6f 6e 28 68 64 6c 2c 20 64 62 2c 20 66 61 6c  ion(hdl, db, fal
7a40: 73 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20  se);....        
7a50: 20 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72          SQLiteEr
7a60: 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e 73 61  rorCode n = Unsa
7a70: 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e  feNativeMethods.
7a80: 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 76 32  sqlite3_close_v2
7a90: 28 64 62 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20  (db);..#endif.. 
7aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69                 i
7ab0: 66 20 28 6e 20 21 3d 20 53 51 4c 69 74 65 45 72  f (n != SQLiteEr
7ac0: 72 6f 72 43 6f 64 65 2e 4f 6b 29 20 74 68 72 6f  rorCode.Ok) thro
7ad0: 77 20 6e 65 77 20 53 51 4c 69 74 65 45 78 63 65  w new SQLiteExce
7ae0: 70 74 69 6f 6e 28 6e 2c 20 47 65 74 4c 61 73 74  ption(n, GetLast
7af0: 45 72 72 6f 72 28 68 64 6c 2c 20 64 62 29 29 3b  Error(hdl, db));
7b00: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d  ..            }.
7b10: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20  .        }..    
7b20: 7d 0d 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 20 20  }..#endif....   
7b30: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63   internal static
7b40: 20 62 6f 6f 6c 20 52 65 73 65 74 43 6f 6e 6e 65   bool ResetConne
7b50: 63 74 69 6f 6e 28 53 51 4c 69 74 65 43 6f 6e 6e  ction(SQLiteConn
7b60: 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20 68 64 6c  ectionHandle hdl
7b70: 2c 20 49 6e 74 50 74 72 20 64 62 2c 20 62 6f 6f  , IntPtr db, boo
7b80: 6c 20 63 61 6e 54 68 72 6f 77 29 0d 0a 20 20 20  l canThrow)..   
7b90: 20 7b 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28   {..        if (
7ba0: 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c  (hdl == null) ||
7bb0: 20 28 64 62 20 3d 3d 20 49 6e 74 50 74 72 2e 5a   (db == IntPtr.Z
7bc0: 65 72 6f 29 29 20 72 65 74 75 72 6e 20 66 61 6c  ero)) return fal
7bd0: 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 62  se;....        b
7be0: 6f 6f 6c 20 72 65 73 75 6c 74 20 3d 20 66 61 6c  ool result = fal
7bf0: 73 65 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 74  se;....        t
7c00: 72 79 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20  ry..        {.. 
7c10: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 64 6f             // do
7c20: 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20 20 20 20 20   nothing...     
7c30: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 66 69     }..        fi
7c40: 6e 61 6c 6c 79 20 2f 2a 20 4e 4f 54 45 3a 20 54  nally /* NOTE: T
7c50: 68 72 65 61 64 2e 41 62 6f 72 74 28 29 20 70 72  hread.Abort() pr
7c60: 6f 74 65 63 74 69 6f 6e 2e 20 2a 2f 0d 0a 20 20  otection. */..  
7c70: 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 50 4c 41        {..#if PLA
7c80: 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41  TFORM_COMPACTFRA
7c90: 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20  MEWORK..        
7ca0: 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c 2e 73 79      lock (hdl.sy
7cb0: 6e 63 52 6f 6f 74 29 0d 0a 23 65 6c 73 65 0d 0a  ncRoot)..#else..
7cc0: 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b              lock
7cd0: 20 28 68 64 6c 29 0d 0a 23 65 6e 64 69 66 0d 0a   (hdl)..#endif..
7ce0: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20              {.. 
7cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69                 i
7d00: 66 20 28 63 61 6e 54 68 72 6f 77 20 26 26 20 68  f (canThrow && h
7d10: 64 6c 2e 49 73 49 6e 76 61 6c 69 64 29 0d 0a 20  dl.IsInvalid).. 
7d20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7d30: 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76     throw new Inv
7d40: 61 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63  alidOperationExc
7d50: 65 70 74 69 6f 6e 28 22 54 68 65 20 63 6f 6e 6e  eption("The conn
7d60: 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 69 73  ection handle is
7d70: 20 69 6e 76 61 6c 69 64 2e 22 29 3b 0d 0a 0d 0a   invalid.");....
7d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7d90: 69 66 20 28 63 61 6e 54 68 72 6f 77 20 26 26 20  if (canThrow && 
7da0: 68 64 6c 2e 49 73 43 6c 6f 73 65 64 29 0d 0a 20  hdl.IsClosed).. 
7db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7dc0: 20 20 20 74 68 72 6f 77 20 6e 65 77 20 49 6e 76     throw new Inv
7dd0: 61 6c 69 64 4f 70 65 72 61 74 69 6f 6e 45 78 63  alidOperationExc
7de0: 65 70 74 69 6f 6e 28 22 54 68 65 20 63 6f 6e 6e  eption("The conn
7df0: 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 69 73  ection handle is
7e00: 20 63 6c 6f 73 65 64 2e 22 29 3b 0d 0a 0d 0a 20   closed.");.... 
7e10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69                 i
7e20: 66 20 28 21 68 64 6c 2e 49 73 49 6e 76 61 6c 69  f (!hdl.IsInvali
7e30: 64 20 26 26 20 21 68 64 6c 2e 49 73 43 6c 6f 73  d && !hdl.IsClos
7e40: 65 64 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ed)..           
7e50: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20       {..        
7e60: 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74 50              IntP
7e70: 74 72 20 73 74 6d 74 20 3d 20 49 6e 74 50 74 72  tr stmt = IntPtr
7e80: 2e 5a 65 72 6f 3b 0d 0a 20 20 20 20 20 20 20 20  .Zero;..        
7e90: 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69              SQLi
7ea0: 74 65 45 72 72 6f 72 43 6f 64 65 20 6e 3b 0d 0a  teErrorCode n;..
7eb0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
7ec0: 20 20 20 20 20 20 64 6f 0d 0a 20 20 20 20 20 20        do..      
7ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d                {.
7ee0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
7ef0: 20 20 20 20 20 20 20 20 20 73 74 6d 74 20 3d 20           stmt = 
7f00: 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68  UnsafeNativeMeth
7f10: 6f 64 73 2e 73 71 6c 69 74 65 33 5f 6e 65 78 74  ods.sqlite3_next
7f20: 5f 73 74 6d 74 28 64 62 2c 20 73 74 6d 74 29 3b  _stmt(db, stmt);
7f30: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
7f40: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 73 74            if (st
7f50: 6d 74 20 21 3d 20 49 6e 74 50 74 72 2e 5a 65 72  mt != IntPtr.Zer
7f60: 6f 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  o)..            
7f70: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 23              {..#
7f80: 69 66 20 21 53 51 4c 49 54 45 5f 53 54 41 4e 44  if !SQLITE_STAND
7f90: 41 52 44 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ARD..           
7fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7fb0: 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76   n = UnsafeNativ
7fc0: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33  eMethods.sqlite3
7fd0: 5f 72 65 73 65 74 5f 69 6e 74 65 72 6f 70 28 73  _reset_interop(s
7fe0: 74 6d 74 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20  tmt);..#else..  
7ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8000: 20 20 20 20 20 20 20 20 20 20 6e 20 3d 20 55 6e            n = Un
8010: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
8020: 73 2e 73 71 6c 69 74 65 33 5f 72 65 73 65 74 28  s.sqlite3_reset(
8030: 73 74 6d 74 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a  stmt);..#endif..
8040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8050: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20          }..     
8060: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d                 }
8070: 20 77 68 69 6c 65 20 28 73 74 6d 74 20 21 3d 20   while (stmt != 
8080: 49 6e 74 50 74 72 2e 5a 65 72 6f 29 3b 0d 0a 0d  IntPtr.Zero);...
8090: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
80a0: 20 20 20 20 20 2f 2f 0d 0a 20 20 20 20 20 20 20       //..       
80b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20               // 
80c0: 4e 4f 54 45 3a 20 49 73 20 61 20 74 72 61 6e 73  NOTE: Is a trans
80d0: 61 63 74 69 6f 6e 20 4e 4f 54 20 70 65 6e 64 69  action NOT pendi
80e0: 6e 67 20 6f 6e 20 74 68 65 20 63 6f 6e 6e 65 63  ng on the connec
80f0: 74 69 6f 6e 3f 0d 0a 20 20 20 20 20 20 20 20 20  tion?..         
8100: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 0d 0a 20             //.. 
8110: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8120: 20 20 20 69 66 20 28 49 73 41 75 74 6f 63 6f 6d     if (IsAutocom
8130: 6d 69 74 28 68 64 6c 2c 20 64 62 29 29 0d 0a 20  mit(hdl, db)).. 
8140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8150: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20     {..          
8160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65                re
8170: 73 75 6c 74 20 3d 20 74 72 75 65 3b 0d 0a 20 20  sult = true;..  
8180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8190: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20    }..           
81a0: 20 20 20 20 20 20 20 20 20 65 6c 73 65 0d 0a 20           else.. 
81b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
81c0: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20     {..          
81d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 20                n 
81e0: 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65  = UnsafeNativeMe
81f0: 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 65 78  thods.sqlite3_ex
8200: 65 63 28 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ec(..           
8210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8220: 20 64 62 2c 20 54 6f 55 54 46 38 28 22 52 4f 4c   db, ToUTF8("ROL
8230: 4c 42 41 43 4b 22 29 2c 20 49 6e 74 50 74 72 2e  LBACK"), IntPtr.
8240: 5a 65 72 6f 2c 20 49 6e 74 50 74 72 2e 5a 65 72  Zero, IntPtr.Zer
8250: 6f 2c 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  o,..            
8260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8270: 6f 75 74 20 73 74 6d 74 29 3b 0d 0a 0d 0a 20 20  out stmt);....  
8280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8290: 20 20 20 20 20 20 69 66 20 28 6e 20 3d 3d 20 53        if (n == S
82a0: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 2e 4f  QLiteErrorCode.O
82b0: 6b 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  k)..            
82c0: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20              {.. 
82d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
82e0: 20 20 20 20 20 20 20 20 20 20 20 72 65 73 75 6c             resul
82f0: 74 20 3d 20 74 72 75 65 3b 0d 0a 20 20 20 20 20  t = true;..     
8300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8310: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20     }..          
8320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 65 6c                el
8330: 73 65 20 69 66 20 28 63 61 6e 54 68 72 6f 77 29  se if (canThrow)
8340: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
8350: 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20            {..   
8360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8370: 20 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 6e           throw n
8380: 65 77 20 53 51 4c 69 74 65 45 78 63 65 70 74 69  ew SQLiteExcepti
8390: 6f 6e 28 6e 2c 20 47 65 74 4c 61 73 74 45 72 72  on(n, GetLastErr
83a0: 6f 72 28 68 64 6c 2c 20 64 62 29 29 3b 0d 0a 20  or(hdl, db));.. 
83b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
83c0: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20         }..      
83d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d                }.
83e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
83f0: 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   }..            
8400: 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20  }..        }..  
8410: 20 20 20 20 20 20 47 43 2e 4b 65 65 70 41 6c 69        GC.KeepAli
8420: 76 65 28 68 64 6c 29 3b 0d 0a 20 20 20 20 20 20  ve(hdl);..      
8430: 20 20 72 65 74 75 72 6e 20 72 65 73 75 6c 74 3b    return result;
8440: 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 69  ..    }....    i
8450: 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63 20 62  nternal static b
8460: 6f 6f 6c 20 49 73 41 75 74 6f 63 6f 6d 6d 69 74  ool IsAutocommit
8470: 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f  (SQLiteConnectio
8480: 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74  nHandle hdl, Int
8490: 50 74 72 20 64 62 29 0d 0a 20 20 20 20 7b 0d 0a  Ptr db)..    {..
84a0: 20 20 20 20 20 20 20 20 69 66 20 28 28 68 64 6c          if ((hdl
84b0: 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28 64 62   == null) || (db
84c0: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29   == IntPtr.Zero)
84d0: 29 20 72 65 74 75 72 6e 20 66 61 6c 73 65 3b 0d  ) return false;.
84e0: 0a 0d 0a 20 20 20 20 20 20 20 20 62 6f 6f 6c 20  ...        bool 
84f0: 72 65 73 75 6c 74 20 3d 20 66 61 6c 73 65 3b 0d  result = false;.
8500: 0a 0d 0a 20 20 20 20 20 20 20 20 74 72 79 0d 0a  ...        try..
8510: 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20          {..     
8520: 20 20 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f 74         // do not
8530: 68 69 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 7d  hing...        }
8540: 0d 0a 20 20 20 20 20 20 20 20 66 69 6e 61 6c 6c  ..        finall
8550: 79 20 2f 2a 20 4e 4f 54 45 3a 20 54 68 72 65 61  y /* NOTE: Threa
8560: 64 2e 41 62 6f 72 74 28 29 20 70 72 6f 74 65 63  d.Abort() protec
8570: 74 69 6f 6e 2e 20 2a 2f 0d 0a 20 20 20 20 20 20  tion. */..      
8580: 20 20 7b 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52    {..#if PLATFOR
8590: 4d 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f  M_COMPACTFRAMEWO
85a0: 52 4b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  RK..            
85b0: 6c 6f 63 6b 20 28 68 64 6c 2e 73 79 6e 63 52 6f  lock (hdl.syncRo
85c0: 6f 74 29 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20  ot)..#else..    
85d0: 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64          lock (hd
85e0: 6c 29 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20  l)..#endif..    
85f0: 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20          {..     
8600: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 21             if (!
8610: 68 64 6c 2e 49 73 49 6e 76 61 6c 69 64 20 26 26  hdl.IsInvalid &&
8620: 20 21 68 64 6c 2e 49 73 43 6c 6f 73 65 64 29 0d   !hdl.IsClosed).
8630: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
8640: 20 20 20 20 20 72 65 73 75 6c 74 20 3d 20 28 55       result = (U
8650: 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f  nsafeNativeMetho
8660: 64 73 2e 73 71 6c 69 74 65 33 5f 67 65 74 5f 61  ds.sqlite3_get_a
8670: 75 74 6f 63 6f 6d 6d 69 74 28 64 62 29 20 3d 3d  utocommit(db) ==
8680: 20 31 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20   1);..          
8690: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a    }..        }..
86a0: 20 20 20 20 20 20 20 20 47 43 2e 4b 65 65 70 41          GC.KeepA
86b0: 6c 69 76 65 28 68 64 6c 29 3b 20 2f 2a 20 4e 4f  live(hdl); /* NO
86c0: 54 45 3a 20 55 6e 72 65 61 63 68 61 62 6c 65 20  TE: Unreachable 
86d0: 63 6f 64 65 2e 20 2a 2f 0d 0a 20 20 20 20 20 20  code. */..      
86e0: 20 20 72 65 74 75 72 6e 20 72 65 73 75 6c 74 3b    return result;
86f0: 0d 0a 20 20 20 20 7d 0d 0a 20 20 7d 0d 0a 0d 0a  ..    }..  }....
8700: 20 20 69 6e 74 65 72 6e 61 6c 20 69 6e 74 65 72    internal inter
8710: 66 61 63 65 20 49 53 51 4c 69 74 65 53 63 68 65  face ISQLiteSche
8720: 6d 61 45 78 74 65 6e 73 69 6f 6e 73 0d 0a 20 20  maExtensions..  
8730: 7b 0d 0a 20 20 20 20 76 6f 69 64 20 42 75 69 6c  {..    void Buil
8740: 64 54 65 6d 70 53 63 68 65 6d 61 28 53 51 4c 69  dTempSchema(SQLi
8750: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 20 63 6e 6e  teConnection cnn
8760: 29 3b 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 5b 46 6c  );..  }....  [Fl
8770: 61 67 73 5d 0d 0a 20 20 69 6e 74 65 72 6e 61 6c  ags]..  internal
8780: 20 65 6e 75 6d 20 53 51 4c 69 74 65 4f 70 65 6e   enum SQLiteOpen
8790: 46 6c 61 67 73 45 6e 75 6d 0d 0a 20 20 7b 0d 0a  FlagsEnum..  {..
87a0: 20 20 20 20 4e 6f 6e 65 20 3d 20 30 2c 0d 0a 20      None = 0,.. 
87b0: 20 20 20 52 65 61 64 4f 6e 6c 79 20 3d 20 30 78     ReadOnly = 0x
87c0: 30 31 2c 0d 0a 20 20 20 20 52 65 61 64 57 72 69  01,..    ReadWri
87d0: 74 65 20 3d 20 30 78 30 32 2c 0d 0a 20 20 20 20  te = 0x02,..    
87e0: 43 72 65 61 74 65 20 3d 20 30 78 30 34 2c 0d 0a  Create = 0x04,..
87f0: 20 20 20 20 55 72 69 20 3d 20 30 78 34 30 2c 0d      Uri = 0x40,.
8800: 0a 20 20 20 20 53 68 61 72 65 64 43 61 63 68 65  .    SharedCache
8810: 20 3d 20 30 78 30 31 30 30 30 30 30 30 2c 0d 0a   = 0x01000000,..
8820: 20 20 20 20 44 65 66 61 75 6c 74 20 3d 20 30 78      Default = 0x
8830: 30 36 2c 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 2f 2f  06,..  }....  //
8840: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 2f  / <summary>..  /
8850: 2f 2f 20 54 68 65 20 65 78 74 72 61 20 62 65 68  // The extra beh
8860: 61 76 69 6f 72 61 6c 20 66 6c 61 67 73 20 74 68  avioral flags th
8870: 61 74 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65  at can be applie
8880: 64 20 74 6f 20 61 20 63 6f 6e 6e 65 63 74 69 6f  d to a connectio
8890: 6e 2e 0d 0a 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  n...  /// </summ
88a0: 61 72 79 3e 0d 0a 20 20 5b 46 6c 61 67 73 28 29  ary>..  [Flags()
88b0: 5d 0d 0a 20 20 70 75 62 6c 69 63 20 65 6e 75 6d  ]..  public enum
88c0: 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f   SQLiteConnectio
88d0: 6e 46 6c 61 67 73 0d 0a 20 20 7b 0d 0a 20 20 20  nFlags..  {..   
88e0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
88f0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 20 65  ..      /// No e
8900: 78 74 72 61 20 66 6c 61 67 73 2e 0d 0a 20 20 20  xtra flags...   
8910: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
8920: 3e 0d 0a 20 20 20 20 20 20 4e 6f 6e 65 20 3d 20  >..      None = 
8930: 30 78 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f  0x0,....      //
8940: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
8950: 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c 6f     /// Enable lo
8960: 67 67 69 6e 67 20 6f 66 20 61 6c 6c 20 53 51 4c  gging of all SQL
8970: 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 62   statements to b
8980: 65 20 70 72 65 70 61 72 65 64 2e 0d 0a 20 20 20  e prepared...   
8990: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
89a0: 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 50 72 65 70  >..      LogPrep
89b0: 61 72 65 20 3d 20 30 78 31 2c 0d 0a 0d 0a 20 20  are = 0x1,....  
89c0: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
89d0: 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61  >..      /// Ena
89e0: 62 6c 65 20 6c 6f 67 67 69 6e 67 20 6f 66 20 61  ble logging of a
89f0: 6c 6c 20 62 6f 75 6e 64 20 70 61 72 61 6d 65 74  ll bound paramet
8a00: 65 72 20 74 79 70 65 73 20 61 6e 64 20 72 61 77  er types and raw
8a10: 20 76 61 6c 75 65 73 2e 0d 0a 20 20 20 20 20 20   values...      
8a20: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
8a30: 20 20 20 20 20 20 4c 6f 67 50 72 65 42 69 6e 64        LogPreBind
8a40: 20 3d 20 30 78 32 2c 0d 0a 0d 0a 20 20 20 20 20   = 0x2,....     
8a50: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
8a60: 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65        /// Enable
8a70: 20 6c 6f 67 67 69 6e 67 20 6f 66 20 61 6c 6c 20   logging of all 
8a80: 62 6f 75 6e 64 20 70 61 72 61 6d 65 74 65 72 20  bound parameter 
8a90: 73 74 72 6f 6e 67 6c 79 20 74 79 70 65 64 20 76  strongly typed v
8aa0: 61 6c 75 65 73 2e 0d 0a 20 20 20 20 20 20 2f 2f  alues...      //
8ab0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
8ac0: 20 20 20 20 4c 6f 67 42 69 6e 64 20 3d 20 30 78      LogBind = 0x
8ad0: 34 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  4,....      /// 
8ae0: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
8af0: 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c 6f 67 67   /// Enable logg
8b00: 69 6e 67 20 6f 66 20 61 6c 6c 20 65 78 63 65 70  ing of all excep
8b10: 74 69 6f 6e 73 20 63 61 75 67 68 74 20 66 72 6f  tions caught fro
8b20: 6d 20 75 73 65 72 2d 70 72 6f 76 69 64 65 64 0d  m user-provided.
8b30: 0a 20 20 20 20 20 20 2f 2f 2f 20 6d 61 6e 61 67  .      /// manag
8b40: 65 64 20 63 6f 64 65 20 63 61 6c 6c 65 64 20 66  ed code called f
8b50: 72 6f 6d 20 6e 61 74 69 76 65 20 63 6f 64 65 20  rom native code 
8b60: 76 69 61 20 64 65 6c 65 67 61 74 65 73 2e 0d 0a  via delegates...
8b70: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
8b80: 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 43  ary>..      LogC
8b90: 61 6c 6c 62 61 63 6b 45 78 63 65 70 74 69 6f 6e  allbackException
8ba0: 20 3d 20 30 78 38 2c 0d 0a 0d 0a 20 20 20 20 20   = 0x8,....     
8bb0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
8bc0: 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65        /// Enable
8bd0: 20 6c 6f 67 67 69 6e 67 20 6f 66 20 62 61 63 6b   logging of back
8be0: 75 70 20 41 50 49 20 65 72 72 6f 72 73 2e 0d 0a  up API errors...
8bf0: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
8c00: 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 42  ary>..      LogB
8c10: 61 63 6b 75 70 20 3d 20 30 78 31 30 2c 0d 0a 0d  ackup = 0x10,...
8c20: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  .      /// <summ
8c30: 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ary>..      /// 
8c40: 53 6b 69 70 20 61 64 64 69 6e 67 20 74 68 65 20  Skip adding the 
8c50: 65 78 74 65 6e 73 69 6f 6e 20 66 75 6e 63 74 69  extension functi
8c60: 6f 6e 73 20 70 72 6f 76 69 64 65 64 20 62 79 20  ons provided by 
8c70: 74 68 65 20 6e 61 74 69 76 65 0d 0a 20 20 20 20  the native..    
8c80: 20 20 2f 2f 2f 20 69 6e 74 65 72 6f 70 20 61 73    /// interop as
8c90: 73 65 6d 62 6c 79 2e 0d 0a 20 20 20 20 20 20 2f  sembly...      /
8ca0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
8cb0: 20 20 20 20 20 4e 6f 45 78 74 65 6e 73 69 6f 6e       NoExtension
8cc0: 46 75 6e 63 74 69 6f 6e 73 20 3d 20 30 78 32 30  Functions = 0x20
8cd0: 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  ,....      /// <
8ce0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20  summary>..      
8cf0: 2f 2f 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e 67  /// When binding
8d00: 20 70 61 72 61 6d 65 74 65 72 20 76 61 6c 75 65   parameter value
8d10: 73 20 77 69 74 68 20 74 68 65 20 3c 73 65 65 20  s with the <see 
8d20: 63 72 65 66 3d 22 55 49 6e 74 33 32 22 20 2f 3e  cref="UInt32" />
8d30: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 74 79 70 65  ..      /// type
8d40: 2c 20 75 73 65 20 74 68 65 20 69 6e 74 65 72 6f  , use the intero
8d50: 70 20 6d 65 74 68 6f 64 20 74 68 61 74 20 61 63  p method that ac
8d60: 63 65 70 74 73 20 61 6e 20 3c 73 65 65 20 63 72  cepts an <see cr
8d70: 65 66 3d 22 49 6e 74 36 34 22 20 2f 3e 0d 0a 20  ef="Int64" />.. 
8d80: 20 20 20 20 20 2f 2f 2f 20 76 61 6c 75 65 2e 0d       /// value..
8d90: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  .      /// </sum
8da0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 42 69 6e  mary>..      Bin
8db0: 64 55 49 6e 74 33 32 41 73 49 6e 74 36 34 20 3d  dUInt32AsInt64 =
8dc0: 20 30 78 34 30 2c 0d 0a 0d 0a 20 20 20 20 20 20   0x40,....      
8dd0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
8de0: 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 62 69       /// When bi
8df0: 6e 64 69 6e 67 20 70 61 72 61 6d 65 74 65 72 20  nding parameter 
8e00: 76 61 6c 75 65 73 2c 20 61 6c 77 61 79 73 20 62  values, always b
8e10: 69 6e 64 20 74 68 65 6d 20 61 73 20 74 68 6f 75  ind them as thou
8e20: 67 68 20 74 68 65 79 20 77 65 72 65 0d 0a 20 20  gh they were..  
8e30: 20 20 20 20 2f 2f 2f 20 70 6c 61 69 6e 20 74 65      /// plain te
8e40: 78 74 20 28 69 2e 65 2e 20 6e 6f 20 6e 75 6d 65  xt (i.e. no nume
8e50: 72 69 63 2c 20 64 61 74 65 2f 74 69 6d 65 2c 20  ric, date/time, 
8e60: 6f 72 20 6f 74 68 65 72 20 63 6f 6e 76 65 72 73  or other convers
8e70: 69 6f 6e 73 20 73 68 6f 75 6c 64 0d 0a 20 20 20  ions should..   
8e80: 20 20 20 2f 2f 2f 20 62 65 20 61 74 74 65 6d 70     /// be attemp
8e90: 74 65 64 29 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f  ted)...      ///
8ea0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
8eb0: 20 20 20 42 69 6e 64 41 6c 6c 41 73 54 65 78 74     BindAllAsText
8ec0: 20 3d 20 30 78 38 30 2c 0d 0a 0d 0a 20 20 20 20   = 0x80,....    
8ed0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
8ee0: 0a 20 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20  .      /// When 
8ef0: 72 65 74 75 72 6e 69 6e 67 20 63 6f 6c 75 6d 6e  returning column
8f00: 20 76 61 6c 75 65 73 2c 20 61 6c 77 61 79 73 20   values, always 
8f10: 72 65 74 75 72 6e 20 74 68 65 6d 20 61 73 20 74  return them as t
8f20: 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 65 0d  hough they were.
8f30: 0a 20 20 20 20 20 20 2f 2f 2f 20 70 6c 61 69 6e  .      /// plain
8f40: 20 74 65 78 74 20 28 69 2e 65 2e 20 6e 6f 20 6e   text (i.e. no n
8f50: 75 6d 65 72 69 63 2c 20 64 61 74 65 2f 74 69 6d  umeric, date/tim
8f60: 65 2c 20 6f 72 20 6f 74 68 65 72 20 63 6f 6e 76  e, or other conv
8f70: 65 72 73 69 6f 6e 73 20 73 68 6f 75 6c 64 0d 0a  ersions should..
8f80: 20 20 20 20 20 20 2f 2f 2f 20 62 65 20 61 74 74        /// be att
8f90: 65 6d 70 74 65 64 29 2e 0d 0a 20 20 20 20 20 20  empted)...      
8fa0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
8fb0: 20 20 20 20 20 20 47 65 74 41 6c 6c 41 73 54 65        GetAllAsTe
8fc0: 78 74 20 3d 20 30 78 31 30 30 2c 0d 0a 0d 0a 20  xt = 0x100,.... 
8fd0: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72       /// <summar
8fe0: 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 50 72  y>..      /// Pr
8ff0: 65 76 65 6e 74 20 74 68 69 73 20 3c 73 65 65 20  event this <see 
9000: 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e 6e  cref="SQLiteConn
9010: 65 63 74 69 6f 6e 22 20 2f 3e 20 6f 62 6a 65 63  ection" /> objec
9020: 74 20 69 6e 73 74 61 6e 63 65 20 66 72 6f 6d 0d  t instance from.
9030: 0a 20 20 20 20 20 20 2f 2f 2f 20 6c 6f 61 64 69  .      /// loadi
9040: 6e 67 20 65 78 74 65 6e 73 69 6f 6e 73 2e 0d 0a  ng extensions...
9050: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
9060: 61 72 79 3e 0d 0a 20 20 20 20 20 20 4e 6f 4c 6f  ary>..      NoLo
9070: 61 64 45 78 74 65 6e 73 69 6f 6e 20 3d 20 30 78  adExtension = 0x
9080: 32 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f  200,....      //
9090: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
90a0: 20 20 20 2f 2f 2f 20 50 72 65 76 65 6e 74 20 74     /// Prevent t
90b0: 68 69 73 20 3c 73 65 65 20 63 72 65 66 3d 22 53  his <see cref="S
90c0: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 22  QLiteConnection"
90d0: 20 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61   /> object insta
90e0: 6e 63 65 20 66 72 6f 6d 0d 0a 20 20 20 20 20 20  nce from..      
90f0: 2f 2f 2f 20 63 72 65 61 74 69 6e 67 20 76 69 72  /// creating vir
9100: 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 6c  tual table modul
9110: 65 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  es...      /// <
9120: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
9130: 20 4e 6f 43 72 65 61 74 65 4d 6f 64 75 6c 65 20   NoCreateModule 
9140: 3d 20 30 78 34 30 30 2c 0d 0a 0d 0a 20 20 20 20  = 0x400,....    
9150: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
9160: 0a 20 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20  .      /// When 
9170: 62 69 6e 64 69 6e 67 20 61 6e 64 20 72 65 74 75  binding and retu
9180: 72 6e 69 6e 67 20 63 6f 6c 75 6d 6e 20 76 61 6c  rning column val
9190: 75 65 73 2c 20 61 6c 77 61 79 73 20 74 72 65 61  ues, always trea
91a0: 74 20 74 68 65 6d 20 61 73 20 74 68 6f 75 67 68  t them as though
91b0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 74 68 65 79  ..      /// they
91c0: 20 77 65 72 65 20 70 6c 61 69 6e 20 74 65 78 74   were plain text
91d0: 20 28 69 2e 65 2e 20 6e 6f 20 6e 75 6d 65 72 69   (i.e. no numeri
91e0: 63 2c 20 64 61 74 65 2f 74 69 6d 65 2c 20 6f 72  c, date/time, or
91f0: 20 6f 74 68 65 72 20 63 6f 6e 76 65 72 73 69 6f   other conversio
9200: 6e 73 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 73 68  ns..      /// sh
9210: 6f 75 6c 64 20 62 65 20 61 74 74 65 6d 70 74 65  ould be attempte
9220: 64 29 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  d)...      /// <
9230: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
9240: 20 42 69 6e 64 41 6e 64 47 65 74 41 6c 6c 41 73   BindAndGetAllAs
9250: 54 65 78 74 20 3d 20 42 69 6e 64 41 6c 6c 41 73  Text = BindAllAs
9260: 54 65 78 74 20 7c 20 47 65 74 41 6c 6c 41 73 54  Text | GetAllAsT
9270: 65 78 74 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f  ext,....      //
9280: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
9290: 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 61 6c     /// Enable al
92a0: 6c 20 6c 6f 67 67 69 6e 67 2e 0d 0a 20 20 20 20  l logging...    
92b0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
92c0: 0d 0a 20 20 20 20 20 20 4c 6f 67 41 6c 6c 20 3d  ..      LogAll =
92d0: 20 4c 6f 67 50 72 65 70 61 72 65 20 7c 20 4c 6f   LogPrepare | Lo
92e0: 67 50 72 65 42 69 6e 64 20 7c 20 4c 6f 67 42 69  gPreBind | LogBi
92f0: 6e 64 20 7c 0d 0a 20 20 20 20 20 20 20 20 20 20  nd |..          
9300: 20 20 20 20 20 4c 6f 67 43 61 6c 6c 62 61 63 6b       LogCallback
9310: 45 78 63 65 70 74 69 6f 6e 20 7c 20 4c 6f 67 42  Exception | LogB
9320: 61 63 6b 75 70 2c 0d 0a 0d 0a 20 20 20 20 20 20  ackup,....      
9330: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
9340: 20 20 20 20 20 2f 2f 2f 20 54 68 65 20 64 65 66       /// The def
9350: 61 75 6c 74 20 65 78 74 72 61 20 66 6c 61 67 73  ault extra flags
9360: 20 66 6f 72 20 6e 65 77 20 63 6f 6e 6e 65 63 74   for new connect
9370: 69 6f 6e 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f  ions...      ///
9380: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
9390: 20 20 20 44 65 66 61 75 6c 74 20 3d 20 4c 6f 67     Default = Log
93a0: 43 61 6c 6c 62 61 63 6b 45 78 63 65 70 74 69 6f  CallbackExceptio
93b0: 6e 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 2f 2f 20 54  n..  }....  // T
93c0: 68 65 73 65 20 61 72 65 20 74 68 65 20 6f 70 74  hese are the opt
93d0: 69 6f 6e 73 20 74 6f 20 74 68 65 20 69 6e 74 65  ions to the inte
93e0: 72 6e 61 6c 20 73 71 6c 69 74 65 33 5f 63 6f 6e  rnal sqlite3_con
93f0: 66 69 67 20 63 61 6c 6c 2e 0d 0a 20 20 69 6e 74  fig call...  int
9400: 65 72 6e 61 6c 20 65 6e 75 6d 20 53 51 4c 69 74  ernal enum SQLit
9410: 65 43 6f 6e 66 69 67 4f 70 73 45 6e 75 6d 0d 0a  eConfigOpsEnum..
9420: 20 20 7b 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f    {..    SQLITE_
9430: 43 4f 4e 46 49 47 5f 4e 4f 4e 45 20 3d 20 30 2c  CONFIG_NONE = 0,
9440: 20 2f 2f 20 6e 69 6c 20 0d 0a 20 20 20 20 53 51   // nil ..    SQ
9450: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 49 4e 47  LITE_CONFIG_SING
9460: 4c 45 54 48 52 45 41 44 20 3d 20 31 2c 20 2f 2f  LETHREAD = 1, //
9470: 20 6e 69 6c 20 0d 0a 20 20 20 20 53 51 4c 49 54   nil ..    SQLIT
9480: 45 5f 43 4f 4e 46 49 47 5f 4d 55 4c 54 49 54 48  E_CONFIG_MULTITH
9490: 52 45 41 44 20 3d 20 32 2c 20 2f 2f 20 6e 69 6c  READ = 2, // nil
94a0: 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f   ..    SQLITE_CO
94b0: 4e 46 49 47 5f 53 45 52 49 41 4c 49 5a 45 44 20  NFIG_SERIALIZED 
94c0: 3d 20 33 2c 20 2f 2f 20 6e 69 6c 20 0d 0a 20 20  = 3, // nil ..  
94d0: 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f    SQLITE_CONFIG_
94e0: 4d 41 4c 4c 4f 43 20 3d 20 34 2c 20 2f 2f 20 73  MALLOC = 4, // s
94f0: 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f  qlite3_mem_metho
9500: 64 73 2a 20 0d 0a 20 20 20 20 53 51 4c 49 54 45  ds* ..    SQLITE
9510: 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 41 4c 4c 4f  _CONFIG_GETMALLO
9520: 43 20 3d 20 35 2c 20 2f 2f 20 73 71 6c 69 74 65  C = 5, // sqlite
9530: 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 2a 20 0d  3_mem_methods* .
9540: 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46  .    SQLITE_CONF
9550: 49 47 5f 53 43 52 41 54 43 48 20 3d 20 36 2c 20  IG_SCRATCH = 6, 
9560: 2f 2f 20 76 6f 69 64 2a 2c 20 69 6e 74 20 73 7a  // void*, int sz
9570: 2c 20 69 6e 74 20 4e 20 0d 0a 20 20 20 20 53 51  , int N ..    SQ
9580: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50 41 47 45  LITE_CONFIG_PAGE
9590: 43 41 43 48 45 20 3d 20 37 2c 20 2f 2f 20 76 6f  CACHE = 7, // vo
95a0: 69 64 2a 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74  id*, int sz, int
95b0: 20 4e 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f   N ..    SQLITE_
95c0: 43 4f 4e 46 49 47 5f 48 45 41 50 20 3d 20 38 2c  CONFIG_HEAP = 8,
95d0: 20 2f 2f 20 76 6f 69 64 2a 2c 20 69 6e 74 20 6e   // void*, int n
95e0: 42 79 74 65 2c 20 69 6e 74 20 6d 69 6e 20 0d 0a  Byte, int min ..
95f0: 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49      SQLITE_CONFI
9600: 47 5f 4d 45 4d 53 54 41 54 55 53 20 3d 20 39 2c  G_MEMSTATUS = 9,
9610: 20 2f 2f 20 62 6f 6f 6c 65 61 6e 20 0d 0a 20 20   // boolean ..  
9620: 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f    SQLITE_CONFIG_
9630: 4d 55 54 45 58 20 3d 20 31 30 2c 20 2f 2f 20 73  MUTEX = 10, // s
9640: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74  qlite3_mutex_met
9650: 68 6f 64 73 2a 20 0d 0a 20 20 20 20 53 51 4c 49  hods* ..    SQLI
9660: 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54  TE_CONFIG_GETMUT
9670: 45 58 20 3d 20 31 31 2c 20 2f 2f 20 73 71 6c 69  EX = 11, // sqli
9680: 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64  te3_mutex_method
9690: 73 2a 20 0d 0a 20 20 20 20 2f 2f 20 70 72 65 76  s* ..    // prev
96a0: 69 6f 75 73 6c 79 20 53 51 4c 49 54 45 5f 43 4f  iously SQLITE_CO
96b0: 4e 46 49 47 5f 43 48 55 4e 4b 41 4c 4c 4f 43 20  NFIG_CHUNKALLOC 
96c0: 31 32 20 77 68 69 63 68 20 69 73 20 6e 6f 77 20  12 which is now 
96d0: 75 6e 75 73 65 64 0d 0a 20 20 20 20 53 51 4c 49  unused..    SQLI
96e0: 54 45 5f 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53  TE_CONFIG_LOOKAS
96f0: 49 44 45 20 3d 20 31 33 2c 20 2f 2f 20 69 6e 74  IDE = 13, // int
9700: 20 69 6e 74 20 0d 0a 20 20 20 20 53 51 4c 49 54   int ..    SQLIT
9710: 45 5f 43 4f 4e 46 49 47 5f 50 43 41 43 48 45 20  E_CONFIG_PCACHE 
9720: 3d 20 31 34 2c 20 2f 2f 20 73 71 6c 69 74 65 33  = 14, // sqlite3
9730: 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a  _pcache_methods*
9740: 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f   ..    SQLITE_CO
9750: 4e 46 49 47 5f 47 45 54 50 43 41 43 48 45 20 3d  NFIG_GETPCACHE =
9760: 20 31 35 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f   15, // sqlite3_
9770: 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a 20  pcache_methods* 
9780: 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e  ..    SQLITE_CON
9790: 46 49 47 5f 4c 4f 47 20 3d 20 31 36 2c 20 2f 2f  FIG_LOG = 16, //
97a0: 20 78 46 75 6e 63 2c 20 76 6f 69 64 2a 20 0d 0a   xFunc, void* ..
97b0: 20 20 7d 0d 0a 0d 0a 7d 0d 0a                      }....}..