System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact c249da85bd25cd7f644782376cc56aa428258947:


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 0d 0a 20  soft.com).. *.. 
00b0: 2a 20 52 65 6c 65 61 73 65 64 20 74 6f 20 74 68  * Released to th
00c0: 65 20 70 75 62 6c 69 63 20 64 6f 6d 61 69 6e 2c  e public domain,
00d0: 20 75 73 65 20 61 74 20 79 6f 75 72 20 6f 77 6e   use at your own
00e0: 20 72 69 73 6b 21 0d 0a 20 2a 2a 2a 2a 2a 2a 2a   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 2f 0d 0a 0d 0a 6e 61 6d 65 73 70 61 63 65 20  */....namespace 
0130: 53 79 73 74 65 6d 2e 44 61 74 61 2e 53 51 4c 69  System.Data.SQLi
0140: 74 65 0d 0a 7b 0d 0a 20 20 75 73 69 6e 67 20 53  te..{..  using S
0150: 79 73 74 65 6d 3b 0d 0a 0d 0a 23 69 66 20 21 50  ystem;....#if !P
0160: 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46  LATFORM_COMPACTF
0170: 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 75 73 69 6e  RAMEWORK..  usin
0180: 67 20 53 79 73 74 65 6d 2e 52 75 6e 74 69 6d 65  g System.Runtime
0190: 2e 49 6e 74 65 72 6f 70 53 65 72 76 69 63 65 73  .InteropServices
01a0: 3b 0d 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 20 2f  ;..#endif....  /
01b0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
01c0: 2f 2f 2f 20 54 68 69 73 20 69 6e 74 65 72 6e 61  /// This interna
01d0: 6c 20 63 6c 61 73 73 20 70 72 6f 76 69 64 65 73  l class provides
01e0: 20 74 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e 20   the foundation 
01f0: 6f 66 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72  of SQLite suppor
0200: 74 2e 20 20 49 74 20 64 65 66 69 6e 65 73 20 61  t.  It defines a
0210: 6c 6c 20 74 68 65 20 61 62 73 74 72 61 63 74 20  ll the abstract 
0220: 6d 65 6d 62 65 72 73 20 6e 65 65 64 65 64 20 74  members needed t
0230: 6f 20 69 6d 70 6c 65 6d 65 6e 74 0d 0a 20 20 2f  o implement..  /
0240: 2f 2f 20 61 20 53 51 4c 69 74 65 20 64 61 74 61  // a SQLite data
0250: 20 70 72 6f 76 69 64 65 72 2c 20 61 6e 64 20 69   provider, and i
0260: 6e 68 65 72 69 74 73 20 66 72 6f 6d 20 53 51 4c  nherits from SQL
0270: 69 74 65 43 6f 6e 76 65 72 74 20 77 68 69 63 68  iteConvert which
0280: 20 61 6c 6c 6f 77 73 20 66 6f 72 20 73 69 6d 70   allows for simp
0290: 6c 65 20 74 72 61 6e 73 6c 61 74 69 6f 6e 73 20  le translations 
02a0: 6f 66 20 73 74 72 69 6e 67 20 74 6f 20 61 6e 64  of string to and
02b0: 20 66 72 6f 6d 20 53 51 4c 69 74 65 2e 0d 0a 20   from SQLite... 
02c0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
02d0: 0a 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74  .  internal abst
02e0: 72 61 63 74 20 63 6c 61 73 73 20 53 51 4c 69 74  ract class SQLit
02f0: 65 42 61 73 65 20 3a 20 53 51 4c 69 74 65 43 6f  eBase : SQLiteCo
0300: 6e 76 65 72 74 2c 20 49 44 69 73 70 6f 73 61 62  nvert, IDisposab
0310: 6c 65 0d 0a 20 20 7b 0d 0a 20 20 20 20 23 72 65  le..  {..    #re
0320: 67 69 6f 6e 20 50 72 69 76 61 74 65 20 43 6f 6e  gion Private Con
0330: 73 74 61 6e 74 73 0d 0a 20 20 20 20 2f 2f 2f 20  stants..    /// 
0340: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  <summary>..    /
0350: 2f 2f 20 54 68 65 20 65 72 72 6f 72 20 63 6f 64  // The error cod
0360: 65 20 75 73 65 64 20 66 6f 72 20 6c 6f 67 67 69  e used for loggi
0370: 6e 67 20 65 78 63 65 70 74 69 6f 6e 73 20 63 61  ng exceptions ca
0380: 75 67 68 74 20 69 6e 20 75 73 65 72 2d 70 72 6f  ught in user-pro
0390: 76 69 64 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 63  vided..    /// c
03a0: 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ode...    /// </
03b0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
03c0: 74 65 72 6e 61 6c 20 63 6f 6e 73 74 20 69 6e 74  ternal const int
03d0: 20 43 4f 52 5f 45 5f 45 58 43 45 50 54 49 4f 4e   COR_E_EXCEPTION
03e0: 20 3d 20 75 6e 63 68 65 63 6b 65 64 28 28 69 6e   = unchecked((in
03f0: 74 29 30 78 38 30 31 33 31 35 30 30 29 3b 0d 0a  t)0x80131500);..
0400: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a      #endregion..
0410: 0d 0a 20 20 20 20 2f 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 0d  ///////////////.
0460: 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ...    internal 
0470: 53 51 4c 69 74 65 42 61 73 65 28 53 51 4c 69 74  SQLiteBase(SQLit
0480: 65 44 61 74 65 46 6f 72 6d 61 74 73 20 66 6d 74  eDateFormats fmt
0490: 2c 20 44 61 74 65 54 69 6d 65 4b 69 6e 64 20 6b  , DateTimeKind k
04a0: 69 6e 64 2c 20 73 74 72 69 6e 67 20 66 6d 74 53  ind, string fmtS
04b0: 74 72 69 6e 67 29 0d 0a 20 20 20 20 20 20 3a 20  tring)..      : 
04c0: 62 61 73 65 28 66 6d 74 2c 20 6b 69 6e 64 2c 20  base(fmt, kind, 
04d0: 66 6d 74 53 74 72 69 6e 67 29 20 7b 20 7d 0d 0a  fmtString) { }..
04e0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
04f0: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74  ry>..    /// Ret
0500: 75 72 6e 73 20 61 20 73 74 72 69 6e 67 20 72 65  urns a string re
0510: 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 61  presenting the a
0520: 63 74 69 76 65 20 76 65 72 73 69 6f 6e 20 6f 66  ctive version of
0530: 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 2f 2f 2f   SQLite..    ///
0540: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
0550: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
0560: 63 74 20 73 74 72 69 6e 67 20 56 65 72 73 69 6f  ct string Versio
0570: 6e 20 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20  n { get; }..    
0580: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
0590: 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 61     /// Returns a
05a0: 6e 20 69 6e 74 65 67 65 72 20 72 65 70 72 65 73  n integer repres
05b0: 65 6e 74 69 6e 67 20 74 68 65 20 61 63 74 69 76  enting the activ
05c0: 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 53 51 4c  e version of SQL
05d0: 69 74 65 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ite..    /// </s
05e0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e 74  ummary>..    int
05f0: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69  ernal abstract i
0600: 6e 74 20 56 65 72 73 69 6f 6e 4e 75 6d 62 65 72  nt VersionNumber
0610: 20 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f   { get; }..    /
0620: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
0630: 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68    /// Returns th
0640: 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20 6d  e rowid of the m
0650: 6f 73 74 20 72 65 63 65 6e 74 20 73 75 63 63 65  ost recent succe
0660: 73 73 66 75 6c 20 49 4e 53 45 52 54 20 69 6e 74  ssful INSERT int
0670: 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66  o the database f
0680: 72 6f 6d 20 74 68 69 73 20 63 6f 6e 6e 65 63 74  rom this connect
0690: 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ion...    /// </
06a0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
06b0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
06c0: 6c 6f 6e 67 20 4c 61 73 74 49 6e 73 65 72 74 52  long LastInsertR
06d0: 6f 77 49 64 20 7b 20 67 65 74 3b 20 7d 0d 0a 20  owId { get; }.. 
06e0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
06f0: 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e  ..    /// Return
0700: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
0710: 63 68 61 6e 67 65 73 20 74 68 65 20 6c 61 73 74  changes the last
0720: 20 65 78 65 63 75 74 69 6e 67 20 69 6e 73 65 72   executing inser
0730: 74 2f 75 70 64 61 74 65 20 63 61 75 73 65 64 2e  t/update caused.
0740: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  ..    /// </summ
0750: 61 72 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ary>..    intern
0760: 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20  al abstract int 
0770: 43 68 61 6e 67 65 73 20 7b 20 67 65 74 3b 20 7d  Changes { get; }
0780: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
0790: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74  ry>..    /// Ret
07a0: 75 72 6e 73 20 74 68 65 20 61 6d 6f 75 6e 74 20  urns the amount 
07b0: 6f 66 20 6d 65 6d 6f 72 79 20 28 69 6e 20 62 79  of memory (in by
07c0: 74 65 73 29 20 63 75 72 72 65 6e 74 6c 79 20 69  tes) currently i
07d0: 6e 20 75 73 65 20 62 79 20 74 68 65 20 53 51 4c  n use by the SQL
07e0: 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79  ite core library
07f0: 2e 20 20 54 68 69 73 20 69 73 20 6e 6f 74 20 72  .  This is not r
0800: 65 61 6c 6c 79 20 61 20 70 65 72 2d 63 6f 6e 6e  eally a per-conn
0810: 65 63 74 69 6f 6e 0d 0a 20 20 20 20 2f 2f 2f 20  ection..    /// 
0820: 76 61 6c 75 65 2c 20 69 74 20 69 73 20 67 6c 6f  value, it is glo
0830: 62 61 6c 20 74 6f 20 74 68 65 20 70 72 6f 63 65  bal to the proce
0840: 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ss...    /// </s
0850: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e 74  ummary>..    int
0860: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 6c  ernal abstract l
0870: 6f 6e 67 20 4d 65 6d 6f 72 79 55 73 65 64 20 7b  ong MemoryUsed {
0880: 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f 2f   get; }..    ///
0890: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
08a0: 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65 20  /// Returns the 
08b0: 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f  maximum amount o
08c0: 66 20 6d 65 6d 6f 72 79 20 28 69 6e 20 62 79 74  f memory (in byt
08d0: 65 73 29 20 75 73 65 64 20 62 79 20 74 68 65 20  es) used by the 
08e0: 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 72  SQLite core libr
08f0: 61 72 79 20 73 69 6e 63 65 20 74 68 65 20 68 69  ary since the hi
0900: 67 68 2d 77 61 74 65 72 20 6d 61 72 6b 20 77 61  gh-water mark wa
0910: 73 20 6c 61 73 74 20 72 65 73 65 74 2e 0d 0a 20  s last reset... 
0920: 20 20 20 2f 2f 2f 20 54 68 69 73 20 69 73 20 6e     /// This is n
0930: 6f 74 20 72 65 61 6c 6c 79 20 61 20 70 65 72 2d  ot really a per-
0940: 63 6f 6e 6e 65 63 74 69 6f 6e 20 76 61 6c 75 65  connection value
0950: 2c 20 69 74 20 69 73 20 67 6c 6f 62 61 6c 20 74  , it is global t
0960: 6f 20 74 68 65 20 70 72 6f 63 65 73 73 2e 0d 0a  o the process...
0970: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
0980: 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  y>..    internal
0990: 20 61 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 4d   abstract long M
09a0: 65 6d 6f 72 79 48 69 67 68 77 61 74 65 72 20 7b  emoryHighwater {
09b0: 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f 2f   get; }..    ///
09c0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
09d0: 2f 2f 2f 20 52 65 74 75 72 6e 73 20 6e 6f 6e 2d  /// Returns non-
09e0: 7a 65 72 6f 20 69 66 20 74 68 65 20 75 6e 64 65  zero if the unde
09f0: 72 6c 79 69 6e 67 20 6e 61 74 69 76 65 20 63 6f  rlying native co
0a00: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20  nnection handle 
0a10: 69 73 20 6f 77 6e 65 64 20 62 79 20 74 68 69 73  is owned by this
0a20: 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20   instance...    
0a30: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
0a40: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
0a50: 74 72 61 63 74 20 62 6f 6f 6c 20 4f 77 6e 48 61  tract bool OwnHa
0a60: 6e 64 6c 65 20 7b 20 67 65 74 3b 20 7d 0d 0a 20  ndle { get; }.. 
0a70: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
0a80: 0d 0a 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74  ..    /// Sets t
0a90: 68 65 20 73 74 61 74 75 73 20 6f 66 20 74 68 65  he status of the
0aa0: 20 6d 65 6d 6f 72 79 20 75 73 61 67 65 20 74 72   memory usage tr
0ab0: 61 63 6b 69 6e 67 20 73 75 62 73 79 73 74 65 6d  acking subsystem
0ac0: 20 69 6e 20 74 68 65 20 53 51 4c 69 74 65 20 63   in the SQLite c
0ad0: 6f 72 65 20 6c 69 62 72 61 72 79 2e 20 20 42 79  ore library.  By
0ae0: 20 64 65 66 61 75 6c 74 2c 20 74 68 69 73 20 69   default, this i
0af0: 73 20 65 6e 61 62 6c 65 64 2e 0d 0a 20 20 20 20  s enabled...    
0b00: 2f 2f 2f 20 49 66 20 74 68 69 73 20 69 73 20 64  /// If this is d
0b10: 69 73 61 62 6c 65 64 2c 20 6d 65 6d 6f 72 79 20  isabled, memory 
0b20: 75 73 61 67 65 20 74 72 61 63 6b 69 6e 67 20 77  usage tracking w
0b30: 69 6c 6c 20 6e 6f 74 20 62 65 20 70 65 72 66 6f  ill not be perfo
0b40: 72 6d 65 64 2e 20 20 54 68 69 73 20 69 73 20 6e  rmed.  This is n
0b50: 6f 74 20 72 65 61 6c 6c 79 20 61 20 70 65 72 2d  ot really a per-
0b60: 63 6f 6e 6e 65 63 74 69 6f 6e 20 76 61 6c 75 65  connection value
0b70: 2c 20 69 74 20 69 73 0d 0a 20 20 20 20 2f 2f 2f  , it is..    ///
0b80: 20 67 6c 6f 62 61 6c 20 74 6f 20 74 68 65 20 70   global to the p
0b90: 72 6f 63 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f  rocess...    ///
0ba0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
0bb0: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
0bc0: 3d 22 76 61 6c 75 65 22 3e 4e 6f 6e 2d 7a 65 72  ="value">Non-zer
0bd0: 6f 20 74 6f 20 65 6e 61 62 6c 65 20 6d 65 6d 6f  o to enable memo
0be0: 72 79 20 75 73 61 67 65 20 74 72 61 63 6b 69 6e  ry usage trackin
0bf0: 67 2c 20 7a 65 72 6f 20 6f 74 68 65 72 77 69 73  g, zero otherwis
0c00: 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  e.</param>..    
0c10: 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 41 20 73  /// <returns>A s
0c20: 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72  tandard SQLite r
0c30: 65 74 75 72 6e 20 63 6f 64 65 20 28 69 2e 65 2e  eturn code (i.e.
0c40: 20 7a 65 72 6f 20 66 6f 72 20 73 75 63 63 65 73   zero for succes
0c50: 73 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20 66  s and non-zero f
0c60: 6f 72 20 66 61 69 6c 75 72 65 29 2e 3c 2f 72 65  or failure).</re
0c70: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65  turns>..    inte
0c80: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53 51  rnal abstract SQ
0c90: 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 53 65  LiteErrorCode Se
0ca0: 74 4d 65 6d 6f 72 79 53 74 61 74 75 73 28 62 6f  tMemoryStatus(bo
0cb0: 6f 6c 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20  ol value);..    
0cc0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
0cd0: 20 20 20 2f 2f 2f 20 41 74 74 65 6d 70 74 73 20     /// Attempts 
0ce0: 74 6f 20 66 72 65 65 20 61 73 20 6d 75 63 68 20  to free as much 
0cf0: 68 65 61 70 20 6d 65 6d 6f 72 79 20 61 73 20 70  heap memory as p
0d00: 6f 73 73 69 62 6c 65 20 66 6f 72 20 74 68 65 20  ossible for the 
0d10: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
0d20: 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ion...    /// </
0d30: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
0d40: 2f 20 3c 72 65 74 75 72 6e 73 3e 41 20 73 74 61  / <returns>A sta
0d50: 6e 64 61 72 64 20 53 51 4c 69 74 65 20 72 65 74  ndard SQLite ret
0d60: 75 72 6e 20 63 6f 64 65 20 28 69 2e 65 2e 20 7a  urn code (i.e. z
0d70: 65 72 6f 20 66 6f 72 20 73 75 63 63 65 73 73 20  ero for success 
0d80: 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f 20 66 6f 72  and non-zero for
0d90: 20 66 61 69 6c 75 72 65 29 2e 3c 2f 72 65 74 75   failure).</retu
0da0: 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  rns>..    intern
0db0: 61 6c 20 61 62 73 74 72 61 63 74 20 53 51 4c 69  al abstract SQLi
0dc0: 74 65 45 72 72 6f 72 43 6f 64 65 20 52 65 6c 65  teErrorCode Rele
0dd0: 61 73 65 4d 65 6d 6f 72 79 28 29 3b 0d 0a 20 20  aseMemory();..  
0de0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
0df0: 0a 20 20 20 20 2f 2f 2f 20 53 68 75 74 64 6f 77  .    /// Shutdow
0e00: 6e 20 74 68 65 20 53 51 4c 69 74 65 20 65 6e 67  n the SQLite eng
0e10: 69 6e 65 20 73 6f 20 74 68 61 74 20 69 74 20 63  ine so that it c
0e20: 61 6e 20 62 65 20 72 65 73 74 61 72 74 65 64 20  an be restarted 
0e30: 77 69 74 68 20 64 69 66 66 65 72 65 6e 74 20 63  with different c
0e40: 6f 6e 66 69 67 20 6f 70 74 69 6f 6e 73 2e 0d 0a  onfig options...
0e50: 20 20 20 20 2f 2f 2f 20 57 65 20 64 65 70 65 6e      /// We depen
0e60: 64 20 6f 6e 20 61 75 74 6f 20 69 6e 69 74 69 61  d on auto initia
0e70: 6c 69 7a 61 74 69 6f 6e 20 74 6f 20 72 65 63 6f  lization to reco
0e80: 76 65 72 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ver...    /// </
0e90: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 69 6e  summary>..    in
0ea0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
0eb0: 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20  SQLiteErrorCode 
0ec0: 53 68 75 74 64 6f 77 6e 28 29 3b 0d 0a 20 20 20  Shutdown();..   
0ed0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
0ee0: 20 20 20 20 2f 2f 2f 20 44 65 74 65 72 6d 69 6e      /// Determin
0ef0: 65 73 20 69 66 20 74 68 65 20 61 73 73 6f 63 69  es if the associ
0f00: 61 74 65 64 20 6e 61 74 69 76 65 20 63 6f 6e 6e  ated native conn
0f10: 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 69 73  ection handle is
0f20: 20 6f 70 65 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20   open...    /// 
0f30: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
0f40: 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20  /// <returns>.. 
0f50: 20 20 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20     /// Non-zero 
0f60: 69 66 20 61 20 64 61 74 61 62 61 73 65 20 63 6f  if a database co
0f70: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e  nnection is open
0f80: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74  ...    /// </ret
0f90: 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72  urns>..    inter
0fa0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 62 6f 6f  nal abstract boo
0fb0: 6c 20 49 73 4f 70 65 6e 28 29 3b 0d 0a 20 20 20  l IsOpen();..   
0fc0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
0fd0: 20 20 20 20 2f 2f 2f 20 4f 70 65 6e 73 20 61 20      /// Opens a 
0fe0: 64 61 74 61 62 61 73 65 2e 0d 0a 20 20 20 20 2f  database...    /
0ff0: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
1000: 20 20 20 2f 2f 2f 20 3c 72 65 6d 61 72 6b 73 3e     /// <remarks>
1010: 0d 0a 20 20 20 20 2f 2f 2f 20 49 6d 70 6c 65 6d  ..    /// Implem
1020: 65 6e 74 65 72 73 20 73 68 6f 75 6c 64 20 63 61  enters should ca
1030: 6c 6c 20 53 51 4c 69 74 65 46 75 6e 63 74 69 6f  ll SQLiteFunctio
1040: 6e 2e 42 69 6e 64 46 75 6e 63 74 69 6f 6e 73 28  n.BindFunctions(
1050: 29 20 61 6e 64 20 73 61 76 65 20 74 68 65 20 61  ) and save the a
1060: 72 72 61 79 20 61 66 74 65 72 20 6f 70 65 6e 69  rray after openi
1070: 6e 67 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 0d  ng a connection.
1080: 0a 20 20 20 20 2f 2f 2f 20 74 6f 20 62 69 6e 64  .    /// to bind
1090: 20 61 6c 6c 20 61 74 74 72 69 62 75 74 65 64 20   all attributed 
10a0: 75 73 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e  user-defined fun
10b0: 63 74 69 6f 6e 73 20 61 6e 64 20 63 6f 6c 6c 61  ctions and colla
10c0: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20 74  ting sequences t
10d0: 6f 20 74 68 65 20 6e 65 77 20 63 6f 6e 6e 65 63  o the new connec
10e0: 74 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  tion...    /// <
10f0: 2f 72 65 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 2f  /remarks>..    /
1100: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22  // <param name="
1110: 73 74 72 46 69 6c 65 6e 61 6d 65 22 3e 54 68 65  strFilename">The
1120: 20 66 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65   filename of the
1130: 20 64 61 74 61 62 61 73 65 20 74 6f 20 6f 70 65   database to ope
1140: 6e 2e 20 20 53 51 4c 69 74 65 20 61 75 74 6f 6d  n.  SQLite autom
1150: 61 74 69 63 61 6c 6c 79 20 63 72 65 61 74 65 73  atically creates
1160: 20 69 74 20 69 66 20 69 74 20 64 6f 65 73 6e 27   it if it doesn'
1170: 74 20 65 78 69 73 74 2e 3c 2f 70 61 72 61 6d 3e  t exist.</param>
1180: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
1190: 20 6e 61 6d 65 3d 22 63 6f 6e 6e 65 63 74 69 6f   name="connectio
11a0: 6e 46 6c 61 67 73 22 3e 54 68 65 20 66 6c 61 67  nFlags">The flag
11b0: 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  s associated wit
11c0: 68 20 74 68 65 20 70 61 72 65 6e 74 20 63 6f 6e  h the parent con
11d0: 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74 3c 2f  nection object</
11e0: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
11f0: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 70 65  <param name="ope
1200: 6e 46 6c 61 67 73 22 3e 54 68 65 20 6f 70 65 6e  nFlags">The open
1210: 20 66 6c 61 67 73 20 74 6f 20 75 73 65 20 77 68   flags to use wh
1220: 65 6e 20 63 72 65 61 74 69 6e 67 20 74 68 65 20  en creating the 
1230: 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 70 61 72 61  connection</para
1240: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  m>..    /// <par
1250: 61 6d 20 6e 61 6d 65 3d 22 6d 61 78 50 6f 6f 6c  am name="maxPool
1260: 53 69 7a 65 22 3e 54 68 65 20 6d 61 78 69 6d 75  Size">The maximu
1270: 6d 20 73 69 7a 65 20 6f 66 20 74 68 65 20 70 6f  m size of the po
1280: 6f 6c 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e  ol for the given
1290: 20 66 69 6c 65 6e 61 6d 65 3c 2f 70 61 72 61 6d   filename</param
12a0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61  >..    /// <para
12b0: 6d 20 6e 61 6d 65 3d 22 75 73 65 50 6f 6f 6c 22  m name="usePool"
12c0: 3e 49 66 20 74 72 75 65 2c 20 74 68 65 20 63 6f  >If true, the co
12d0: 6e 6e 65 63 74 69 6f 6e 20 63 61 6e 20 62 65 20  nnection can be 
12e0: 70 75 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20  pulled from the 
12f0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 6f 6c 3c  connection pool<
1300: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 69 6e 74  /param>..    int
1310: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
1320: 6f 69 64 20 4f 70 65 6e 28 73 74 72 69 6e 67 20  oid Open(string 
1330: 73 74 72 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c  strFilename, SQL
1340: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
1350: 67 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  gs connectionFla
1360: 67 73 2c 20 53 51 4c 69 74 65 4f 70 65 6e 46 6c  gs, SQLiteOpenFl
1370: 61 67 73 45 6e 75 6d 20 6f 70 65 6e 46 6c 61 67  agsEnum openFlag
1380: 73 2c 20 69 6e 74 20 6d 61 78 50 6f 6f 6c 53 69  s, int maxPoolSi
1390: 7a 65 2c 20 62 6f 6f 6c 20 75 73 65 50 6f 6f 6c  ze, bool usePool
13a0: 29 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  );..    /// <sum
13b0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43  mary>..    /// C
13c0: 6c 6f 73 65 73 20 74 68 65 20 63 75 72 72 65 6e  loses the curren
13d0: 74 6c 79 2d 6f 70 65 6e 20 64 61 74 61 62 61 73  tly-open databas
13e0: 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  e...    /// </su
13f0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
1400: 3c 72 65 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 2f  <remarks>..    /
1410: 2f 2f 20 41 66 74 65 72 20 74 68 65 20 64 61 74  // After the dat
1420: 61 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 63  abase has been c
1430: 6c 6f 73 65 64 20 69 6d 70 6c 65 6d 65 74 65 72  losed implemeter
1440: 73 20 73 68 6f 75 6c 64 20 63 61 6c 6c 20 53 51  s should call SQ
1450: 4c 69 74 65 46 75 6e 63 74 69 6f 6e 2e 55 6e 62  LiteFunction.Unb
1460: 69 6e 64 46 75 6e 63 74 69 6f 6e 73 28 29 20 74  indFunctions() t
1470: 6f 20 64 65 61 6c 6c 6f 63 61 74 65 20 61 6c 6c  o deallocate all
1480: 20 69 6e 74 65 72 6f 70 20 61 6c 6c 6f 63 61 74   interop allocat
1490: 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f  ed..    /// memo
14a0: 72 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  ry associated wi
14b0: 74 68 20 74 68 65 20 75 73 65 72 2d 64 65 66 69  th the user-defi
14c0: 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e  ned functions an
14d0: 64 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75  d collating sequ
14e0: 65 6e 63 65 73 20 74 69 65 64 20 74 6f 20 74 68  ences tied to th
14f0: 65 20 63 6c 6f 73 65 64 20 63 6f 6e 6e 65 63 74  e closed connect
1500: 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ion...    /// </
1510: 72 65 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 2f 2f  remarks>..    //
1520: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 63  / <param name="c
1530: 61 6e 54 68 72 6f 77 22 3e 4e 6f 6e 2d 7a 65 72  anThrow">Non-zer
1540: 6f 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69  o if the operati
1550: 6f 6e 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f  on is allowed to
1560: 20 74 68 72 6f 77 20 65 78 63 65 70 74 69 6f 6e   throw exception
1570: 73 2c 20 7a 65 72 6f 20 6f 74 68 65 72 77 69 73  s, zero otherwis
1580: 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  e.</param>..    
1590: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
15a0: 74 20 76 6f 69 64 20 43 6c 6f 73 65 28 62 6f 6f  t void Close(boo
15b0: 6c 20 63 61 6e 54 68 72 6f 77 29 3b 0d 0a 20 20  l canThrow);..  
15c0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
15d0: 0a 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68  .    /// Sets th
15e0: 65 20 62 75 73 79 20 74 69 6d 65 6f 75 74 20 6f  e busy timeout o
15f0: 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  n the connection
1600: 2e 20 20 53 51 4c 69 74 65 43 6f 6d 6d 61 6e 64  .  SQLiteCommand
1610: 20 77 69 6c 6c 20 63 61 6c 6c 20 74 68 69 73 20   will call this 
1620: 62 65 66 6f 72 65 20 65 78 65 63 75 74 69 6e 67  before executing
1630: 20 61 6e 79 20 63 6f 6d 6d 61 6e 64 2e 0d 0a 20   any command... 
1640: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
1650: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61  >..    /// <para
1660: 6d 20 6e 61 6d 65 3d 22 6e 54 69 6d 65 6f 75 74  m name="nTimeout
1670: 4d 53 22 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f  MS">The number o
1680: 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 74  f milliseconds t
1690: 6f 20 77 61 69 74 20 62 65 66 6f 72 65 20 72 65  o wait before re
16a0: 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f 42  turning SQLITE_B
16b0: 55 53 59 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  USY</param>..   
16c0: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
16d0: 63 74 20 76 6f 69 64 20 53 65 74 54 69 6d 65 6f  ct void SetTimeo
16e0: 75 74 28 69 6e 74 20 6e 54 69 6d 65 6f 75 74 4d  ut(int nTimeoutM
16f0: 53 29 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  S);..    /// <su
1700: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
1710: 52 65 74 75 72 6e 73 20 74 68 65 20 74 65 78 74  Returns the text
1720: 20 6f 66 20 74 68 65 20 6c 61 73 74 20 65 72 72   of the last err
1730: 6f 72 20 69 73 73 75 65 64 20 62 79 20 53 51 4c  or issued by SQL
1740: 69 74 65 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ite..    /// </s
1750: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
1760: 20 3c 72 65 74 75 72 6e 73 3e 3c 2f 72 65 74 75   <returns></retu
1770: 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  rns>..    intern
1780: 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69  al abstract stri
1790: 6e 67 20 47 65 74 4c 61 73 74 45 72 72 6f 72 28  ng GetLastError(
17a0: 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73  );....    /// <s
17b0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
17c0: 20 52 65 74 75 72 6e 73 20 74 68 65 20 74 65 78   Returns the tex
17d0: 74 20 6f 66 20 74 68 65 20 6c 61 73 74 20 65 72  t of the last er
17e0: 72 6f 72 20 69 73 73 75 65 64 20 62 79 20 53 51  ror issued by SQ
17f0: 4c 69 74 65 20 2d 4f 52 2d 20 74 68 65 20 73 70  Lite -OR- the sp
1800: 65 63 69 66 69 65 64 20 64 65 66 61 75 6c 74 20  ecified default 
1810: 65 72 72 6f 72 20 74 65 78 74 20 69 66 0d 0a 20  error text if.. 
1820: 20 20 20 2f 2f 2f 20 6e 6f 6e 65 20 69 73 20 61     /// none is a
1830: 76 61 69 6c 61 62 6c 65 20 66 72 6f 6d 20 74 68  vailable from th
1840: 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20 6c 69  e SQLite core li
1850: 62 72 61 72 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20  brary...    /// 
1860: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
1870: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
1880: 22 64 65 66 56 61 6c 75 65 22 3e 0d 0a 20 20 20  "defValue">..   
1890: 20 2f 2f 2f 20 54 68 65 20 65 72 72 6f 72 20 74   /// The error t
18a0: 65 78 74 20 74 6f 20 72 65 74 75 72 6e 20 69 6e  ext to return in
18b0: 20 74 68 65 20 65 76 65 6e 74 20 74 68 61 74 20   the event that 
18c0: 6f 6e 65 20 69 73 20 6e 6f 74 20 61 76 61 69 6c  one is not avail
18d0: 61 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 53 51  able from the SQ
18e0: 4c 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72  Lite core librar
18f0: 79 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61  y...    /// </pa
1900: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72  ram>..    /// <r
1910: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 2f 2f 2f  eturns>..    ///
1920: 20 54 68 65 20 65 72 72 6f 72 20 74 65 78 74 2e   The error text.
1930: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75  ..    /// </retu
1940: 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  rns>..    intern
1950: 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69  al abstract stri
1960: 6e 67 20 47 65 74 4c 61 73 74 45 72 72 6f 72 28  ng GetLastError(
1970: 73 74 72 69 6e 67 20 64 65 66 56 61 6c 75 65 29  string defValue)
1980: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
1990: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
19a0: 57 68 65 6e 20 70 6f 6f 6c 69 6e 67 20 69 73 20  When pooling is 
19b0: 65 6e 61 62 6c 65 64 2c 20 66 6f 72 63 65 20 74  enabled, force t
19c0: 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74  his connection t
19d0: 6f 20 62 65 20 64 69 73 70 6f 73 65 64 20 72 61  o be disposed ra
19e0: 74 68 65 72 20 74 68 61 6e 20 72 65 74 75 72 6e  ther than return
19f0: 65 64 20 74 6f 20 74 68 65 20 70 6f 6f 6c 0d 0a  ed to the pool..
1a00: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
1a10: 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  y>..    internal
1a20: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 43   abstract void C
1a30: 6c 65 61 72 50 6f 6f 6c 28 29 3b 0d 0a 0d 0a 20  learPool();.... 
1a40: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
1a50: 0d 0a 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 70  ..    /// When p
1a60: 6f 6f 6c 69 6e 67 20 69 73 20 65 6e 61 62 6c 65  ooling is enable
1a70: 64 2c 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e  d, returns the n
1a80: 75 6d 62 65 72 20 6f 66 20 70 6f 6f 6c 20 65 6e  umber of pool en
1a90: 74 72 69 65 73 20 6d 61 74 63 68 69 6e 67 20 74  tries matching t
1aa0: 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65 20  he current file 
1ab0: 6e 61 6d 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  name...    /// <
1ac0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  /summary>..    /
1ad0: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54 68 65 20  // <returns>The 
1ae0: 6e 75 6d 62 65 72 20 6f 66 20 70 6f 6f 6c 20 65  number of pool e
1af0: 6e 74 72 69 65 73 20 6d 61 74 63 68 69 6e 67 20  ntries matching 
1b00: 74 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65  the current file
1b10: 20 6e 61 6d 65 2e 3c 2f 72 65 74 75 72 6e 73 3e   name.</returns>
1b20: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
1b30: 62 73 74 72 61 63 74 20 69 6e 74 20 43 6f 75 6e  bstract int Coun
1b40: 74 50 6f 6f 6c 28 29 3b 0d 0a 0d 0a 20 20 20 20  tPool();....    
1b50: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
1b60: 20 20 20 2f 2f 2f 20 50 72 65 70 61 72 65 73 20     /// Prepares 
1b70: 61 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  a SQL statement 
1b80: 66 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 0d 0a  for execution...
1b90: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
1ba0: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
1bb0: 61 6d 20 6e 61 6d 65 3d 22 63 6e 6e 22 3e 54 68  am name="cnn">Th
1bc0: 65 20 73 6f 75 72 63 65 20 63 6f 6e 6e 65 63 74  e source connect
1bd0: 69 6f 6e 20 70 72 65 70 61 72 69 6e 67 20 74 68  ion preparing th
1be0: 65 20 63 6f 6d 6d 61 6e 64 2e 20 20 43 61 6e 20  e command.  Can 
1bf0: 62 65 20 6e 75 6c 6c 20 66 6f 72 20 61 6e 79 20  be null for any 
1c00: 63 61 6c 6c 65 72 20 65 78 63 65 70 74 20 4c 49  caller except LI
1c10: 4e 51 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  NQ</param>..    
1c20: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
1c30: 22 73 74 72 53 71 6c 22 3e 54 68 65 20 53 51 4c  "strSql">The SQL
1c40: 20 63 6f 6d 6d 61 6e 64 20 74 65 78 74 20 74 6f   command text to
1c50: 20 70 72 65 70 61 72 65 3c 2f 70 61 72 61 6d 3e   prepare</param>
1c60: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
1c70: 20 6e 61 6d 65 3d 22 70 72 65 76 69 6f 75 73 22   name="previous"
1c80: 3e 54 68 65 20 70 72 65 76 69 6f 75 73 20 73 74  >The previous st
1c90: 61 74 65 6d 65 6e 74 20 69 6e 20 61 20 6d 75 6c  atement in a mul
1ca0: 74 69 2d 73 74 61 74 65 6d 65 6e 74 20 63 6f 6d  ti-statement com
1cb0: 6d 61 6e 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66  mand, or null if
1cc0: 20 6e 6f 20 70 72 65 76 69 6f 75 73 20 73 74 61   no previous sta
1cd0: 74 65 6d 65 6e 74 20 65 78 69 73 74 73 3c 2f 70  tement exists</p
1ce0: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
1cf0: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 69 6d 65  param name="time
1d00: 6f 75 74 4d 53 22 3e 54 68 65 20 74 69 6d 65 6f  outMS">The timeo
1d10: 75 74 20 74 6f 20 77 61 69 74 20 62 65 66 6f 72  ut to wait befor
1d20: 65 20 61 62 6f 72 74 69 6e 67 20 74 68 65 20 70  e aborting the p
1d30: 72 65 70 61 72 65 3c 2f 70 61 72 61 6d 3e 0d 0a  repare</param>..
1d40: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
1d50: 61 6d 65 3d 22 73 74 72 52 65 6d 61 69 6e 22 3e  ame="strRemain">
1d60: 54 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66  The remainder of
1d70: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74   the statement t
1d80: 68 61 74 20 77 61 73 20 6e 6f 74 20 70 72 6f 63  hat was not proc
1d90: 65 73 73 65 64 2e 20 20 45 61 63 68 20 63 61 6c  essed.  Each cal
1da0: 6c 20 74 6f 20 70 72 65 70 61 72 65 20 70 61 72  l to prepare par
1db0: 73 65 73 20 74 68 65 0d 0a 20 20 20 20 2f 2f 2f  ses the..    ///
1dc0: 20 53 51 4c 20 75 70 20 74 6f 20 74 6f 20 65 69   SQL up to to ei
1dd0: 74 68 65 72 20 74 68 65 20 65 6e 64 20 6f 66 20  ther the end of 
1de0: 74 68 65 20 74 65 78 74 20 6f 72 20 74 6f 20 74  the text or to t
1df0: 68 65 20 66 69 72 73 74 20 73 65 6d 69 2d 63 6f  he first semi-co
1e00: 6c 6f 6e 20 64 65 6c 69 6d 69 74 65 72 2e 20 20  lon delimiter.  
1e10: 54 68 65 20 72 65 6d 61 69 6e 69 6e 67 20 74 65  The remaining te
1e20: 78 74 20 69 73 20 72 65 74 75 72 6e 65 64 0d 0a  xt is returned..
1e30: 20 20 20 20 2f 2f 2f 20 68 65 72 65 20 66 6f 72      /// here for
1e40: 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 63 61   a subsequent ca
1e50: 6c 6c 20 74 6f 20 50 72 65 70 61 72 65 28 29 20  ll to Prepare() 
1e60: 75 6e 74 69 6c 20 61 6c 6c 20 74 68 65 20 74 65  until all the te
1e70: 78 74 20 68 61 73 20 62 65 65 6e 20 70 72 6f 63  xt has been proc
1e80: 65 73 73 65 64 2e 3c 2f 70 61 72 61 6d 3e 0d 0a  essed.</param>..
1e90: 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73      /// <returns
1ea0: 3e 52 65 74 75 72 6e 73 20 61 6e 20 69 6e 69 74  >Returns an init
1eb0: 69 61 6c 69 7a 65 64 20 53 51 4c 69 74 65 53 74  ialized SQLiteSt
1ec0: 61 74 65 6d 65 6e 74 2e 3c 2f 72 65 74 75 72 6e  atement.</return
1ed0: 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  s>..    internal
1ee0: 20 61 62 73 74 72 61 63 74 20 53 51 4c 69 74 65   abstract SQLite
1ef0: 53 74 61 74 65 6d 65 6e 74 20 50 72 65 70 61 72  Statement Prepar
1f00: 65 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  e(SQLiteConnecti
1f10: 6f 6e 20 63 6e 6e 2c 20 73 74 72 69 6e 67 20 73  on cnn, string s
1f20: 74 72 53 71 6c 2c 20 53 51 4c 69 74 65 53 74 61  trSql, SQLiteSta
1f30: 74 65 6d 65 6e 74 20 70 72 65 76 69 6f 75 73 2c  tement previous,
1f40: 20 75 69 6e 74 20 74 69 6d 65 6f 75 74 4d 53 2c   uint timeoutMS,
1f50: 20 72 65 66 20 73 74 72 69 6e 67 20 73 74 72 52   ref string strR
1f60: 65 6d 61 69 6e 29 3b 0d 0a 20 20 20 20 2f 2f 2f  emain);..    ///
1f70: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
1f80: 2f 2f 2f 20 53 74 65 70 73 20 74 68 72 6f 75 67  /// Steps throug
1f90: 68 20 61 20 70 72 65 70 61 72 65 64 20 73 74 61  h a prepared sta
1fa0: 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 2f 2f 2f  tement...    ///
1fb0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
1fc0: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
1fd0: 3d 22 73 74 6d 74 22 3e 54 68 65 20 53 51 4c 69  ="stmt">The SQLi
1fe0: 74 65 53 74 61 74 65 6d 65 6e 74 20 74 6f 20 73  teStatement to s
1ff0: 74 65 70 20 74 68 72 6f 75 67 68 3c 2f 70 61 72  tep through</par
2000: 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65  am>..    /// <re
2010: 74 75 72 6e 73 3e 54 72 75 65 20 69 66 20 61 20  turns>True if a 
2020: 72 6f 77 20 77 61 73 20 72 65 74 75 72 6e 65 64  row was returned
2030: 2c 20 46 61 6c 73 65 20 69 66 20 6e 6f 74 2e 3c  , False if not.<
2040: 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69  /returns>..    i
2050: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
2060: 20 62 6f 6f 6c 20 53 74 65 70 28 53 51 4c 69 74   bool Step(SQLit
2070: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 29  eStatement stmt)
2080: 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ;..    /// <summ
2090: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
20a0: 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f 20 69  turns non-zero i
20b0: 66 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20  f the specified 
20c0: 73 74 61 74 65 6d 65 6e 74 20 69 73 20 72 65 61  statement is rea
20d0: 64 2d 6f 6e 6c 79 20 69 6e 20 6e 61 74 75 72 65  d-only in nature
20e0: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  ...    /// </sum
20f0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  mary>..    /// <
2100: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 74 6d 74  param name="stmt
2110: 22 3e 54 68 65 20 73 74 61 74 65 6d 65 6e 74 20  ">The statement 
2120: 74 6f 20 63 68 65 63 6b 2e 3c 2f 70 61 72 61 6d  to check.</param
2130: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75  >..    /// <retu
2140: 72 6e 73 3e 54 72 75 65 20 69 66 20 74 68 65 20  rns>True if the 
2150: 6f 75 74 65 72 20 71 75 65 72 79 20 69 73 20 72  outer query is r
2160: 65 61 64 2d 6f 6e 6c 79 2e 3c 2f 72 65 74 75 72  ead-only.</retur
2170: 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ns>..    interna
2180: 6c 20 61 62 73 74 72 61 63 74 20 62 6f 6f 6c 20  l abstract bool 
2190: 49 73 52 65 61 64 4f 6e 6c 79 28 53 51 4c 69 74  IsReadOnly(SQLit
21a0: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 29  eStatement stmt)
21b0: 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ;..    /// <summ
21c0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
21d0: 73 65 74 73 20 61 20 70 72 65 70 61 72 65 64 20  sets a prepared 
21e0: 73 74 61 74 65 6d 65 6e 74 20 73 6f 20 69 74 20  statement so it 
21f0: 63 61 6e 20 62 65 20 65 78 65 63 75 74 65 64 20  can be executed 
2200: 61 67 61 69 6e 2e 20 20 49 66 20 74 68 65 20 65  again.  If the e
2210: 72 72 6f 72 20 72 65 74 75 72 6e 65 64 20 69 73  rror returned is
2220: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2c 0d   SQLITE_SCHEMA,.
2230: 0a 20 20 20 20 2f 2f 2f 20 74 72 61 6e 73 70 61  .    /// transpa
2240: 72 65 6e 74 6c 79 20 61 74 74 65 6d 70 74 20 74  rently attempt t
2250: 6f 20 72 65 62 75 69 6c 64 20 74 68 65 20 53 51  o rebuild the SQ
2260: 4c 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64 20  L statement and 
2270: 74 68 72 6f 77 20 61 6e 20 65 72 72 6f 72 20 69  throw an error i
2280: 66 20 74 68 61 74 20 77 61 73 20 6e 6f 74 20 70  f that was not p
2290: 6f 73 73 69 62 6c 65 2e 0d 0a 20 20 20 20 2f 2f  ossible...    //
22a0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
22b0: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d    /// <param nam
22c0: 65 3d 22 73 74 6d 74 22 3e 54 68 65 20 73 74 61  e="stmt">The sta
22d0: 74 65 6d 65 6e 74 20 74 6f 20 72 65 73 65 74 3c  tement to reset<
22e0: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f  /param>..    ///
22f0: 20 3c 72 65 74 75 72 6e 73 3e 52 65 74 75 72 6e   <returns>Return
2300: 73 20 2d 31 20 69 66 20 74 68 65 20 73 63 68 65  s -1 if the sche
2310: 6d 61 20 63 68 61 6e 67 65 64 20 77 68 69 6c 65  ma changed while
2320: 20 72 65 73 65 74 74 69 6e 67 2c 20 30 20 69 66   resetting, 0 if
2330: 20 74 68 65 20 72 65 73 65 74 20 77 61 73 20 73   the reset was s
2340: 75 63 65 73 73 66 75 6c 20 6f 72 20 36 20 28 53  ucessful or 6 (S
2350: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 29 20 69 66  QLITE_LOCKED) if
2360: 20 74 68 65 20 72 65 73 65 74 20 66 61 69 6c 65   the reset faile
2370: 64 20 64 75 65 20 74 6f 20 61 20 6c 6f 63 6b 3c  d due to a lock<
2380: 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69  /returns>..    i
2390: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
23a0: 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65   SQLiteErrorCode
23b0: 20 52 65 73 65 74 28 53 51 4c 69 74 65 53 74 61   Reset(SQLiteSta
23c0: 74 65 6d 65 6e 74 20 73 74 6d 74 29 3b 0d 0a 0d  tement stmt);...
23d0: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
23e0: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 41 74 74 65  y>..    /// Atte
23f0: 6d 70 74 73 20 74 6f 20 69 6e 74 65 72 72 75 70  mpts to interrup
2400: 74 20 74 68 65 20 71 75 65 72 79 20 63 75 72 72  t the query curr
2410: 65 6e 74 6c 79 20 65 78 65 63 75 74 69 6e 67 20  ently executing 
2420: 6f 6e 20 74 68 65 20 61 73 73 6f 63 69 61 74 65  on the associate
2430: 64 0d 0a 20 20 20 20 2f 2f 2f 20 6e 61 74 69 76  d..    /// nativ
2440: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
2450: 63 74 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20  ction...    /// 
2460: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
2470: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
2480: 74 20 76 6f 69 64 20 43 61 6e 63 65 6c 28 29 3b  t void Cancel();
2490: 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  ....    /// <sum
24a0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54  mary>..    /// T
24b0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 62 69 6e  his function bin
24c0: 64 73 20 61 20 75 73 65 72 2d 64 65 66 69 6e 65  ds a user-define
24d0: 64 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 20 74  d functions to t
24e0: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0d 0a  he connection...
24f0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
2500: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
2510: 61 6d 20 6e 61 6d 65 3d 22 66 75 6e 63 74 69 6f  am name="functio
2520: 6e 41 74 74 72 69 62 75 74 65 22 3e 0d 0a 20 20  nAttribute">..  
2530: 20 20 2f 2f 2f 20 54 68 65 20 3c 73 65 65 20 63    /// The <see c
2540: 72 65 66 3d 22 53 51 4c 69 74 65 46 75 6e 63 74  ref="SQLiteFunct
2550: 69 6f 6e 41 74 74 72 69 62 75 74 65 22 2f 3e 20  ionAttribute"/> 
2560: 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63 65 20  object instance 
2570: 63 6f 6e 74 61 69 6e 69 6e 67 0d 0a 20 20 20 20  containing..    
2580: 2f 2f 2f 20 74 68 65 20 6d 65 74 61 64 61 74 61  /// the metadata
2590: 20 66 6f 72 20 74 68 65 20 66 75 6e 63 74 69 6f   for the functio
25a0: 6e 20 74 6f 20 62 65 20 62 6f 75 6e 64 2e 0d 0a  n to be bound...
25b0: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e      /// </param>
25c0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
25d0: 20 6e 61 6d 65 3d 22 66 75 6e 63 74 69 6f 6e 22   name="function"
25e0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 3c  >..    /// The <
25f0: 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65  see cref="SQLite
2600: 46 75 6e 63 74 69 6f 6e 22 2f 3e 20 6f 62 6a 65  Function"/> obje
2610: 63 74 20 69 6e 73 74 61 6e 63 65 20 74 68 61 74  ct instance that
2620: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 0d   implements the.
2630: 0a 20 20 20 20 2f 2f 2f 20 66 75 6e 63 74 69 6f  .    /// functio
2640: 6e 20 74 6f 20 62 65 20 62 6f 75 6e 64 2e 0d 0a  n to be bound...
2650: 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e      /// </param>
2660: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
2670: 20 6e 61 6d 65 3d 22 66 6c 61 67 73 22 3e 0d 0a   name="flags">..
2680: 20 20 20 20 2f 2f 2f 20 54 68 65 20 66 6c 61 67      /// The flag
2690: 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  s associated wit
26a0: 68 20 74 68 65 20 70 61 72 65 6e 74 20 63 6f 6e  h the parent con
26b0: 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74 2e 0d  nection object..
26c0: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d  .    /// </param
26d0: 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  >..    internal 
26e0: 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42 69  abstract void Bi
26f0: 6e 64 46 75 6e 63 74 69 6f 6e 28 53 51 4c 69 74  ndFunction(SQLit
2700: 65 46 75 6e 63 74 69 6f 6e 41 74 74 72 69 62 75  eFunctionAttribu
2710: 74 65 20 66 75 6e 63 74 69 6f 6e 41 74 74 72 69  te functionAttri
2720: 62 75 74 65 2c 20 53 51 4c 69 74 65 46 75 6e 63  bute, SQLiteFunc
2730: 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 2c 20 53  tion function, S
2740: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46  QLiteConnectionF
2750: 6c 61 67 73 20 66 6c 61 67 73 29 3b 0d 0a 0d 0a  lags flags);....
2760: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2770: 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f  tract void Bind_
2780: 44 6f 75 62 6c 65 28 53 51 4c 69 74 65 53 74 61  Double(SQLiteSta
2790: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c  tement stmt, SQL
27a0: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
27b0: 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e  gs flags, int in
27c0: 64 65 78 2c 20 64 6f 75 62 6c 65 20 76 61 6c 75  dex, double valu
27d0: 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  e);..    interna
27e0: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
27f0: 42 69 6e 64 5f 49 6e 74 33 32 28 53 51 4c 69 74  Bind_Int32(SQLit
2800: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2810: 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f   SQLiteConnectio
2820: 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e  nFlags flags, in
2830: 74 20 69 6e 64 65 78 2c 20 49 6e 74 33 32 20 76  t index, Int32 v
2840: 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65  alue);..    inte
2850: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
2860: 69 64 20 42 69 6e 64 5f 55 49 6e 74 33 32 28 53  id Bind_UInt32(S
2870: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2880: 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65  tmt, SQLiteConne
2890: 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73  ctionFlags flags
28a0: 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20 55 49 6e  , int index, UIn
28b0: 74 33 32 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20  t32 value);..   
28c0: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
28d0: 63 74 20 76 6f 69 64 20 42 69 6e 64 5f 49 6e 74  ct void Bind_Int
28e0: 36 34 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  64(SQLiteStateme
28f0: 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43  nt stmt, SQLiteC
2900: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66  onnectionFlags f
2910: 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 2c  lags, int index,
2920: 20 49 6e 74 36 34 20 76 61 6c 75 65 29 3b 0d 0a   Int64 value);..
2930: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2940: 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f  tract void Bind_
2950: 55 49 6e 74 36 34 28 53 51 4c 69 74 65 53 74 61  UInt64(SQLiteSta
2960: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c  tement stmt, SQL
2970: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
2980: 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e  gs flags, int in
2990: 64 65 78 2c 20 55 49 6e 74 36 34 20 76 61 6c 75  dex, UInt64 valu
29a0: 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  e);..    interna
29b0: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
29c0: 42 69 6e 64 5f 54 65 78 74 28 53 51 4c 69 74 65  Bind_Text(SQLite
29d0: 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20  Statement stmt, 
29e0: 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e  SQLiteConnection
29f0: 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e 74  Flags flags, int
2a00: 20 69 6e 64 65 78 2c 20 73 74 72 69 6e 67 20 76   index, string v
2a10: 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65  alue);..    inte
2a20: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
2a30: 69 64 20 42 69 6e 64 5f 42 6c 6f 62 28 53 51 4c  id Bind_Blob(SQL
2a40: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
2a50: 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  t, SQLiteConnect
2a60: 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20  ionFlags flags, 
2a70: 69 6e 74 20 69 6e 64 65 78 2c 20 62 79 74 65 5b  int index, byte[
2a80: 5d 20 62 6c 6f 62 44 61 74 61 29 3b 0d 0a 20 20  ] blobData);..  
2a90: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2aa0: 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f 44 61  act void Bind_Da
2ab0: 74 65 54 69 6d 65 28 53 51 4c 69 74 65 53 74 61  teTime(SQLiteSta
2ac0: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c  tement stmt, SQL
2ad0: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
2ae0: 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e  gs flags, int in
2af0: 64 65 78 2c 20 44 61 74 65 54 69 6d 65 20 64 74  dex, DateTime dt
2b00: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2b10: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42   abstract void B
2b20: 69 6e 64 5f 4e 75 6c 6c 28 53 51 4c 69 74 65 53  ind_Null(SQLiteS
2b30: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53  tatement stmt, S
2b40: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46  QLiteConnectionF
2b50: 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20  lags flags, int 
2b60: 69 6e 64 65 78 29 3b 0d 0a 0d 0a 20 20 20 20 69  index);....    i
2b70: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
2b80: 20 69 6e 74 20 42 69 6e 64 5f 50 61 72 61 6d 43   int Bind_ParamC
2b90: 6f 75 6e 74 28 53 51 4c 69 74 65 53 74 61 74 65  ount(SQLiteState
2ba0: 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74  ment stmt, SQLit
2bb0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
2bc0: 20 66 6c 61 67 73 29 3b 0d 0a 20 20 20 20 69 6e   flags);..    in
2bd0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2be0: 73 74 72 69 6e 67 20 42 69 6e 64 5f 50 61 72 61  string Bind_Para
2bf0: 6d 4e 61 6d 65 28 53 51 4c 69 74 65 53 74 61 74  mName(SQLiteStat
2c00: 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69  ement stmt, SQLi
2c10: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  teConnectionFlag
2c20: 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64  s flags, int ind
2c30: 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ex);..    intern
2c40: 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20  al abstract int 
2c50: 42 69 6e 64 5f 50 61 72 61 6d 49 6e 64 65 78 28  Bind_ParamIndex(
2c60: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
2c70: 73 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e  stmt, SQLiteConn
2c80: 65 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67  ectionFlags flag
2c90: 73 2c 20 73 74 72 69 6e 67 20 70 61 72 61 6d 4e  s, string paramN
2ca0: 61 6d 65 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74  ame);....    int
2cb0: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69  ernal abstract i
2cc0: 6e 74 20 43 6f 6c 75 6d 6e 43 6f 75 6e 74 28 53  nt ColumnCount(S
2cd0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2ce0: 74 6d 74 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  tmt);..    inter
2cf0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72  nal abstract str
2d00: 69 6e 67 20 43 6f 6c 75 6d 6e 4e 61 6d 65 28 53  ing ColumnName(S
2d10: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2d20: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
2d30: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2d40: 62 73 74 72 61 63 74 20 54 79 70 65 41 66 66 69  bstract TypeAffi
2d50: 6e 69 74 79 20 43 6f 6c 75 6d 6e 41 66 66 69 6e  nity ColumnAffin
2d60: 69 74 79 28 53 51 4c 69 74 65 53 74 61 74 65 6d  ity(SQLiteStatem
2d70: 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e  ent stmt, int in
2d80: 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  dex);..    inter
2d90: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72  nal abstract str
2da0: 69 6e 67 20 43 6f 6c 75 6d 6e 54 79 70 65 28 53  ing ColumnType(S
2db0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2dc0: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20  tmt, int index, 
2dd0: 72 65 66 20 54 79 70 65 41 66 66 69 6e 69 74 79  ref TypeAffinity
2de0: 20 6e 41 66 66 69 6e 69 74 79 29 3b 0d 0a 20 20   nAffinity);..  
2df0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2e00: 61 63 74 20 69 6e 74 20 43 6f 6c 75 6d 6e 49 6e  act int ColumnIn
2e10: 64 65 78 28 53 51 4c 69 74 65 53 74 61 74 65 6d  dex(SQLiteStatem
2e20: 65 6e 74 20 73 74 6d 74 2c 20 73 74 72 69 6e 67  ent stmt, string
2e30: 20 63 6f 6c 75 6d 6e 4e 61 6d 65 29 3b 0d 0a 20   columnName);.. 
2e40: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2e50: 72 61 63 74 20 73 74 72 69 6e 67 20 43 6f 6c 75  ract string Colu
2e60: 6d 6e 4f 72 69 67 69 6e 61 6c 4e 61 6d 65 28 53  mnOriginalName(S
2e70: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2e80: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
2e90: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2ea0: 62 73 74 72 61 63 74 20 73 74 72 69 6e 67 20 43  bstract string C
2eb0: 6f 6c 75 6d 6e 44 61 74 61 62 61 73 65 4e 61 6d  olumnDatabaseNam
2ec0: 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  e(SQLiteStatemen
2ed0: 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65  t stmt, int inde
2ee0: 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  x);..    interna
2ef0: 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e  l abstract strin
2f00: 67 20 43 6f 6c 75 6d 6e 54 61 62 6c 65 4e 61 6d  g ColumnTableNam
2f10: 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  e(SQLiteStatemen
2f20: 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65  t stmt, int inde
2f30: 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  x);..    interna
2f40: 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20  l abstract void 
2f50: 43 6f 6c 75 6d 6e 4d 65 74 61 44 61 74 61 28 73  ColumnMetaData(s
2f60: 74 72 69 6e 67 20 64 61 74 61 42 61 73 65 2c 20  tring dataBase, 
2f70: 73 74 72 69 6e 67 20 74 61 62 6c 65 2c 20 73 74  string table, st
2f80: 72 69 6e 67 20 63 6f 6c 75 6d 6e 2c 20 72 65 66  ring column, ref
2f90: 20 73 74 72 69 6e 67 20 64 61 74 61 54 79 70 65   string dataType
2fa0: 2c 20 72 65 66 20 73 74 72 69 6e 67 20 63 6f 6c  , ref string col
2fb0: 6c 61 74 65 53 65 71 75 65 6e 63 65 2c 20 72 65  lateSequence, re
2fc0: 66 20 62 6f 6f 6c 20 6e 6f 74 4e 75 6c 6c 2c 20  f bool notNull, 
2fd0: 72 65 66 20 62 6f 6f 6c 20 70 72 69 6d 61 72 79  ref bool primary
2fe0: 4b 65 79 2c 20 72 65 66 20 62 6f 6f 6c 20 61 75  Key, ref bool au
2ff0: 74 6f 49 6e 63 72 65 6d 65 6e 74 29 3b 0d 0a 20  toIncrement);.. 
3000: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
3010: 72 61 63 74 20 76 6f 69 64 20 47 65 74 49 6e 64  ract void GetInd
3020: 65 78 43 6f 6c 75 6d 6e 45 78 74 65 6e 64 65 64  exColumnExtended
3030: 49 6e 66 6f 28 73 74 72 69 6e 67 20 64 61 74 61  Info(string data
3040: 62 61 73 65 2c 20 73 74 72 69 6e 67 20 69 6e 64  base, string ind
3050: 65 78 2c 20 73 74 72 69 6e 67 20 63 6f 6c 75 6d  ex, string colum
3060: 6e 2c 20 72 65 66 20 69 6e 74 20 73 6f 72 74 4d  n, ref int sortM
3070: 6f 64 65 2c 20 72 65 66 20 69 6e 74 20 6f 6e 45  ode, ref int onE
3080: 72 72 6f 72 2c 20 72 65 66 20 73 74 72 69 6e 67  rror, ref string
3090: 20 63 6f 6c 6c 61 74 69 6f 6e 53 65 71 75 65 6e   collationSequen
30a0: 63 65 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65  ce);....    inte
30b0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 64 6f  rnal abstract do
30c0: 75 62 6c 65 20 47 65 74 44 6f 75 62 6c 65 28 53  uble GetDouble(S
30d0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
30e0: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
30f0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
3100: 62 73 74 72 61 63 74 20 53 42 79 74 65 20 47 65  bstract SByte Ge
3110: 74 53 42 79 74 65 28 53 51 4c 69 74 65 53 74 61  tSByte(SQLiteSta
3120: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74  tement stmt, int
3130: 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e   index);..    in
3140: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3150: 42 79 74 65 20 47 65 74 42 79 74 65 28 53 51 4c  Byte GetByte(SQL
3160: 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d  iteStatement stm
3170: 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a  t, int index);..
3180: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
3190: 74 72 61 63 74 20 49 6e 74 31 36 20 47 65 74 49  tract Int16 GetI
31a0: 6e 74 31 36 28 53 51 4c 69 74 65 53 74 61 74 65  nt16(SQLiteState
31b0: 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69  ment stmt, int i
31c0: 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65  ndex);..    inte
31d0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 55 49  rnal abstract UI
31e0: 6e 74 31 36 20 47 65 74 55 49 6e 74 31 36 28 53  nt16 GetUInt16(S
31f0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
3200: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
3210: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
3220: 62 73 74 72 61 63 74 20 49 6e 74 33 32 20 47 65  bstract Int32 Ge
3230: 74 49 6e 74 33 32 28 53 51 4c 69 74 65 53 74 61  tInt32(SQLiteSta
3240: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74  tement stmt, int
3250: 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e   index);..    in
3260: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3270: 55 49 6e 74 33 32 20 47 65 74 55 49 6e 74 33 32  UInt32 GetUInt32
3280: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
3290: 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78   stmt, int index
32a0: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
32b0: 20 61 62 73 74 72 61 63 74 20 49 6e 74 36 34 20   abstract Int64 
32c0: 47 65 74 49 6e 74 36 34 28 53 51 4c 69 74 65 53  GetInt64(SQLiteS
32d0: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69  tatement stmt, i
32e0: 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20  nt index);..    
32f0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
3300: 74 20 55 49 6e 74 36 34 20 47 65 74 55 49 6e 74  t UInt64 GetUInt
3310: 36 34 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  64(SQLiteStateme
3320: 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64  nt stmt, int ind
3330: 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ex);..    intern
3340: 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69  al abstract stri
3350: 6e 67 20 47 65 74 54 65 78 74 28 53 51 4c 69 74  ng GetText(SQLit
3360: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
3370: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
3380: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
3390: 61 63 74 20 6c 6f 6e 67 20 47 65 74 42 79 74 65  act long GetByte
33a0: 73 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  s(SQLiteStatemen
33b0: 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65  t stmt, int inde
33c0: 78 2c 20 69 6e 74 20 6e 44 61 74 61 6f 66 66 73  x, int nDataoffs
33d0: 65 74 2c 20 62 79 74 65 5b 5d 20 62 44 65 73 74  et, byte[] bDest
33e0: 2c 20 69 6e 74 20 6e 53 74 61 72 74 2c 20 69 6e  , int nStart, in
33f0: 74 20 6e 4c 65 6e 67 74 68 29 3b 0d 0a 20 20 20  t nLength);..   
3400: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
3410: 63 74 20 6c 6f 6e 67 20 47 65 74 43 68 61 72 73  ct long GetChars
3420: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
3430: 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78   stmt, int index
3440: 2c 20 69 6e 74 20 6e 44 61 74 61 6f 66 66 73 65  , int nDataoffse
3450: 74 2c 20 63 68 61 72 5b 5d 20 62 44 65 73 74 2c  t, char[] bDest,
3460: 20 69 6e 74 20 6e 53 74 61 72 74 2c 20 69 6e 74   int nStart, int
3470: 20 6e 4c 65 6e 67 74 68 29 3b 0d 0a 20 20 20 20   nLength);..    
3480: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
3490: 74 20 44 61 74 65 54 69 6d 65 20 47 65 74 44 61  t DateTime GetDa
34a0: 74 65 54 69 6d 65 28 53 51 4c 69 74 65 53 74 61  teTime(SQLiteSta
34b0: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74  tement stmt, int
34c0: 20 69 6e 64 65 78 29 3b 0d 0a 20 20 20 20 69 6e   index);..    in
34d0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
34e0: 62 6f 6f 6c 20 49 73 4e 75 6c 6c 28 53 51 4c 69  bool IsNull(SQLi
34f0: 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74  teStatement stmt
3500: 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 0d  , int index);...
3510: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
3520: 73 74 72 61 63 74 20 76 6f 69 64 20 43 72 65 61  stract void Crea
3530: 74 65 43 6f 6c 6c 61 74 69 6f 6e 28 73 74 72 69  teCollation(stri
3540: 6e 67 20 73 74 72 43 6f 6c 6c 61 74 69 6f 6e 2c  ng strCollation,
3550: 20 53 51 4c 69 74 65 43 6f 6c 6c 61 74 69 6f 6e   SQLiteCollation
3560: 20 66 75 6e 63 2c 20 53 51 4c 69 74 65 43 6f 6c   func, SQLiteCol
3570: 6c 61 74 69 6f 6e 20 66 75 6e 63 31 36 29 3b 0d  lation func16);.
3580: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
3590: 73 74 72 61 63 74 20 76 6f 69 64 20 43 72 65 61  stract void Crea
35a0: 74 65 46 75 6e 63 74 69 6f 6e 28 73 74 72 69 6e  teFunction(strin
35b0: 67 20 73 74 72 46 75 6e 63 74 69 6f 6e 2c 20 69  g strFunction, i
35c0: 6e 74 20 6e 41 72 67 73 2c 20 62 6f 6f 6c 20 6e  nt nArgs, bool n
35d0: 65 65 64 43 6f 6c 6c 53 65 71 2c 20 53 51 4c 69  eedCollSeq, SQLi
35e0: 74 65 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 2c  teCallback func,
35f0: 20 53 51 4c 69 74 65 43 61 6c 6c 62 61 63 6b 20   SQLiteCallback 
3600: 66 75 6e 63 73 74 65 70 2c 20 53 51 4c 69 74 65  funcstep, SQLite
3610: 46 69 6e 61 6c 43 61 6c 6c 62 61 63 6b 20 66 75  FinalCallback fu
3620: 6e 63 66 69 6e 61 6c 29 3b 0d 0a 20 20 20 20 69  ncfinal);..    i
3630: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
3640: 20 43 6f 6c 6c 61 74 69 6f 6e 53 65 71 75 65 6e   CollationSequen
3650: 63 65 20 47 65 74 43 6f 6c 6c 61 74 69 6f 6e 53  ce GetCollationS
3660: 65 71 75 65 6e 63 65 28 53 51 4c 69 74 65 46 75  equence(SQLiteFu
3670: 6e 63 74 69 6f 6e 20 66 75 6e 63 2c 20 49 6e 74  nction func, Int
3680: 50 74 72 20 63 6f 6e 74 65 78 74 29 3b 0d 0a 20  Ptr context);.. 
3690: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
36a0: 72 61 63 74 20 69 6e 74 20 43 6f 6e 74 65 78 74  ract int Context
36b0: 43 6f 6c 6c 61 74 65 43 6f 6d 70 61 72 65 28 43  CollateCompare(C
36c0: 6f 6c 6c 61 74 69 6f 6e 45 6e 63 6f 64 69 6e 67  ollationEncoding
36d0: 45 6e 75 6d 20 65 6e 63 2c 20 49 6e 74 50 74 72  Enum enc, IntPtr
36e0: 20 63 6f 6e 74 65 78 74 2c 20 73 74 72 69 6e 67   context, string
36f0: 20 73 31 2c 20 73 74 72 69 6e 67 20 73 32 29 3b   s1, string s2);
3700: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
3710: 62 73 74 72 61 63 74 20 69 6e 74 20 43 6f 6e 74  bstract int Cont
3720: 65 78 74 43 6f 6c 6c 61 74 65 43 6f 6d 70 61 72  extCollateCompar
3730: 65 28 43 6f 6c 6c 61 74 69 6f 6e 45 6e 63 6f 64  e(CollationEncod
3740: 69 6e 67 45 6e 75 6d 20 65 6e 63 2c 20 49 6e 74  ingEnum enc, Int
3750: 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 63 68 61  Ptr context, cha
3760: 72 5b 5d 20 63 31 2c 20 63 68 61 72 5b 5d 20 63  r[] c1, char[] c
3770: 32 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72  2);....    inter
3780: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
3790: 20 41 67 67 72 65 67 61 74 65 43 6f 75 6e 74 28   AggregateCount(
37a0: 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 29 3b  IntPtr context);
37b0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
37c0: 62 73 74 72 61 63 74 20 49 6e 74 50 74 72 20 41  bstract IntPtr A
37d0: 67 67 72 65 67 61 74 65 43 6f 6e 74 65 78 74 28  ggregateContext(
37e0: 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 29 3b  IntPtr context);
37f0: 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  ....    internal
3800: 20 61 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 47   abstract long G
3810: 65 74 50 61 72 61 6d 56 61 6c 75 65 42 79 74 65  etParamValueByte
3820: 73 28 49 6e 74 50 74 72 20 70 74 72 2c 20 69 6e  s(IntPtr ptr, in
3830: 74 20 6e 44 61 74 61 4f 66 66 73 65 74 2c 20 62  t nDataOffset, b
3840: 79 74 65 5b 5d 20 62 44 65 73 74 2c 20 69 6e 74  yte[] bDest, int
3850: 20 6e 53 74 61 72 74 2c 20 69 6e 74 20 6e 4c 65   nStart, int nLe
3860: 6e 67 74 68 29 3b 0d 0a 20 20 20 20 69 6e 74 65  ngth);..    inte
3870: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 64 6f  rnal abstract do
3880: 75 62 6c 65 20 47 65 74 50 61 72 61 6d 56 61 6c  uble GetParamVal
3890: 75 65 44 6f 75 62 6c 65 28 49 6e 74 50 74 72 20  ueDouble(IntPtr 
38a0: 70 74 72 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  ptr);..    inter
38b0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
38c0: 20 47 65 74 50 61 72 61 6d 56 61 6c 75 65 49 6e   GetParamValueIn
38d0: 74 33 32 28 49 6e 74 50 74 72 20 70 74 72 29 3b  t32(IntPtr ptr);
38e0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
38f0: 62 73 74 72 61 63 74 20 49 6e 74 36 34 20 47 65  bstract Int64 Ge
3900: 74 50 61 72 61 6d 56 61 6c 75 65 49 6e 74 36 34  tParamValueInt64
3910: 28 49 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a 20  (IntPtr ptr);.. 
3920: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
3930: 72 61 63 74 20 73 74 72 69 6e 67 20 47 65 74 50  ract string GetP
3940: 61 72 61 6d 56 61 6c 75 65 54 65 78 74 28 49 6e  aramValueText(In
3950: 74 50 74 72 20 70 74 72 29 3b 0d 0a 20 20 20 20  tPtr ptr);..    
3960: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
3970: 74 20 54 79 70 65 41 66 66 69 6e 69 74 79 20 47  t TypeAffinity G
3980: 65 74 50 61 72 61 6d 56 61 6c 75 65 54 79 70 65  etParamValueType
3990: 28 49 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a 0d  (IntPtr ptr);...
39a0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
39b0: 73 74 72 61 63 74 20 76 6f 69 64 20 52 65 74 75  stract void Retu
39c0: 72 6e 42 6c 6f 62 28 49 6e 74 50 74 72 20 63 6f  rnBlob(IntPtr co
39d0: 6e 74 65 78 74 2c 20 62 79 74 65 5b 5d 20 76 61  ntext, byte[] va
39e0: 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  lue);..    inter
39f0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69  nal abstract voi
3a00: 64 20 52 65 74 75 72 6e 44 6f 75 62 6c 65 28 49  d ReturnDouble(I
3a10: 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 64  ntPtr context, d
3a20: 6f 75 62 6c 65 20 76 61 6c 75 65 29 3b 0d 0a 20  ouble value);.. 
3a30: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
3a40: 72 61 63 74 20 76 6f 69 64 20 52 65 74 75 72 6e  ract void Return
3a50: 45 72 72 6f 72 28 49 6e 74 50 74 72 20 63 6f 6e  Error(IntPtr con
3a60: 74 65 78 74 2c 20 73 74 72 69 6e 67 20 76 61 6c  text, string val
3a70: 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ue);..    intern
3a80: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
3a90: 20 52 65 74 75 72 6e 49 6e 74 33 32 28 49 6e 74   ReturnInt32(Int
3aa0: 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 49 6e 74  Ptr context, Int
3ab0: 33 32 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20  32 value);..    
3ac0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
3ad0: 74 20 76 6f 69 64 20 52 65 74 75 72 6e 49 6e 74  t void ReturnInt
3ae0: 36 34 28 49 6e 74 50 74 72 20 63 6f 6e 74 65 78  64(IntPtr contex
3af0: 74 2c 20 49 6e 74 36 34 20 76 61 6c 75 65 29 3b  t, Int64 value);
3b00: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
3b10: 62 73 74 72 61 63 74 20 76 6f 69 64 20 52 65 74  bstract void Ret
3b20: 75 72 6e 4e 75 6c 6c 28 49 6e 74 50 74 72 20 63  urnNull(IntPtr c
3b30: 6f 6e 74 65 78 74 29 3b 0d 0a 20 20 20 20 69 6e  ontext);..    in
3b40: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3b50: 76 6f 69 64 20 52 65 74 75 72 6e 54 65 78 74 28  void ReturnText(
3b60: 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 2c 20  IntPtr context, 
3b70: 73 74 72 69 6e 67 20 76 61 6c 75 65 29 3b 0d 0a  string value);..
3b80: 0d 0a 23 69 66 20 49 4e 54 45 52 4f 50 5f 56 49  ..#if INTEROP_VI
3b90: 52 54 55 41 4c 5f 54 41 42 4c 45 0d 0a 20 20 20  RTUAL_TABLE..   
3ba0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
3bb0: 20 20 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 74 68      /// Calls th
3bc0: 65 20 6e 61 74 69 76 65 20 53 51 4c 69 74 65 20  e native SQLite 
3bd0: 63 6f 72 65 20 6c 69 62 72 61 72 79 20 69 6e 20  core library in 
3be0: 6f 72 64 65 72 20 74 6f 20 63 72 65 61 74 65 20  order to create 
3bf0: 61 20 64 69 73 70 6f 73 61 62 6c 65 0d 0a 20 20  a disposable..  
3c00: 20 20 2f 2f 2f 20 6d 6f 64 75 6c 65 20 63 6f 6e    /// module con
3c10: 74 61 69 6e 69 6e 67 20 74 68 65 20 69 6d 70 6c  taining the impl
3c20: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 61 20  ementation of a 
3c30: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0d 0a  virtual table...
3c40: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
3c50: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
3c60: 61 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22  am name="module"
3c70: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6d  >..    /// The m
3c80: 6f 64 75 6c 65 20 6f 62 6a 65 63 74 20 74 6f 20  odule object to 
3c90: 62 65 20 75 73 65 64 20 77 68 65 6e 20 63 72 65  be used when cre
3ca0: 61 74 69 6e 67 20 74 68 65 20 6e 61 74 69 76 65  ating the native
3cb0: 20 64 69 73 70 6f 73 61 62 6c 65 20 6d 6f 64 75   disposable modu
3cc0: 6c 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70  le...    /// </p
3cd0: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
3ce0: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 66 6c 61 67  param name="flag
3cf0: 73 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65  s">..    /// The
3d00: 20 66 6c 61 67 73 20 66 6f 72 20 74 68 65 20 61   flags for the a
3d10: 73 73 6f 63 69 61 74 65 64 20 3c 73 65 65 20 63  ssociated <see c
3d20: 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e 6e 65  ref="SQLiteConne
3d30: 63 74 69 6f 6e 22 20 2f 3e 20 6f 62 6a 65 63 74  ction" /> object
3d40: 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20 20 20   instance...    
3d50: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  /// </param>..  
3d60: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
3d70: 61 63 74 20 76 6f 69 64 20 43 72 65 61 74 65 4d  act void CreateM
3d80: 6f 64 75 6c 65 28 53 51 4c 69 74 65 4d 6f 64 75  odule(SQLiteModu
3d90: 6c 65 20 6d 6f 64 75 6c 65 2c 20 53 51 4c 69 74  le module, SQLit
3da0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
3db0: 20 66 6c 61 67 73 29 3b 0d 0a 0d 0a 20 20 20 20   flags);....    
3dc0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
3dd0: 20 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 74 68 65     /// Calls the
3de0: 20 6e 61 74 69 76 65 20 53 51 4c 69 74 65 20 63   native SQLite c
3df0: 6f 72 65 20 6c 69 62 72 61 72 79 20 69 6e 20 6f  ore library in o
3e00: 72 64 65 72 20 74 6f 20 63 6c 65 61 6e 75 70 20  rder to cleanup 
3e10: 74 68 65 20 72 65 73 6f 75 72 63 65 73 0d 0a 20  the resources.. 
3e20: 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69 61 74 65     /// associate
3e30: 64 20 77 69 74 68 20 61 20 6d 6f 64 75 6c 65 20  d with a module 
3e40: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 69  containing the i
3e50: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
3e60: 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65   a virtual table
3e70: 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  ...    /// </sum
3e80: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  mary>..    /// <
3e90: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6d 6f 64 75  param name="modu
3ea0: 6c 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68  le">..    /// Th
3eb0: 65 20 6d 6f 64 75 6c 65 20 6f 62 6a 65 63 74 20  e module object 
3ec0: 70 72 65 76 69 6f 75 73 6c 79 20 70 61 73 73 65  previously passe
3ed0: 64 20 74 6f 20 74 68 65 20 3c 73 65 65 20 63 72  d to the <see cr
3ee0: 65 66 3d 22 43 72 65 61 74 65 4d 6f 64 75 6c 65  ef="CreateModule
3ef0: 22 20 2f 3e 0d 0a 20 20 20 20 2f 2f 2f 20 6d 65  " />..    /// me
3f00: 74 68 6f 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  thod...    /// <
3f10: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f  /param>..    ///
3f20: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 66 6c   <param name="fl
3f30: 61 67 73 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54  ags">..    /// T
3f40: 68 65 20 66 6c 61 67 73 20 66 6f 72 20 74 68 65  he flags for the
3f50: 20 61 73 73 6f 63 69 61 74 65 64 20 3c 73 65 65   associated <see
3f60: 20 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e   cref="SQLiteCon
3f70: 6e 65 63 74 69 6f 6e 22 20 2f 3e 20 6f 62 6a 65  nection" /> obje
3f80: 63 74 20 69 6e 73 74 61 6e 63 65 2e 0d 0a 20 20  ct instance...  
3f90: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a    /// </param>..
3fa0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
3fb0: 74 72 61 63 74 20 76 6f 69 64 20 44 69 73 70 6f  tract void Dispo
3fc0: 73 65 4d 6f 64 75 6c 65 28 53 51 4c 69 74 65 4d  seModule(SQLiteM
3fd0: 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 2c 20 53 51  odule module, SQ
3fe0: 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c  LiteConnectionFl
3ff0: 61 67 73 20 66 6c 61 67 73 29 3b 0d 0a 0d 0a 20  ags flags);.... 
4000: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
4010: 0d 0a 20 20 20 20 2f 2f 2f 20 43 61 6c 6c 73 20  ..    /// Calls 
4020: 74 68 65 20 6e 61 74 69 76 65 20 53 51 4c 69 74  the native SQLit
4030: 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 20 69  e core library i
4040: 6e 20 6f 72 64 65 72 20 74 6f 20 64 65 63 6c 61  n order to decla
4050: 72 65 20 61 20 76 69 72 74 75 61 6c 20 74 61 62  re a virtual tab
4060: 6c 65 0d 0a 20 20 20 20 2f 2f 2f 20 69 6e 20 72  le..    /// in r
4070: 65 73 70 6f 6e 73 65 20 74 6f 20 61 20 63 61 6c  esponse to a cal
4080: 6c 20 69 6e 74 6f 20 74 68 65 20 3c 73 65 65 20  l into the <see 
4090: 63 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74  cref="ISQLiteNat
40a0: 69 76 65 4d 6f 64 75 6c 65 2e 78 43 72 65 61 74  iveModule.xCreat
40b0: 65 22 20 2f 3e 0d 0a 20 20 20 20 2f 2f 2f 20 6f  e" />..    /// o
40c0: 72 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53 51  r <see cref="ISQ
40d0: 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c 65  LiteNativeModule
40e0: 2e 78 43 6f 6e 6e 65 63 74 22 20 2f 3e 20 76 69  .xConnect" /> vi
40f0: 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 65 74 68  rtual table meth
4100: 6f 64 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ods...    /// </
4110: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
4120: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 6d  / <param name="m
4130: 6f 64 75 6c 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f  odule">..    ///
4140: 20 54 68 65 20 76 69 72 74 75 61 6c 20 74 61 62   The virtual tab
4150: 6c 65 20 6d 6f 64 75 6c 65 20 74 68 61 74 20 69  le module that i
4160: 73 20 74 6f 20 62 65 20 72 65 73 70 6f 6e 73 69  s to be responsi
4170: 62 6c 65 20 66 6f 72 20 74 68 65 20 76 69 72 74  ble for the virt
4180: 75 61 6c 20 74 61 62 6c 65 0d 0a 20 20 20 20 2f  ual table..    /
4190: 2f 2f 20 62 65 69 6e 67 20 64 65 63 6c 61 72 65  // being declare
41a0: 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61  d...    /// </pa
41b0: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ram>..    /// <p
41c0: 61 72 61 6d 20 6e 61 6d 65 3d 22 73 74 72 53 71  aram name="strSq
41d0: 6c 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65  l">..    /// The
41e0: 20 73 74 72 69 6e 67 20 63 6f 6e 74 61 69 6e 69   string containi
41f0: 6e 67 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  ng the SQL state
4200: 6d 65 6e 74 20 64 65 73 63 72 69 62 69 6e 67 20  ment describing 
4210: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
4220: 65 20 74 6f 0d 0a 20 20 20 20 2f 2f 2f 20 62 65  e to..    /// be
4230: 20 64 65 63 6c 61 72 65 64 2e 0d 0a 20 20 20 20   declared...    
4240: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  /// </param>..  
4250: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d    /// <param nam
4260: 65 3d 22 65 72 72 6f 72 22 3e 0d 0a 20 20 20 20  e="error">..    
4270: 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 63 65 73 73  /// Upon success
4280: 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f  , the contents o
4290: 66 20 74 68 69 73 20 70 61 72 61 6d 65 74 65 72  f this parameter
42a0: 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 20   are undefined. 
42b0: 20 55 70 6f 6e 20 66 61 69 6c 75 72 65 2c 0d 0a   Upon failure,..
42c0: 20 20 20 20 2f 2f 2f 20 69 74 20 73 68 6f 75 6c      /// it shoul
42d0: 64 20 63 6f 6e 74 61 69 6e 20 61 6e 20 61 70 70  d contain an app
42e0: 72 6f 70 72 69 61 74 65 20 65 72 72 6f 72 20 6d  ropriate error m
42f0: 65 73 73 61 67 65 2e 0d 0a 20 20 20 20 2f 2f 2f  essage...    ///
4300: 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f   </param>..    /
4310: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20  // <returns>..  
4320: 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64 61 72 64    /// A standard
4330: 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63   SQLite return c
4340: 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ode...    /// </
4350: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e  returns>..    in
4360: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
4370: 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20  SQLiteErrorCode 
4380: 44 65 63 6c 61 72 65 56 69 72 74 75 61 6c 54 61  DeclareVirtualTa
4390: 62 6c 65 28 53 51 4c 69 74 65 4d 6f 64 75 6c 65  ble(SQLiteModule
43a0: 20 6d 6f 64 75 6c 65 2c 20 73 74 72 69 6e 67 20   module, string 
43b0: 73 74 72 53 71 6c 2c 20 72 65 66 20 73 74 72 69  strSql, ref stri
43c0: 6e 67 20 65 72 72 6f 72 29 3b 0d 0a 0d 0a 20 20  ng error);....  
43d0: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
43e0: 0a 20 20 20 20 2f 2f 2f 20 43 61 6c 6c 73 20 74  .    /// Calls t
43f0: 68 65 20 6e 61 74 69 76 65 20 53 51 4c 69 74 65  he native SQLite
4400: 20 63 6f 72 65 20 6c 69 62 72 61 72 79 20 69 6e   core library in
4410: 20 6f 72 64 65 72 20 74 6f 20 64 65 63 6c 61 72   order to declar
4420: 65 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c  e a virtual tabl
4430: 65 0d 0a 20 20 20 20 2f 2f 2f 20 66 75 6e 63 74  e..    /// funct
4440: 69 6f 6e 20 69 6e 20 72 65 73 70 6f 6e 73 65 20  ion in response 
4450: 74 6f 20 61 20 63 61 6c 6c 20 69 6e 74 6f 20 74  to a call into t
4460: 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22 49 53  he <see cref="IS
4470: 51 4c 69 74 65 4e 61 74 69 76 65 4d 6f 64 75 6c  QLiteNativeModul
4480: 65 2e 78 43 72 65 61 74 65 22 20 2f 3e 0d 0a 20  e.xCreate" />.. 
4490: 20 20 20 2f 2f 2f 20 6f 72 20 3c 73 65 65 20 63     /// or <see c
44a0: 72 65 66 3d 22 49 53 51 4c 69 74 65 4e 61 74 69  ref="ISQLiteNati
44b0: 76 65 4d 6f 64 75 6c 65 2e 78 43 6f 6e 6e 65 63  veModule.xConnec
44c0: 74 22 20 2f 3e 20 76 69 72 74 75 61 6c 20 74 61  t" /> virtual ta
44d0: 62 6c 65 20 6d 65 74 68 6f 64 73 2e 0d 0a 20 20  ble methods...  
44e0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
44f0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
4500: 20 6e 61 6d 65 3d 22 6d 6f 64 75 6c 65 22 3e 0d   name="module">.
4510: 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 76 69 72  .    /// The vir
4520: 74 75 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 6c  tual table modul
4530: 65 20 74 68 61 74 20 69 73 20 74 6f 20 62 65 20  e that is to be 
4540: 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20  responsible for 
4550: 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c  the virtual tabl
4560: 65 0d 0a 20 20 20 20 2f 2f 2f 20 66 75 6e 63 74  e..    /// funct
4570: 69 6f 6e 20 62 65 69 6e 67 20 64 65 63 6c 61 72  ion being declar
4580: 65 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70  ed...    /// </p
4590: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
45a0: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 61 72 67 75  param name="argu
45b0: 6d 65 6e 74 43 6f 75 6e 74 22 3e 0d 0a 20 20 20  mentCount">..   
45c0: 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62 65 72 20   /// The number 
45d0: 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20  of arguments to 
45e0: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 62 65 69  the function bei
45f0: 6e 67 20 64 65 63 6c 61 72 65 64 2e 0d 0a 20 20  ng declared...  
4600: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a    /// </param>..
4610: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
4620: 61 6d 65 3d 22 6e 61 6d 65 22 3e 0d 0a 20 20 20  ame="name">..   
4630: 20 2f 2f 2f 20 54 68 65 20 6e 61 6d 65 20 6f 66   /// The name of
4640: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 62 65   the function be
4650: 69 6e 67 20 64 65 63 6c 61 72 65 64 2e 0d 0a 20  ing declared... 
4660: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d     /// </param>.
4670: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
4680: 6e 61 6d 65 3d 22 65 72 72 6f 72 22 3e 0d 0a 20  name="error">.. 
4690: 20 20 20 2f 2f 2f 20 55 70 6f 6e 20 73 75 63 63     /// Upon succ
46a0: 65 73 73 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74  ess, the content
46b0: 73 20 6f 66 20 74 68 69 73 20 70 61 72 61 6d 65  s of this parame
46c0: 74 65 72 20 61 72 65 20 75 6e 64 65 66 69 6e 65  ter are undefine
46d0: 64 2e 20 20 55 70 6f 6e 20 66 61 69 6c 75 72 65  d.  Upon failure
46e0: 2c 0d 0a 20 20 20 20 2f 2f 2f 20 69 74 20 73 68  ,..    /// it sh
46f0: 6f 75 6c 64 20 63 6f 6e 74 61 69 6e 20 61 6e 20  ould contain an 
4700: 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f  appropriate erro
4710: 72 20 6d 65 73 73 61 67 65 2e 0d 0a 20 20 20 20  r message...    
4720: 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  /// </param>..  
4730: 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d    /// <returns>.
4740: 0a 20 20 20 20 2f 2f 2f 20 41 20 73 74 61 6e 64  .    /// A stand
4750: 61 72 64 20 53 51 4c 69 74 65 20 72 65 74 75 72  ard SQLite retur
4760: 6e 20 63 6f 64 65 2e 0d 0a 20 20 20 20 2f 2f 2f  n code...    ///
4770: 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20   </returns>..   
4780: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
4790: 63 74 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f  ct SQLiteErrorCo
47a0: 64 65 20 44 65 63 6c 61 72 65 56 69 72 74 75 61  de DeclareVirtua
47b0: 6c 46 75 6e 63 74 69 6f 6e 28 53 51 4c 69 74 65  lFunction(SQLite
47c0: 4d 6f 64 75 6c 65 20 6d 6f 64 75 6c 65 2c 20 69  Module module, i
47d0: 6e 74 20 61 72 67 75 6d 65 6e 74 43 6f 75 6e 74  nt argumentCount
47e0: 2c 20 73 74 72 69 6e 67 20 6e 61 6d 65 2c 20 72  , string name, r
47f0: 65 66 20 73 74 72 69 6e 67 20 65 72 72 6f 72 29  ef string error)
4800: 3b 0d 0a 23 65 6e 64 69 66 0d 0a 0d 0a 20 20 20  ;..#endif....   
4810: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
4820: 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 73 20      /// Enables 
4830: 6f 72 20 64 69 73 61 62 6c 65 64 20 65 78 74 65  or disabled exte
4840: 6e 73 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 62 79  nsion loading by
4850: 20 53 51 4c 69 74 65 2e 0d 0a 20 20 20 20 2f 2f   SQLite...    //
4860: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
4870: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d    /// <param nam
4880: 65 3d 22 62 4f 6e 4f 66 66 22 3e 0d 0a 20 20 20  e="bOnOff">..   
4890: 20 2f 2f 2f 20 54 72 75 65 20 74 6f 20 65 6e 61   /// True to ena
48a0: 62 6c 65 20 6c 6f 61 64 69 6e 67 20 6f 66 20 65  ble loading of e
48b0: 78 74 65 6e 73 69 6f 6e 73 2c 20 66 61 6c 73 65  xtensions, false
48c0: 20 74 6f 20 64 69 73 61 62 6c 65 2e 0d 0a 20 20   to disable...  
48d0: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a    /// </param>..
48e0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
48f0: 74 72 61 63 74 20 76 6f 69 64 20 53 65 74 4c 6f  tract void SetLo
4900: 61 64 45 78 74 65 6e 73 69 6f 6e 28 62 6f 6f 6c  adExtension(bool
4910: 20 62 4f 6e 4f 66 66 29 3b 0d 0a 20 20 20 20 2f   bOnOff);..    /
4920: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
4930: 20 20 2f 2f 2f 20 4c 6f 61 64 73 20 61 20 53 51    /// Loads a SQ
4940: 4c 69 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c  Lite extension l
4950: 69 62 72 61 72 79 20 66 72 6f 6d 20 74 68 65 20  ibrary from the 
4960: 6e 61 6d 65 64 20 66 69 6c 65 2e 0d 0a 20 20 20  named file...   
4970: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
4980: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
4990: 6e 61 6d 65 3d 22 66 69 6c 65 4e 61 6d 65 22 3e  name="fileName">
49a0: 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61  ..    /// The na
49b0: 6d 65 20 6f 66 20 74 68 65 20 64 79 6e 61 6d 69  me of the dynami
49c0: 63 20 6c 69 6e 6b 20 6c 69 62 72 61 72 79 20 66  c link library f
49d0: 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ile containing t
49e0: 68 65 20 65 78 74 65 6e 73 69 6f 6e 2e 0d 0a 20  he extension... 
49f0: 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d     /// </param>.
4a00: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
4a10: 6e 61 6d 65 3d 22 70 72 6f 63 4e 61 6d 65 22 3e  name="procName">
4a20: 0d 0a 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 61  ..    /// The na
4a30: 6d 65 20 6f 66 20 74 68 65 20 65 78 70 6f 72 74  me of the export
4a40: 65 64 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 64  ed function used
4a50: 20 74 6f 20 69 6e 69 74 69 61 6c 69 7a 65 20 74   to initialize t
4a60: 68 65 20 65 78 74 65 6e 73 69 6f 6e 2e 0d 0a 20  he extension... 
4a70: 20 20 20 2f 2f 2f 20 49 66 20 6e 75 6c 6c 2c 20     /// If null, 
4a80: 74 68 65 20 64 65 66 61 75 6c 74 20 22 73 71 6c  the default "sql
4a90: 69 74 65 33 5f 65 78 74 65 6e 73 69 6f 6e 5f 69  ite3_extension_i
4aa0: 6e 69 74 22 20 77 69 6c 6c 20 62 65 20 75 73 65  nit" will be use
4ab0: 64 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61  d...    /// </pa
4ac0: 72 61 6d 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ram>..    intern
4ad0: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
4ae0: 20 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 28 73   LoadExtension(s
4af0: 74 72 69 6e 67 20 66 69 6c 65 4e 61 6d 65 2c 20  tring fileName, 
4b00: 73 74 72 69 6e 67 20 70 72 6f 63 4e 61 6d 65 29  string procName)
4b10: 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ;..    /// <summ
4b20: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 45 6e  ary>..    /// En
4b30: 61 62 6c 65 73 20 6f 72 20 64 69 73 61 62 6c 65  ables or disable
4b40: 64 20 65 78 74 65 6e 65 64 20 72 65 73 75 6c 74  d extened result
4b50: 20 63 6f 64 65 73 20 72 65 74 75 72 6e 65 64 20   codes returned 
4b60: 62 79 20 53 51 4c 69 74 65 0d 0a 20 20 20 20 2f  by SQLite..    /
4b70: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
4b80: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61     /// <param na
4b90: 6d 65 3d 22 62 4f 6e 4f 66 66 22 3e 74 72 75 65  me="bOnOff">true
4ba0: 20 74 6f 20 65 6e 61 62 6c 65 20 65 78 74 65 6e   to enable exten
4bb0: 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 73  ded result codes
4bc0: 2c 20 66 61 6c 73 65 20 74 6f 20 64 69 73 61 62  , false to disab
4bd0: 6c 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20  le.</param>..   
4be0: 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 3c 2f   /// <returns></
4bf0: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e  returns>..    in
4c00: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
4c10: 76 6f 69 64 20 53 65 74 45 78 74 65 6e 64 65 64  void SetExtended
4c20: 52 65 73 75 6c 74 43 6f 64 65 73 28 62 6f 6f 6c  ResultCodes(bool
4c30: 20 62 4f 6e 4f 66 66 29 3b 0d 0a 20 20 20 20 2f   bOnOff);..    /
4c40: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
4c50: 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68    /// Returns th
4c60: 65 20 6e 75 6d 65 72 69 63 20 72 65 73 75 6c 74  e numeric result
4c70: 20 63 6f 64 65 20 66 6f 72 20 74 68 65 20 6d 6f   code for the mo
4c80: 73 74 20 72 65 63 65 6e 74 20 66 61 69 6c 65 64  st recent failed
4c90: 20 53 51 4c 69 74 65 20 41 50 49 20 63 61 6c 6c   SQLite API call
4ca0: 0d 0a 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63 69  ..    /// associ
4cb0: 61 74 65 64 20 77 69 74 68 20 74 68 65 20 64 61  ated with the da
4cc0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f  tabase connectio
4cd0: 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  n...    /// </su
4ce0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
4cf0: 3c 72 65 74 75 72 6e 73 3e 52 65 73 75 6c 74 20  <returns>Result 
4d00: 63 6f 64 65 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a  code</returns>..
4d10: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
4d20: 74 72 61 63 74 20 53 51 4c 69 74 65 45 72 72 6f  tract SQLiteErro
4d30: 72 43 6f 64 65 20 52 65 73 75 6c 74 43 6f 64 65  rCode ResultCode
4d40: 28 29 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ();..    /// <su
4d50: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
4d60: 52 65 74 75 72 6e 73 20 74 68 65 20 65 78 74 65  Returns the exte
4d70: 6e 64 65 64 20 6e 75 6d 65 72 69 63 20 72 65 73  nded numeric res
4d80: 75 6c 74 20 63 6f 64 65 20 66 6f 72 20 74 68 65  ult code for the
4d90: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 66 61 69   most recent fai
4da0: 6c 65 64 20 53 51 4c 69 74 65 20 41 50 49 20 63  led SQLite API c
4db0: 61 6c 6c 0d 0a 20 20 20 20 2f 2f 2f 20 61 73 73  all..    /// ass
4dc0: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65  ociated with the
4dd0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
4de0: 74 69 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  tion...    /// <
4df0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  /summary>..    /
4e00: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 45 78 74 65  // <returns>Exte
4e10: 6e 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65  nded result code
4e20: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20  </returns>..    
4e30: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
4e40: 74 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f 64  t SQLiteErrorCod
4e50: 65 20 45 78 74 65 6e 64 65 64 52 65 73 75 6c 74  e ExtendedResult
4e60: 43 6f 64 65 28 29 3b 0d 0a 0d 0a 20 20 20 20 2f  Code();....    /
4e70: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
4e80: 20 20 2f 2f 2f 20 41 64 64 20 61 20 6c 6f 67 20    /// Add a log 
4e90: 6d 65 73 73 61 67 65 20 76 69 61 20 74 68 65 20  message via the 
4ea0: 53 51 4c 69 74 65 20 73 71 6c 69 74 65 33 5f 6c  SQLite sqlite3_l
4eb0: 6f 67 20 69 6e 74 65 72 66 61 63 65 2e 0d 0a 20  og interface... 
4ec0: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
4ed0: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61  >..    /// <para
4ee0: 6d 20 6e 61 6d 65 3d 22 69 45 72 72 43 6f 64 65  m name="iErrCode
4ef0: 22 3e 45 72 72 6f 72 20 63 6f 64 65 20 74 6f 20  ">Error code to 
4f00: 62 65 20 6c 6f 67 67 65 64 20 77 69 74 68 20 74  be logged with t
4f10: 68 65 20 6d 65 73 73 61 67 65 2e 3c 2f 70 61 72  he message.</par
4f20: 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61  am>..    /// <pa
4f30: 72 61 6d 20 6e 61 6d 65 3d 22 7a 4d 65 73 73 61  ram name="zMessa
4f40: 67 65 22 3e 53 74 72 69 6e 67 20 74 6f 20 62 65  ge">String to be
4f50: 20 6c 6f 67 67 65 64 2e 20 20 55 6e 6c 69 6b 65   logged.  Unlike
4f60: 20 74 68 65 20 53 51 4c 69 74 65 20 73 71 6c 69   the SQLite sqli
4f70: 74 65 33 5f 6c 6f 67 28 29 0d 0a 20 20 20 20 2f  te3_log()..    /
4f80: 2f 2f 20 69 6e 74 65 72 66 61 63 65 2c 20 74 68  // interface, th
4f90: 69 73 20 73 68 6f 75 6c 64 20 62 65 20 70 72 65  is should be pre
4fa0: 2d 66 6f 72 6d 61 74 74 65 64 2e 20 20 43 6f 6e  -formatted.  Con
4fb0: 73 69 64 65 72 20 75 73 69 6e 67 20 74 68 65 0d  sider using the.
4fc0: 0a 20 20 20 20 2f 2f 2f 20 53 74 72 69 6e 67 2e  .    /// String.
4fd0: 46 6f 72 6d 61 74 28 29 20 66 75 6e 63 74 69 6f  Format() functio
4fe0: 6e 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  n.</param>..    
4ff0: 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 3c 2f 72  /// <returns></r
5000: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74  eturns>..    int
5010: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
5020: 6f 69 64 20 4c 6f 67 4d 65 73 73 61 67 65 28 53  oid LogMessage(S
5030: 51 4c 69 74 65 45 72 72 6f 72 43 6f 64 65 20 69  QLiteErrorCode i
5040: 45 72 72 43 6f 64 65 2c 20 73 74 72 69 6e 67 20  ErrCode, string 
5050: 7a 4d 65 73 73 61 67 65 29 3b 0d 0a 0d 0a 23 69  zMessage);....#i
5060: 66 20 49 4e 54 45 52 4f 50 5f 43 4f 44 45 43 20  f INTEROP_CODEC 
5070: 7c 7c 20 49 4e 54 45 52 4f 50 5f 49 4e 43 4c 55  || INTEROP_INCLU
5080: 44 45 5f 53 45 45 0d 0a 20 20 20 20 69 6e 74 65  DE_SEE..    inte
5090: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
50a0: 69 64 20 53 65 74 50 61 73 73 77 6f 72 64 28 62  id SetPassword(b
50b0: 79 74 65 5b 5d 20 70 61 73 73 77 6f 72 64 42 79  yte[] passwordBy
50c0: 74 65 73 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  tes);..    inter
50d0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69  nal abstract voi
50e0: 64 20 43 68 61 6e 67 65 50 61 73 73 77 6f 72 64  d ChangePassword
50f0: 28 62 79 74 65 5b 5d 20 6e 65 77 50 61 73 73 77  (byte[] newPassw
5100: 6f 72 64 42 79 74 65 73 29 3b 0d 0a 23 65 6e 64  ordBytes);..#end
5110: 69 66 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e  if....    intern
5120: 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69 64  al abstract void
5130: 20 53 65 74 41 75 74 68 6f 72 69 7a 65 72 48 6f   SetAuthorizerHo
5140: 6f 6b 28 53 51 4c 69 74 65 41 75 74 68 6f 72 69  ok(SQLiteAuthori
5150: 7a 65 72 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63  zerCallback func
5160: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
5170: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 53   abstract void S
5180: 65 74 55 70 64 61 74 65 48 6f 6f 6b 28 53 51 4c  etUpdateHook(SQL
5190: 69 74 65 55 70 64 61 74 65 43 61 6c 6c 62 61 63  iteUpdateCallbac
51a0: 6b 20 66 75 6e 63 29 3b 0d 0a 20 20 20 20 69 6e  k func);..    in
51b0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
51c0: 76 6f 69 64 20 53 65 74 43 6f 6d 6d 69 74 48 6f  void SetCommitHo
51d0: 6f 6b 28 53 51 4c 69 74 65 43 6f 6d 6d 69 74 43  ok(SQLiteCommitC
51e0: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 29 3b 0d 0a  allback func);..
51f0: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
5200: 74 72 61 63 74 20 76 6f 69 64 20 53 65 74 54 72  tract void SetTr
5210: 61 63 65 43 61 6c 6c 62 61 63 6b 28 53 51 4c 69  aceCallback(SQLi
5220: 74 65 54 72 61 63 65 43 61 6c 6c 62 61 63 6b 20  teTraceCallback 
5230: 66 75 6e 63 29 3b 0d 0a 20 20 20 20 69 6e 74 65  func);..    inte
5240: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
5250: 69 64 20 53 65 74 52 6f 6c 6c 62 61 63 6b 48 6f  id SetRollbackHo
5260: 6f 6b 28 53 51 4c 69 74 65 52 6f 6c 6c 62 61 63  ok(SQLiteRollbac
5270: 6b 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 29 3b  kCallback func);
5280: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
5290: 62 73 74 72 61 63 74 20 53 51 4c 69 74 65 45 72  bstract SQLiteEr
52a0: 72 6f 72 43 6f 64 65 20 53 65 74 4c 6f 67 43 61  rorCode SetLogCa
52b0: 6c 6c 62 61 63 6b 28 53 51 4c 69 74 65 4c 6f 67  llback(SQLiteLog
52c0: 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63 29 3b 0d  Callback func);.
52d0: 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ...    /// <summ
52e0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43 68  ary>..    /// Ch
52f0: 65 63 6b 73 20 69 66 20 74 68 65 20 53 51 4c 69  ecks if the SQLi
5300: 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 20  te core library 
5310: 68 61 73 20 62 65 65 6e 20 69 6e 69 74 69 61 6c  has been initial
5320: 69 7a 65 64 20 69 6e 20 74 68 65 20 63 75 72 72  ized in the curr
5330: 65 6e 74 20 70 72 6f 63 65 73 73 2e 0d 0a 20 20  ent process...  
5340: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
5350: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72  ..    /// <retur
5360: 6e 73 3e 0d 0a 20 20 20 20 2f 2f 2f 20 4e 6f 6e  ns>..    /// Non
5370: 2d 7a 65 72 6f 20 69 66 20 74 68 65 20 53 51 4c  -zero if the SQL
5380: 69 74 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79  ite core library
5390: 20 68 61 73 20 62 65 65 6e 20 69 6e 69 74 69 61   has been initia
53a0: 6c 69 7a 65 64 20 69 6e 20 74 68 65 20 63 75 72  lized in the cur
53b0: 72 65 6e 74 20 70 72 6f 63 65 73 73 2c 0d 0a 20  rent process,.. 
53c0: 20 20 20 2f 2f 2f 20 7a 65 72 6f 20 6f 74 68 65     /// zero othe
53d0: 72 77 69 73 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20  rwise...    /// 
53e0: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20  </returns>..    
53f0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
5400: 74 20 62 6f 6f 6c 20 49 73 49 6e 69 74 69 61 6c  t bool IsInitial
5410: 69 7a 65 64 28 29 3b 0d 0a 0d 0a 20 20 20 20 69  ized();....    i
5420: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
5430: 20 69 6e 74 20 47 65 74 43 75 72 73 6f 72 46 6f   int GetCursorFo
5440: 72 54 61 62 6c 65 28 53 51 4c 69 74 65 53 74 61  rTable(SQLiteSta
5450: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74  tement stmt, int
5460: 20 64 61 74 61 62 61 73 65 2c 20 69 6e 74 20 72   database, int r
5470: 6f 6f 74 50 61 67 65 29 3b 0d 0a 20 20 20 20 69  ootPage);..    i
5480: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
5490: 20 6c 6f 6e 67 20 47 65 74 52 6f 77 49 64 46 6f   long GetRowIdFo
54a0: 72 43 75 72 73 6f 72 28 53 51 4c 69 74 65 53 74  rCursor(SQLiteSt
54b0: 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69 6e  atement stmt, in
54c0: 74 20 63 75 72 73 6f 72 29 3b 0d 0a 0d 0a 20 20  t cursor);....  
54d0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
54e0: 61 63 74 20 6f 62 6a 65 63 74 20 47 65 74 56 61  act object GetVa
54f0: 6c 75 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d  lue(SQLiteStatem
5500: 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65  ent stmt, SQLite
5510: 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20  ConnectionFlags 
5520: 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78  flags, int index
5530: 2c 20 53 51 4c 69 74 65 54 79 70 65 20 74 79 70  , SQLiteType typ
5540: 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73  );....    /// <s
5550: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
5560: 20 52 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72   Returns non-zer
5570: 6f 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 64  o if the given d
5580: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
5590: 6f 6e 20 69 73 20 69 6e 20 61 75 74 6f 63 6f 6d  on is in autocom
55a0: 6d 69 74 20 6d 6f 64 65 2e 0d 0a 20 20 20 20 2f  mit mode...    /
55b0: 2f 2f 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f  // Autocommit mo
55c0: 64 65 20 69 73 20 6f 6e 20 62 79 20 64 65 66 61  de is on by defa
55d0: 75 6c 74 2e 20 20 41 75 74 6f 63 6f 6d 6d 69 74  ult.  Autocommit
55e0: 20 6d 6f 64 65 20 69 73 20 64 69 73 61 62 6c 65   mode is disable
55f0: 64 20 62 79 20 61 20 42 45 47 49 4e 0d 0a 20 20  d by a BEGIN..  
5600: 20 20 2f 2f 2f 20 73 74 61 74 65 6d 65 6e 74 2e    /// statement.
5610: 20 20 41 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f 64    Autocommit mod
5620: 65 20 69 73 20 72 65 2d 65 6e 61 62 6c 65 64 20  e is re-enabled 
5630: 62 79 20 61 20 43 4f 4d 4d 49 54 20 6f 72 20 52  by a COMMIT or R
5640: 4f 4c 4c 42 41 43 4b 2e 0d 0a 20 20 20 20 2f 2f  OLLBACK...    //
5650: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
5660: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
5670: 61 63 74 20 62 6f 6f 6c 20 41 75 74 6f 43 6f 6d  act bool AutoCom
5680: 6d 69 74 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20  mit..    {..    
5690: 20 20 67 65 74 3b 0d 0a 20 20 20 20 7d 0d 0a 0d    get;..    }...
56a0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
56b0: 73 74 72 61 63 74 20 53 51 4c 69 74 65 45 72 72  stract SQLiteErr
56c0: 6f 72 43 6f 64 65 20 46 69 6c 65 43 6f 6e 74 72  orCode FileContr
56d0: 6f 6c 28 73 74 72 69 6e 67 20 7a 44 62 4e 61 6d  ol(string zDbNam
56e0: 65 2c 20 69 6e 74 20 6f 70 2c 20 49 6e 74 50 74  e, int op, IntPt
56f0: 72 20 70 41 72 67 29 3b 0d 0a 0d 0a 20 20 20 20  r pArg);....    
5700: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
5710: 20 20 20 2f 2f 2f 20 43 72 65 61 74 65 73 20 61     /// Creates a
5720: 20 6e 65 77 20 53 51 4c 69 74 65 20 62 61 63 6b   new SQLite back
5730: 75 70 20 6f 62 6a 65 63 74 20 62 61 73 65 64 20  up object based 
5740: 6f 6e 20 74 68 65 20 70 72 6f 76 69 64 65 64 20  on the provided 
5750: 64 65 73 74 69 6e 61 74 69 6f 6e 0d 0a 20 20 20  destination..   
5760: 20 2f 2f 2f 20 64 61 74 61 62 61 73 65 20 63 6f   /// database co
5770: 6e 6e 65 63 74 69 6f 6e 2e 20 20 54 68 65 20 73  nnection.  The s
5780: 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 20 63  ource database c
5790: 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 74 68 65  onnection is the
57a0: 20 6f 6e 65 0d 0a 20 20 20 20 2f 2f 2f 20 61 73   one..    /// as
57b0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68  sociated with th
57c0: 69 73 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 20  is object.  The 
57d0: 73 6f 75 72 63 65 20 61 6e 64 20 64 65 73 74 69  source and desti
57e0: 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73 65 0d  nation database.
57f0: 0a 20 20 20 20 2f 2f 2f 20 63 6f 6e 6e 65 63 74  .    /// connect
5800: 69 6f 6e 73 20 63 61 6e 6e 6f 74 20 62 65 20 74  ions cannot be t
5810: 68 65 20 73 61 6d 65 2e 0d 0a 20 20 20 20 2f 2f  he same...    //
5820: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
5830: 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d    /// <param nam
5840: 65 3d 22 64 65 73 74 43 6e 6e 22 3e 54 68 65 20  e="destCnn">The 
5850: 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61  destination data
5860: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  base connection.
5870: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f  </param>..    //
5880: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 64  / <param name="d
5890: 65 73 74 4e 61 6d 65 22 3e 54 68 65 20 64 65 73  estName">The des
58a0: 74 69 6e 61 74 69 6f 6e 20 64 61 74 61 62 61 73  tination databas
58b0: 65 20 6e 61 6d 65 2e 3c 2f 70 61 72 61 6d 3e 0d  e name.</param>.
58c0: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
58d0: 6e 61 6d 65 3d 22 73 6f 75 72 63 65 4e 61 6d 65  name="sourceName
58e0: 22 3e 54 68 65 20 73 6f 75 72 63 65 20 64 61 74  ">The source dat
58f0: 61 62 61 73 65 20 6e 61 6d 65 2e 3c 2f 70 61 72  abase name.</par
5900: 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65  am>..    /// <re
5910: 74 75 72 6e 73 3e 54 68 65 20 6e 65 77 6c 79 20  turns>The newly 
5920: 63 72 65 61 74 65 64 20 62 61 63 6b 75 70 20 6f  created backup o
5930: 62 6a 65 63 74 2e 3c 2f 72 65 74 75 72 6e 73 3e  bject.</returns>
5940: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
5950: 62 73 74 72 61 63 74 20 53 51 4c 69 74 65 42 61  bstract SQLiteBa
5960: 63 6b 75 70 20 49 6e 69 74 69 61 6c 69 7a 65 42  ckup InitializeB
5970: 61 63 6b 75 70 28 0d 0a 20 20 20 20 20 20 20 20  ackup(..        
5980: 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e  SQLiteConnection
5990: 20 64 65 73 74 43 6e 6e 2c 20 73 74 72 69 6e 67   destCnn, string
59a0: 20 64 65 73 74 4e 61 6d 65 2c 0d 0a 20 20 20 20   destName,..    
59b0: 20 20 20 20 73 74 72 69 6e 67 20 73 6f 75 72 63      string sourc
59c0: 65 4e 61 6d 65 29 3b 0d 0a 0d 0a 20 20 20 20 2f  eName);....    /
59d0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
59e0: 20 20 2f 2f 2f 20 43 6f 70 69 65 73 20 75 70 20    /// Copies up 
59f0: 74 6f 20 4e 20 70 61 67 65 73 20 66 72 6f 6d 20  to N pages from 
5a00: 74 68 65 20 73 6f 75 72 63 65 20 64 61 74 61 62  the source datab
5a10: 61 73 65 20 74 6f 20 74 68 65 20 64 65 73 74 69  ase to the desti
5a20: 6e 61 74 69 6f 6e 0d 0a 20 20 20 20 2f 2f 2f 20  nation..    /// 
5a30: 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69 61  database associa
5a40: 74 65 64 20 77 69 74 68 20 74 68 65 20 73 70 65  ted with the spe
5a50: 63 69 66 69 65 64 20 62 61 63 6b 75 70 20 6f 62  cified backup ob
5a60: 6a 65 63 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  ject...    /// <
5a70: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  /summary>..    /
5a80: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22  // <param name="
5a90: 62 61 63 6b 75 70 22 3e 54 68 65 20 62 61 63 6b  backup">The back
5aa0: 75 70 20 6f 62 6a 65 63 74 20 74 6f 20 75 73 65  up object to use
5ab0: 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f  .</param>..    /
5ac0: 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22  // <param name="
5ad0: 6e 50 61 67 65 22 3e 0d 0a 20 20 20 20 2f 2f 2f  nPage">..    ///
5ae0: 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   The number of p
5af0: 61 67 65 73 20 74 6f 20 63 6f 70 79 20 6f 72 20  ages to copy or 
5b00: 6e 65 67 61 74 69 76 65 20 74 6f 20 63 6f 70 79  negative to copy
5b10: 20 61 6c 6c 20 72 65 6d 61 69 6e 69 6e 67 20 70   all remaining p
5b20: 61 67 65 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  ages...    /// <
5b30: 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f  /param>..    ///
5b40: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 72 65   <param name="re
5b50: 74 72 79 22 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53  try">..    /// S
5b60: 65 74 20 74 6f 20 74 72 75 65 20 69 66 20 74 68  et to true if th
5b70: 65 20 6f 70 65 72 61 74 69 6f 6e 20 6e 65 65 64  e operation need
5b80: 73 20 74 6f 20 62 65 20 72 65 74 72 69 65 64 20  s to be retried 
5b90: 64 75 65 20 74 6f 20 64 61 74 61 62 61 73 65 0d  due to database.
5ba0: 0a 20 20 20 20 2f 2f 2f 20 6c 6f 63 6b 69 6e 67  .    /// locking
5bb0: 20 69 73 73 75 65 73 2e 0d 0a 20 20 20 20 2f 2f   issues...    //
5bc0: 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  / </param>..    
5bd0: 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20  /// <returns>.. 
5be0: 20 20 20 2f 2f 2f 20 54 72 75 65 20 69 66 20 74     /// True if t
5bf0: 68 65 72 65 20 61 72 65 20 6d 6f 72 65 20 70 61  here are more pa
5c00: 67 65 73 20 74 6f 20 62 65 20 63 6f 70 69 65 64  ges to be copied
5c10: 2c 20 66 61 6c 73 65 20 6f 74 68 65 72 77 69 73  , false otherwis
5c20: 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72 65  e...    /// </re
5c30: 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65  turns>..    inte
5c40: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 62 6f  rnal abstract bo
5c50: 6f 6c 20 53 74 65 70 42 61 63 6b 75 70 28 53 51  ol StepBackup(SQ
5c60: 4c 69 74 65 42 61 63 6b 75 70 20 62 61 63 6b 75  LiteBackup backu
5c70: 70 2c 20 69 6e 74 20 6e 50 61 67 65 2c 20 72 65  p, int nPage, re
5c80: 66 20 62 6f 6f 6c 20 72 65 74 72 79 29 3b 0d 0a  f bool retry);..
5c90: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
5ca0: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74  ry>..    /// Ret
5cb0: 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20  urns the number 
5cc0: 6f 66 20 70 61 67 65 73 20 72 65 6d 61 69 6e 69  of pages remaini
5cd0: 6e 67 20 74 6f 20 62 65 20 63 6f 70 69 65 64 20  ng to be copied 
5ce0: 66 72 6f 6d 20 74 68 65 20 73 6f 75 72 63 65 0d  from the source.
5cf0: 0a 20 20 20 20 2f 2f 2f 20 64 61 74 61 62 61 73  .    /// databas
5d00: 65 20 74 6f 20 74 68 65 20 64 65 73 74 69 6e 61  e to the destina
5d10: 74 69 6f 6e 20 64 61 74 61 62 61 73 65 20 61 73  tion database as
5d20: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68  sociated with th
5d30: 65 20 73 70 65 63 69 66 69 65 64 0d 0a 20 20 20  e specified..   
5d40: 20 2f 2f 2f 20 62 61 63 6b 75 70 20 6f 62 6a 65   /// backup obje
5d50: 63 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73  ct...    /// </s
5d60: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
5d70: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 62 61   <param name="ba
5d80: 63 6b 75 70 22 3e 54 68 65 20 62 61 63 6b 75 70  ckup">The backup
5d90: 20 6f 62 6a 65 63 74 20 74 6f 20 63 68 65 63 6b   object to check
5da0: 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f  .</param>..    /
5db0: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54 68 65 20  // <returns>The 
5dc0: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
5dd0: 72 65 6d 61 69 6e 69 6e 67 20 74 6f 20 62 65 20  remaining to be 
5de0: 63 6f 70 69 65 64 2e 3c 2f 72 65 74 75 72 6e 73  copied.</returns
5df0: 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  >..    internal 
5e00: 61 62 73 74 72 61 63 74 20 69 6e 74 20 52 65 6d  abstract int Rem
5e10: 61 69 6e 69 6e 67 42 61 63 6b 75 70 28 53 51 4c  ainingBackup(SQL
5e20: 69 74 65 42 61 63 6b 75 70 20 62 61 63 6b 75 70  iteBackup backup
5e30: 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73  );....    /// <s
5e40: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f  ummary>..    ///
5e50: 20 52 65 74 75 72 6e 73 20 74 68 65 20 74 6f 74   Returns the tot
5e60: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67  al number of pag
5e70: 65 73 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65  es in the source
5e80: 20 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69   database associ
5e90: 61 74 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 77 69  ated..    /// wi
5ea0: 74 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64  th the specified
5eb0: 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 2e 0d   backup object..
5ec0: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
5ed0: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61  ry>..    /// <pa
5ee0: 72 61 6d 20 6e 61 6d 65 3d 22 62 61 63 6b 75 70  ram name="backup
5ef0: 22 3e 54 68 65 20 62 61 63 6b 75 70 20 6f 62 6a  ">The backup obj
5f00: 65 63 74 20 74 6f 20 63 68 65 63 6b 2e 3c 2f 70  ect to check.</p
5f10: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
5f20: 72 65 74 75 72 6e 73 3e 54 68 65 20 74 6f 74 61  returns>The tota
5f30: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65  l number of page
5f40: 73 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20  s in the source 
5f50: 64 61 74 61 62 61 73 65 2e 3c 2f 72 65 74 75 72  database.</retur
5f60: 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ns>..    interna
5f70: 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 50  l abstract int P
5f80: 61 67 65 43 6f 75 6e 74 42 61 63 6b 75 70 28 53  ageCountBackup(S
5f90: 51 4c 69 74 65 42 61 63 6b 75 70 20 62 61 63 6b  QLiteBackup back
5fa0: 75 70 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20  up);....    /// 
5fb0: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  <summary>..    /
5fc0: 2f 2f 20 44 65 73 74 72 6f 79 73 20 74 68 65 20  // Destroys the 
5fd0: 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 2c 20 72  backup object, r
5fe0: 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 6e 79 20  olling back any 
5ff0: 62 61 63 6b 75 70 20 74 68 61 74 20 6d 61 79 20  backup that may 
6000: 62 65 20 69 6e 0d 0a 20 20 20 20 2f 2f 2f 20 70  be in..    /// p
6010: 72 6f 67 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f  rogess...    ///
6020: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
6030: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
6040: 3d 22 62 61 63 6b 75 70 22 3e 54 68 65 20 62 61  ="backup">The ba
6050: 63 6b 75 70 20 6f 62 6a 65 63 74 20 74 6f 20 64  ckup object to d
6060: 65 73 74 72 6f 79 2e 3c 2f 70 61 72 61 6d 3e 0d  estroy.</param>.
6070: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
6080: 73 74 72 61 63 74 20 76 6f 69 64 20 46 69 6e 69  stract void Fini
6090: 73 68 42 61 63 6b 75 70 28 53 51 4c 69 74 65 42  shBackup(SQLiteB
60a0: 61 63 6b 75 70 20 62 61 63 6b 75 70 29 3b 0d 0a  ackup backup);..
60b0: 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ..    //////////
60c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
60d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
60e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
60f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6100: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6110: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65  /////....    #re
6120: 67 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c 65  gion IDisposable
6130: 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 70 75   Members..    pu
6140: 62 6c 69 63 20 76 6f 69 64 20 44 69 73 70 6f 73  blic void Dispos
6150: 65 28 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20  e()..    {..    
6160: 20 20 20 20 44 69 73 70 6f 73 65 28 74 72 75 65      Dispose(true
6170: 29 3b 0d 0a 20 20 20 20 20 20 20 20 47 43 2e 53  );..        GC.S
6180: 75 70 70 72 65 73 73 46 69 6e 61 6c 69 7a 65 28  uppressFinalize(
6190: 74 68 69 73 29 3b 0d 0a 20 20 20 20 7d 0d 0a 20  this);..    }.. 
61a0: 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d     #endregion...
61b0: 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  .    ///////////
61c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
61d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
61e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
61f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6200: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6210: 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65 67  ////....    #reg
6220: 69 6f 6e 20 49 44 69 73 70 6f 73 61 62 6c 65 20  ion IDisposable 
6230: 22 50 61 74 74 65 72 6e 22 20 4d 65 6d 62 65 72  "Pattern" Member
6240: 73 0d 0a 20 20 20 20 70 72 69 76 61 74 65 20 62  s..    private b
6250: 6f 6f 6c 20 64 69 73 70 6f 73 65 64 3b 0d 0a 20  ool disposed;.. 
6260: 20 20 20 70 72 69 76 61 74 65 20 76 6f 69 64 20     private void 
6270: 43 68 65 63 6b 44 69 73 70 6f 73 65 64 28 29 20  CheckDisposed() 
6280: 2f 2a 20 74 68 72 6f 77 20 2a 2f 0d 0a 20 20 20  /* throw */..   
6290: 20 7b 0d 0a 23 69 66 20 54 48 52 4f 57 5f 4f 4e   {..#if THROW_ON
62a0: 5f 44 49 53 50 4f 53 45 44 0d 0a 20 20 20 20 20  _DISPOSED..     
62b0: 20 20 20 69 66 20 28 64 69 73 70 6f 73 65 64 29     if (disposed)
62c0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 68  ..            th
62d0: 72 6f 77 20 6e 65 77 20 4f 62 6a 65 63 74 44 69  row new ObjectDi
62e0: 73 70 6f 73 65 64 45 78 63 65 70 74 69 6f 6e 28  sposedException(
62f0: 74 79 70 65 6f 66 28 53 51 4c 69 74 65 42 61 73  typeof(SQLiteBas
6300: 65 29 2e 4e 61 6d 65 29 3b 0d 0a 23 65 6e 64 69  e).Name);..#endi
6310: 66 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20  f..    }....    
6320: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6330: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6340: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6350: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6360: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6370: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d  ///////////////.
6380: 0a 0d 0a 20 20 20 20 70 72 6f 74 65 63 74 65 64  ...    protected
6390: 20 76 69 72 74 75 61 6c 20 76 6f 69 64 20 44 69   virtual void Di
63a0: 73 70 6f 73 65 28 62 6f 6f 6c 20 64 69 73 70 6f  spose(bool dispo
63b0: 73 69 6e 67 29 0d 0a 20 20 20 20 7b 0d 0a 20 20  sing)..    {..  
63c0: 20 20 20 20 20 20 69 66 20 28 21 64 69 73 70 6f        if (!dispo
63d0: 73 65 64 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d  sed)..        {.
63e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 69  .            //i
63f0: 66 20 28 64 69 73 70 6f 73 69 6e 67 29 0d 0a 20  f (disposing).. 
6400: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 7b 0d 0a             //{..
6410: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20              //  
6420: 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f    //////////////
6430: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6440: 2f 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20  //////..        
6450: 20 20 20 20 2f 2f 20 20 20 20 2f 2f 20 64 69 73      //    // dis
6460: 70 6f 73 65 20 6d 61 6e 61 67 65 64 20 72 65 73  pose managed res
6470: 6f 75 72 63 65 73 20 68 65 72 65 2e 2e 2e 0d 0a  ources here.....
6480: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20              //  
6490: 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f    //////////////
64a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
64b0: 2f 2f 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20  //////..        
64c0: 20 20 20 20 2f 2f 7d 0d 0a 0d 0a 20 20 20 20 20      //}....     
64d0: 20 20 20 20 20 20 20 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 0d 0a 20  /////////////.. 
6500: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 72 65             // re
6510: 6c 65 61 73 65 20 75 6e 6d 61 6e 61 67 65 64 20  lease unmanaged 
6520: 72 65 73 6f 75 72 63 65 73 20 68 65 72 65 2e 2e  resources here..
6530: 2e 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f  ...            /
6540: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6550: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6560: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 20 20 20  /////....       
6570: 20 20 20 20 20 64 69 73 70 6f 73 65 64 20 3d 20       disposed = 
6580: 74 72 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 7d  true;..        }
6590: 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e  ..    }..    #en
65a0: 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f  dregion....    /
65b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
65c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
65d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
65e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
65f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6600: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a  //////////////..
6610: 0d 0a 20 20 20 20 23 72 65 67 69 6f 6e 20 44 65  ..    #region De
6620: 73 74 72 75 63 74 6f 72 0d 0a 20 20 20 20 7e 53  structor..    ~S
6630: 51 4c 69 74 65 42 61 73 65 28 29 0d 0a 20 20 20  QLiteBase()..   
6640: 20 7b 0d 0a 20 20 20 20 20 20 20 20 44 69 73 70   {..        Disp
6650: 6f 73 65 28 66 61 6c 73 65 29 3b 0d 0a 20 20 20  ose(false);..   
6660: 20 7d 0d 0a 20 20 20 20 23 65 6e 64 72 65 67 69   }..    #endregi
6670: 6f 6e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f  on....    //////
6680: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6690: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
66a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
66b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
66c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
66d0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20  /////////....   
66e0: 20 2f 2f 20 54 68 65 73 65 20 73 74 61 74 69 63   // These static
66f0: 73 20 61 72 65 20 68 65 72 65 20 66 6f 72 20 6c  s are here for l
6700: 61 63 6b 20 6f 66 20 61 20 62 65 74 74 65 72 20  ack of a better 
6710: 70 6c 61 63 65 20 74 6f 20 70 75 74 20 74 68 65  place to put the
6720: 6d 2e 0d 0a 20 20 20 20 2f 2f 20 54 68 65 79 20  m...    // They 
6730: 65 78 69 73 74 20 68 65 72 65 20 62 65 63 61 75  exist here becau
6740: 73 65 20 74 68 65 79 20 61 72 65 20 63 61 6c 6c  se they are call
6750: 65 64 20 64 75 72 69 6e 67 20 74 68 65 20 66 69  ed during the fi
6760: 6e 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 0d 0a 20  nalization of.. 
6770: 20 20 20 2f 2f 20 61 20 53 51 4c 69 74 65 53 74     // a SQLiteSt
6780: 61 74 65 6d 65 6e 74 48 61 6e 64 6c 65 2c 20 53  atementHandle, S
6790: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48  QLiteConnectionH
67a0: 61 6e 64 6c 65 2c 20 61 6e 64 20 53 51 4c 69 74  andle, and SQLit
67b0: 65 46 75 6e 63 74 69 6f 6e 43 6f 6f 6b 69 65 48  eFunctionCookieH
67c0: 61 6e 64 6c 65 2e 0d 0a 20 20 20 20 2f 2f 20 54  andle...    // T
67d0: 68 65 72 65 66 6f 72 65 20 74 68 65 73 65 20 66  herefore these f
67e0: 75 6e 63 74 69 6f 6e 73 20 68 61 76 65 20 74 6f  unctions have to
67f0: 20 62 65 20 73 74 61 74 69 63 2c 20 61 6e 64 20   be static, and 
6800: 68 61 76 65 20 74 6f 20 62 65 20 6c 6f 77 2d 6c  have to be low-l
6810: 65 76 65 6c 2e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f  evel.....    ///
6820: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6830: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6840: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6850: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6860: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6870: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a  ////////////....
6880: 20 20 20 20 70 72 69 76 61 74 65 20 73 74 61 74      private stat
6890: 69 63 20 73 74 72 69 6e 67 5b 5d 20 5f 65 72 72  ic string[] _err
68a0: 6f 72 4d 65 73 73 61 67 65 73 20 3d 20 7b 0d 0a  orMessages = {..
68b0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54          /* SQLIT
68c0: 45 5f 4f 4b 20 20 20 20 20 20 20 20 20 20 2a 2f  E_OK          */
68d0: 20 22 6e 6f 74 20 61 6e 20 65 72 72 6f 72 22 2c   "not an error",
68e0: 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c  ..        /* SQL
68f0: 49 54 45 5f 45 52 52 4f 52 20 20 20 20 20 20 20  ITE_ERROR       
6900: 2a 2f 20 22 53 51 4c 20 6c 6f 67 69 63 20 65 72  */ "SQL logic er
6910: 72 6f 72 20 6f 72 20 6d 69 73 73 69 6e 67 20 64  ror or missing d
6920: 61 74 61 62 61 73 65 22 2c 0d 0a 20 20 20 20 20  atabase",..     
6930: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54     /* SQLITE_INT
6940: 45 52 4e 41 4c 20 20 20 20 2a 2f 20 22 69 6e 74  ERNAL    */ "int
6950: 65 72 6e 61 6c 20 6c 6f 67 69 63 20 65 72 72 6f  ernal logic erro
6960: 72 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20  r",..        /* 
6970: 53 51 4c 49 54 45 5f 50 45 52 4d 20 20 20 20 20  SQLITE_PERM     
6980: 20 20 20 2a 2f 20 22 61 63 63 65 73 73 20 70 65     */ "access pe
6990: 72 6d 69 73 73 69 6f 6e 20 64 65 6e 69 65 64 22  rmission denied"
69a0: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51  ,..        /* SQ
69b0: 4c 49 54 45 5f 41 42 4f 52 54 20 20 20 20 20 20  LITE_ABORT      
69c0: 20 2a 2f 20 22 63 61 6c 6c 62 61 63 6b 20 72 65   */ "callback re
69d0: 71 75 65 73 74 65 64 20 71 75 65 72 79 20 61 62  quested query ab
69e0: 6f 72 74 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f  ort",..        /
69f0: 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 20 20  * SQLITE_BUSY   
6a00: 20 20 20 20 20 2a 2f 20 22 64 61 74 61 62 61 73       */ "databas
6a10: 65 20 69 73 20 6c 6f 63 6b 65 64 22 2c 0d 0a 20  e is locked",.. 
6a20: 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45         /* SQLITE
6a30: 5f 4c 4f 43 4b 45 44 20 20 20 20 20 20 2a 2f 20  _LOCKED      */ 
6a40: 22 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 20  "database table 
6a50: 69 73 20 6c 6f 63 6b 65 64 22 2c 0d 0a 20 20 20  is locked",..   
6a60: 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e       /* SQLITE_N
6a70: 4f 4d 45 4d 20 20 20 20 20 20 20 2a 2f 20 22 6f  OMEM       */ "o
6a80: 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 2c 0d 0a  ut of memory",..
6a90: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54          /* SQLIT
6aa0: 45 5f 52 45 41 44 4f 4e 4c 59 20 20 20 20 2a 2f  E_READONLY    */
6ab0: 20 22 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69   "attempt to wri
6ac0: 74 65 20 61 20 72 65 61 64 6f 6e 6c 79 20 64 61  te a readonly da
6ad0: 74 61 62 61 73 65 22 2c 0d 0a 20 20 20 20 20 20  tabase",..      
6ae0: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4e 54 45    /* SQLITE_INTE
6af0: 52 52 55 50 54 20 20 20 2a 2f 20 22 69 6e 74 65  RRUPT   */ "inte
6b00: 72 72 75 70 74 65 64 22 2c 0d 0a 20 20 20 20 20  rrupted",..     
6b10: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 49 4f 45     /* SQLITE_IOE
6b20: 52 52 20 20 20 20 20 20 20 2a 2f 20 22 64 69 73  RR       */ "dis
6b30: 6b 20 49 2f 4f 20 65 72 72 6f 72 22 2c 0d 0a 20  k I/O error",.. 
6b40: 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45         /* SQLITE
6b50: 5f 43 4f 52 52 55 50 54 20 20 20 20 20 2a 2f 20  _CORRUPT     */ 
6b60: 22 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 69  "database disk i
6b70: 6d 61 67 65 20 69 73 20 6d 61 6c 66 6f 72 6d 65  mage is malforme
6b80: 64 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20  d",..        /* 
6b90: 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20  SQLITE_NOTFOUND 
6ba0: 20 20 20 2a 2f 20 22 75 6e 6b 6e 6f 77 6e 20 6f     */ "unknown o
6bb0: 70 65 72 61 74 69 6f 6e 22 2c 0d 0a 20 20 20 20  peration",..    
6bc0: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 46 55      /* SQLITE_FU
6bd0: 4c 4c 20 20 20 20 20 20 20 20 2a 2f 20 22 64 61  LL        */ "da
6be0: 74 61 62 61 73 65 20 6f 72 20 64 69 73 6b 20 69  tabase or disk i
6bf0: 73 20 66 75 6c 6c 22 2c 0d 0a 20 20 20 20 20 20  s full",..      
6c00: 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 41 4e 54    /* SQLITE_CANT
6c10: 4f 50 45 4e 20 20 20 20 2a 2f 20 22 75 6e 61 62  OPEN    */ "unab
6c20: 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 61 62  le to open datab
6c30: 61 73 65 20 66 69 6c 65 22 2c 0d 0a 20 20 20 20  ase file",..    
6c40: 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52      /* SQLITE_PR
6c50: 4f 54 4f 43 4f 4c 20 20 20 20 2a 2f 20 22 6c 6f  OTOCOL    */ "lo
6c60: 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f 6c 22 2c  cking protocol",
6c70: 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c  ..        /* SQL
6c80: 49 54 45 5f 45 4d 50 54 59 20 20 20 20 20 20 20  ITE_EMPTY       
6c90: 2a 2f 20 22 74 61 62 6c 65 20 63 6f 6e 74 61 69  */ "table contai
6ca0: 6e 73 20 6e 6f 20 64 61 74 61 22 2c 0d 0a 20 20  ns no data",..  
6cb0: 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f        /* SQLITE_
6cc0: 53 43 48 45 4d 41 20 20 20 20 20 20 2a 2f 20 22  SCHEMA      */ "
6cd0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
6ce0: 68 61 73 20 63 68 61 6e 67 65 64 22 2c 0d 0a 20  has changed",.. 
6cf0: 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45         /* SQLITE
6d00: 5f 54 4f 4f 42 49 47 20 20 20 20 20 20 2a 2f 20  _TOOBIG      */ 
6d10: 22 73 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20  "string or blob 
6d20: 74 6f 6f 20 62 69 67 22 2c 0d 0a 20 20 20 20 20  too big",..     
6d30: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 43 4f 4e     /* SQLITE_CON
6d40: 53 54 52 41 49 4e 54 20 20 2a 2f 20 22 63 6f 6e  STRAINT  */ "con
6d50: 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 2c  straint failed",
6d60: 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c  ..        /* SQL
6d70: 49 54 45 5f 4d 49 53 4d 41 54 43 48 20 20 20 20  ITE_MISMATCH    
6d80: 2a 2f 20 22 64 61 74 61 74 79 70 65 20 6d 69 73  */ "datatype mis
6d90: 6d 61 74 63 68 22 2c 0d 0a 20 20 20 20 20 20 20  match",..       
6da0: 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 49 53 55 53   /* SQLITE_MISUS
6db0: 45 20 20 20 20 20 20 2a 2f 20 22 6c 69 62 72 61  E      */ "libra
6dc0: 72 79 20 72 6f 75 74 69 6e 65 20 63 61 6c 6c 65  ry routine calle
6dd0: 64 20 6f 75 74 20 6f 66 20 73 65 71 75 65 6e 63  d out of sequenc
6de0: 65 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20  e",..        /* 
6df0: 53 51 4c 49 54 45 5f 4e 4f 4c 46 53 20 20 20 20  SQLITE_NOLFS    
6e00: 20 20 20 2a 2f 20 22 6c 61 72 67 65 20 66 69 6c     */ "large fil
6e10: 65 20 73 75 70 70 6f 72 74 20 69 73 20 64 69 73  e support is dis
6e20: 61 62 6c 65 64 22 2c 0d 0a 20 20 20 20 20 20 20  abled",..       
6e30: 20 2f 2a 20 53 51 4c 49 54 45 5f 41 55 54 48 20   /* SQLITE_AUTH 
6e40: 20 20 20 20 20 20 20 2a 2f 20 22 61 75 74 68 6f         */ "autho
6e50: 72 69 7a 61 74 69 6f 6e 20 64 65 6e 69 65 64 22  rization denied"
6e60: 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20 53 51  ,..        /* SQ
6e70: 4c 49 54 45 5f 46 4f 52 4d 41 54 20 20 20 20 20  LITE_FORMAT     
6e80: 20 2a 2f 20 22 61 75 78 69 6c 69 61 72 79 20 64   */ "auxiliary d
6e90: 61 74 61 62 61 73 65 20 66 6f 72 6d 61 74 20 65  atabase format e
6ea0: 72 72 6f 72 22 2c 0d 0a 20 20 20 20 20 20 20 20  rror",..        
6eb0: 2f 2a 20 53 51 4c 49 54 45 5f 52 41 4e 47 45 20  /* SQLITE_RANGE 
6ec0: 20 20 20 20 20 20 2a 2f 20 22 62 69 6e 64 20 6f        */ "bind o
6ed0: 72 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 20 6f  r column index o
6ee0: 75 74 20 6f 66 20 72 61 6e 67 65 22 2c 0d 0a 20  ut of range",.. 
6ef0: 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 54 45         /* SQLITE
6f00: 5f 4e 4f 54 41 44 42 20 20 20 20 20 20 2a 2f 20  _NOTADB      */ 
6f10: 22 66 69 6c 65 20 69 73 20 65 6e 63 72 79 70 74  "file is encrypt
6f20: 65 64 20 6f 72 20 69 73 20 6e 6f 74 20 61 20 64  ed or is not a d
6f30: 61 74 61 62 61 73 65 22 2c 0d 0a 20 20 20 20 20  atabase",..     
6f40: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 54     /* SQLITE_NOT
6f50: 49 43 45 20 20 20 20 20 20 2a 2f 20 22 6e 6f 74  ICE      */ "not
6f60: 69 66 69 63 61 74 69 6f 6e 20 6d 65 73 73 61 67  ification messag
6f70: 65 22 2c 0d 0a 20 20 20 20 20 20 20 20 2f 2a 20  e",..        /* 
6f80: 53 51 4c 49 54 45 5f 57 41 52 4e 49 4e 47 20 20  SQLITE_WARNING  
6f90: 20 20 20 2a 2f 20 22 77 61 72 6e 69 6e 67 20 6d     */ "warning m
6fa0: 65 73 73 61 67 65 22 0d 0a 20 20 20 20 7d 3b 0d  essage"..    };.
6fb0: 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f  ...    /////////
6fc0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6fd0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6fe0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
6ff0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
7000: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
7010: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 2f 2f  //////....    //
7020: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
7030: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65   /// Returns the
7040: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66   error message f
7050: 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 65 64  or the specified
7060: 20 53 51 4c 69 74 65 20 72 65 74 75 72 6e 20 63   SQLite return c
7070: 6f 64 65 20 75 73 69 6e 67 0d 0a 20 20 20 20 2f  ode using..    /
7080: 2f 2f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20  // the internal 
7090: 73 74 61 74 69 63 20 6c 6f 6f 6b 75 70 20 74 61  static lookup ta
70a0: 62 6c 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ble...    /// </
70b0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
70c0: 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 72  / <param name="r
70d0: 63 22 3e 54 68 65 20 53 51 4c 69 74 65 20 72 65  c">The SQLite re
70e0: 74 75 72 6e 20 63 6f 64 65 2e 3c 2f 70 61 72 61  turn code.</para
70f0: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74  m>..    /// <ret
7100: 75 72 6e 73 3e 54 68 65 20 65 72 72 6f 72 20 6d  urns>The error m
7110: 65 73 73 61 67 65 20 6f 72 20 6e 75 6c 6c 20 69  essage or null i
7120: 66 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 20 66  f it cannot be f
7130: 6f 75 6e 64 2e 3c 2f 72 65 74 75 72 6e 73 3e 0d  ound.</returns>.
7140: 0a 20 20 20 20 70 72 6f 74 65 63 74 65 64 20 73  .    protected s
7150: 74 61 74 69 63 20 73 74 72 69 6e 67 20 46 61 6c  tatic string Fal
7160: 6c 62 61 63 6b 47 65 74 45 72 72 6f 72 53 74 72  lbackGetErrorStr
7170: 69 6e 67 28 53 51 4c 69 74 65 45 72 72 6f 72 43  ing(SQLiteErrorC
7180: 6f 64 65 20 72 63 29 0d 0a 20 20 20 20 7b 0d 0a  ode rc)..    {..
7190: 20 20 20 20 20 20 20 20 69 66 20 28 5f 65 72 72          if (_err
71a0: 6f 72 4d 65 73 73 61 67 65 73 20 3d 3d 20 6e 75  orMessages == nu
71b0: 6c 6c 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ll)..           
71c0: 20 72 65 74 75 72 6e 20 6e 75 6c 6c 3b 0d 0a 0d   return null;...
71d0: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69 6e 64  .        int ind
71e0: 65 78 20 3d 20 28 69 6e 74 29 72 63 3b 0d 0a 0d  ex = (int)rc;...
71f0: 0a 20 20 20 20 20 20 20 20 69 66 20 28 28 69 6e  .        if ((in
7200: 64 65 78 20 3c 20 30 29 20 7c 7c 20 28 69 6e 64  dex < 0) || (ind
7210: 65 78 20 3e 3d 20 5f 65 72 72 6f 72 4d 65 73 73  ex >= _errorMess
7220: 61 67 65 73 2e 4c 65 6e 67 74 68 29 29 0d 0a 20  ages.Length)).. 
7230: 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 78             index
7240: 20 3d 20 28 69 6e 74 29 53 51 4c 69 74 65 45 72   = (int)SQLiteEr
7250: 72 6f 72 43 6f 64 65 2e 45 72 72 6f 72 3b 20 2f  rorCode.Error; /
7260: 2a 20 4d 61 6b 65 20 69 6e 74 6f 20 67 65 6e 65  * Make into gene
7270: 72 69 63 20 65 72 72 6f 72 2e 20 2a 2f 0d 0a 0d  ric error. */...
7280: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
7290: 5f 65 72 72 6f 72 4d 65 73 73 61 67 65 73 5b 69  _errorMessages[i
72a0: 6e 64 65 78 5d 3b 0d 0a 20 20 20 20 7d 0d 0a 0d  ndex];..    }...
72b0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74  .    internal st
72c0: 61 74 69 63 20 73 74 72 69 6e 67 20 47 65 74 4c  atic string GetL
72d0: 61 73 74 45 72 72 6f 72 28 53 51 4c 69 74 65 43  astError(SQLiteC
72e0: 6f 6e 6e 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20  onnectionHandle 
72f0: 68 64 6c 2c 20 49 6e 74 50 74 72 20 64 62 29 0d  hdl, IntPtr db).
7300: 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20  .    {..        
7310: 69 66 20 28 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c  if ((hdl == null
7320: 29 20 7c 7c 20 28 64 62 20 3d 3d 20 49 6e 74 50  ) || (db == IntP
7330: 74 72 2e 5a 65 72 6f 29 29 0d 0a 20 20 20 20 20  tr.Zero))..     
7340: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 22 6e         return "n
7350: 75 6c 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f  ull connection o
7360: 72 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c  r database handl
7370: 65 22 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 73  e";....        s
7380: 74 72 69 6e 67 20 72 65 73 75 6c 74 20 3d 20 6e  tring result = n
7390: 75 6c 6c 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20  ull;....        
73a0: 74 72 79 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a  try..        {..
73b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 64              // d
73c0: 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20 20 20 20  o nothing...    
73d0: 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 66      }..        f
73e0: 69 6e 61 6c 6c 79 20 2f 2a 20 4e 4f 54 45 3a 20  inally /* NOTE: 
73f0: 54 68 72 65 61 64 2e 41 62 6f 72 74 28 29 20 70  Thread.Abort() p
7400: 72 6f 74 65 63 74 69 6f 6e 2e 20 2a 2f 0d 0a 20  rotection. */.. 
7410: 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 50 4c         {..#if PL
7420: 41 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52  ATFORM_COMPACTFR
7430: 41 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20  AMEWORK..       
7440: 20 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c 2e 73       lock (hdl.s
7450: 79 6e 63 52 6f 6f 74 29 0d 0a 23 65 6c 73 65 0d  yncRoot)..#else.
7460: 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63  .            loc
7470: 6b 20 28 68 64 6c 29 0d 0a 23 65 6e 64 69 66 0d  k (hdl)..#endif.
7480: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a  .            {..
7490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
74a0: 69 66 20 28 21 68 64 6c 2e 49 73 49 6e 76 61 6c  if (!hdl.IsInval
74b0: 69 64 20 26 26 20 21 68 64 6c 2e 49 73 43 6c 6f  id && !hdl.IsClo
74c0: 73 65 64 29 0d 0a 20 20 20 20 20 20 20 20 20 20  sed)..          
74d0: 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 53 51        {..#if !SQ
74e0: 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a 20  LITE_STANDARD.. 
74f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7500: 20 20 20 69 6e 74 20 6c 65 6e 20 3d 20 30 3b 0d     int len = 0;.
7510: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
7520: 20 20 20 20 20 72 65 73 75 6c 74 20 3d 20 55 54       result = UT
7530: 46 38 54 6f 53 74 72 69 6e 67 28 55 6e 73 61 66  F8ToString(Unsaf
7540: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73  eNativeMethods.s
7550: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 5f 69 6e  qlite3_errmsg_in
7560: 74 65 72 6f 70 28 64 62 2c 20 72 65 66 20 6c 65  terop(db, ref le
7570: 6e 29 2c 20 6c 65 6e 29 3b 0d 0a 23 65 6c 73 65  n), len);..#else
7580: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
7590: 20 20 20 20 20 20 72 65 73 75 6c 74 20 3d 20 55        result = U
75a0: 54 46 38 54 6f 53 74 72 69 6e 67 28 55 6e 73 61  TF8ToString(Unsa
75b0: 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e  feNativeMethods.
75c0: 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 64  sqlite3_errmsg(d
75d0: 62 29 2c 20 2d 31 29 3b 0d 0a 23 65 6e 64 69 66  b), -1);..#endif
75e0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
75f0: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20    }..           
7600: 20 20 20 20 20 65 6c 73 65 0d 0a 20 20 20 20 20       else..     
7610: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20             {..  
7620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7630: 20 20 72 65 73 75 6c 74 20 3d 20 22 63 6c 6f 73    result = "clos
7640: 65 64 20 6f 72 20 69 6e 76 61 6c 69 64 20 63 6f  ed or invalid co
7650: 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 22  nnection handle"
7660: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ;..             
7670: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20     }..          
7680: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a    }..        }..
7690: 20 20 20 20 20 20 20 20 47 43 2e 4b 65 65 70 41          GC.KeepA
76a0: 6c 69 76 65 28 68 64 6c 29 3b 0d 0a 20 20 20 20  live(hdl);..    
76b0: 20 20 20 20 72 65 74 75 72 6e 20 72 65 73 75 6c      return resul
76c0: 74 3b 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20  t;..    }....   
76d0: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63   internal static
76e0: 20 76 6f 69 64 20 46 69 6e 69 73 68 42 61 63 6b   void FinishBack
76f0: 75 70 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  up(SQLiteConnect
7700: 69 6f 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49  ionHandle hdl, I
7710: 6e 74 50 74 72 20 62 61 63 6b 75 70 29 0d 0a 20  ntPtr backup).. 
7720: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 69 66     {..        if
7730: 20 28 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20   ((hdl == null) 
7740: 7c 7c 20 28 62 61 63 6b 75 70 20 3d 3d 20 49 6e  || (backup == In
7750: 74 50 74 72 2e 5a 65 72 6f 29 29 20 72 65 74 75  tPtr.Zero)) retu
7760: 72 6e 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 74  rn;....        t
7770: 72 79 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20  ry..        {.. 
7780: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 64 6f             // do
7790: 20 6e 6f 74 68 69 6e 67 2e 0d 0a 20 20 20 20 20   nothing...     
77a0: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 66 69     }..        fi
77b0: 6e 61 6c 6c 79 20 2f 2a 20 4e 4f 54 45 3a 20 54  nally /* NOTE: T
77c0: 68 72 65 61 64 2e 41 62 6f 72 74 28 29 20 70 72  hread.Abort() pr
77d0: 6f 74 65 63 74 69 6f 6e 2e 20 2a 2f 0d 0a 20 20  otection. */..  
77e0: 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 50 4c 41        {..#if PLA
77f0: 54 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41  TFORM_COMPACTFRA
7800: 4d 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20  MEWORK..        
7810: 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c 2e 73 79      lock (hdl.sy
7820: 6e 63 52 6f 6f 74 29 0d 0a 23 65 6c 73 65 0d 0a  ncRoot)..#else..
7830: 20 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b              lock
7840: 20 28 68 64 6c 29 0d 0a 23 65 6e 64 69 66 0d 0a   (hdl)..#endif..
7850: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 23              {..#
7860: 69 66 20 21 53 51 4c 49 54 45 5f 53 54 41 4e 44  if !SQLITE_STAND
7870: 41 52 44 0d 0a 20 20 20 20 20 20 20 20 20 20 20  ARD..           
7880: 20 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72       SQLiteError
7890: 43 6f 64 65 20 6e 20 3d 20 55 6e 73 61 66 65 4e  Code n = UnsafeN
78a0: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c  ativeMethods.sql
78b0: 69 74 65 33 5f 62 61 63 6b 75 70 5f 66 69 6e 69  ite3_backup_fini
78c0: 73 68 5f 69 6e 74 65 72 6f 70 28 62 61 63 6b 75  sh_interop(backu
78d0: 70 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20  p);..#else..    
78e0: 20 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69              SQLi
78f0: 74 65 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20  teErrorCode n = 
7900: 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68  UnsafeNativeMeth
7910: 6f 64 73 2e 73 71 6c 69 74 65 33 5f 62 61 63 6b  ods.sqlite3_back
7920: 75 70 5f 66 69 6e 69 73 68 28 62 61 63 6b 75 70  up_finish(backup
7930: 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20  );..#endif..    
7940: 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28              if (
7950: 6e 20 21 3d 20 53 51 4c 69 74 65 45 72 72 6f 72  n != SQLiteError
7960: 43 6f 64 65 2e 4f 6b 29 20 74 68 72 6f 77 20 6e  Code.Ok) throw n
7970: 65 77 20 53 51 4c 69 74 65 45 78 63 65 70 74 69  ew SQLiteExcepti
7980: 6f 6e 28 6e 2c 20 6e 75 6c 6c 29 3b 0d 0a 20 20  on(n, null);..  
7990: 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20            }..   
79a0: 20 20 20 20 20 7d 0d 0a 20 20 20 20 7d 0d 0a 0d       }..    }...
79b0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74  .    internal st
79c0: 61 74 69 63 20 76 6f 69 64 20 46 69 6e 61 6c 69  atic void Finali
79d0: 7a 65 53 74 61 74 65 6d 65 6e 74 28 53 51 4c 69  zeStatement(SQLi
79e0: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48 61 6e 64  teConnectionHand
79f0: 6c 65 20 68 64 6c 2c 20 49 6e 74 50 74 72 20 73  le hdl, IntPtr s
7a00: 74 6d 74 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20  tmt)..    {..   
7a10: 20 20 20 20 20 69 66 20 28 28 68 64 6c 20 3d 3d       if ((hdl ==
7a20: 20 6e 75 6c 6c 29 20 7c 7c 20 28 73 74 6d 74 20   null) || (stmt 
7a30: 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 29  == IntPtr.Zero))
7a40: 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20 20   return;....    
7a50: 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20 20 20      try..       
7a60: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
7a70: 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d 0a  // do nothing...
7a80: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20          }..     
7a90: 20 20 20 66 69 6e 61 6c 6c 79 20 2f 2a 20 4e 4f     finally /* NO
7aa0: 54 45 3a 20 54 68 72 65 61 64 2e 41 62 6f 72 74  TE: Thread.Abort
7ab0: 28 29 20 70 72 6f 74 65 63 74 69 6f 6e 2e 20 2a  () protection. *
7ac0: 2f 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23 69  /..        {..#i
7ad0: 66 20 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50 41  f PLATFORM_COMPA
7ae0: 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20 20  CTFRAMEWORK..   
7af0: 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68           lock (h
7b00: 64 6c 2e 73 79 6e 63 52 6f 6f 74 29 0d 0a 23 65  dl.syncRoot)..#e
7b10: 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20 20  lse..           
7b20: 20 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 23 65 6e   lock (hdl)..#en
7b30: 64 69 66 0d 0a 20 20 20 20 20 20 20 20 20 20 20  dif..           
7b40: 20 7b 0d 0a 23 69 66 20 21 53 51 4c 49 54 45 5f   {..#if !SQLITE_
7b50: 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20 20  STANDARD..      
7b60: 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65            SQLite
7b70: 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e  ErrorCode n = Un
7b80: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
7b90: 73 2e 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69  s.sqlite3_finali
7ba0: 7a 65 5f 69 6e 74 65 72 6f 70 28 73 74 6d 74 29  ze_interop(stmt)
7bb0: 3b 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20  ;..#else..      
7bc0: 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65            SQLite
7bd0: 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e  ErrorCode n = Un
7be0: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
7bf0: 73 2e 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69  s.sqlite3_finali
7c00: 7a 65 28 73 74 6d 74 29 3b 0d 0a 23 65 6e 64 69  ze(stmt);..#endi
7c10: 66 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  f..             
7c20: 20 20 20 69 66 20 28 6e 20 21 3d 20 53 51 4c 69     if (n != SQLi
7c30: 74 65 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 29 20  teErrorCode.Ok) 
7c40: 74 68 72 6f 77 20 6e 65 77 20 53 51 4c 69 74 65  throw new SQLite
7c50: 45 78 63 65 70 74 69 6f 6e 28 6e 2c 20 6e 75 6c  Exception(n, nul
7c60: 6c 29 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20  l);..           
7c70: 20 7d 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20   }..        }.. 
7c80: 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e 74 65     }....    inte
7c90: 72 6e 61 6c 20 73 74 61 74 69 63 20 76 6f 69 64  rnal static void
7ca0: 20 43 6c 6f 73 65 43 6f 6e 6e 65 63 74 69 6f 6e   CloseConnection
7cb0: 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f  (SQLiteConnectio
7cc0: 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74  nHandle hdl, Int
7cd0: 50 74 72 20 64 62 29 0d 0a 20 20 20 20 7b 0d 0a  Ptr db)..    {..
7ce0: 20 20 20 20 20 20 20 20 69 66 20 28 28 68 64 6c          if ((hdl
7cf0: 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28 64 62   == null) || (db
7d00: 20 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29   == IntPtr.Zero)
7d10: 29 20 72 65 74 75 72 6e 3b 0d 0a 0d 0a 20 20 20  ) return;....   
7d20: 20 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20 20       try..      
7d30: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20    {..           
7d40: 20 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0d   // do nothing..
7d50: 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20  .        }..    
7d60: 20 20 20 20 66 69 6e 61 6c 6c 79 20 2f 2a 20 4e      finally /* N
7d70: 4f 54 45 3a 20 54 68 72 65 61 64 2e 41 62 6f 72  OTE: Thread.Abor
7d80: 74 28 29 20 70 72 6f 74 65 63 74 69 6f 6e 2e 20  t() protection. 
7d90: 2a 2f 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 23  */..        {..#
7da0: 69 66 20 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d 50  if PLATFORM_COMP
7db0: 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20 20  ACTFRAMEWORK..  
7dc0: 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28            lock (
7dd0: 68 64 6c 2e 73 79 6e 63 52 6f 6f 74 29 0d 0a 23  hdl.syncRoot)..#
7de0: 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20  else..          
7df0: 20 20 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 23 65    lock (hdl)..#e
7e00: 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 20 20  ndif..          
7e10: 20 20 7b 0d 0a 23 69 66 20 21 53 51 4c 49 54 45    {..#if !SQLITE
7e20: 5f 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20 20  _STANDARD..     
7e30: 20 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74             SQLit
7e40: 65 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55  eErrorCode n = U
7e50: 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f  nsafeNativeMetho
7e60: 64 73 2e 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65  ds.sqlite3_close
7e70: 5f 69 6e 74 65 72 6f 70 28 64 62 29 3b 0d 0a 23  _interop(db);..#
7e80: 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20  else..          
7e90: 20 20 20 20 20 20 52 65 73 65 74 43 6f 6e 6e 65        ResetConne
7ea0: 63 74 69 6f 6e 28 68 64 6c 2c 20 64 62 2c 20 66  ction(hdl, db, f
7eb0: 61 6c 73 65 29 3b 0d 0a 0d 0a 20 20 20 20 20 20  alse);....      
7ec0: 20 20 20 20 20 20 20 20 20 20 53 51 4c 69 74 65            SQLite
7ed0: 45 72 72 6f 72 43 6f 64 65 20 6e 20 3d 20 55 6e  ErrorCode n = Un
7ee0: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
7ef0: 73 2e 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28  s.sqlite3_close(
7f00: 64 62 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20  db);..#endif..  
7f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66                if
7f20: 20 28 6e 20 21 3d 20 53 51 4c 69 74 65 45 72 72   (n != SQLiteErr
7f30: 6f 72 43 6f 64 65 2e 4f 6b 29 20 74 68 72 6f 77  orCode.Ok) throw
7f40: 20 6e 65 77 20 53 51 4c 69 74 65 45 78 63 65 70   new SQLiteExcep
7f50: 74 69 6f 6e 28 6e 2c 20 47 65 74 4c 61 73 74 45  tion(n, GetLastE
7f60: 72 72 6f 72 28 68 64 6c 2c 20 64 62 29 29 3b 0d  rror(hdl, db));.
7f70: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a  .            }..
7f80: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 7d          }..    }
7f90: 0d 0a 0d 0a 23 69 66 20 21 49 4e 54 45 52 4f 50  ....#if !INTEROP
7fa0: 5f 4c 45 47 41 43 59 5f 43 4c 4f 53 45 0d 0a 20  _LEGACY_CLOSE.. 
7fb0: 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74     internal stat
7fc0: 69 63 20 76 6f 69 64 20 43 6c 6f 73 65 43 6f 6e  ic void CloseCon
7fd0: 6e 65 63 74 69 6f 6e 56 32 28 53 51 4c 69 74 65  nectionV2(SQLite
7fe0: 43 6f 6e 6e 65 63 74 69 6f 6e 48 61 6e 64 6c 65  ConnectionHandle
7ff0: 20 68 64 6c 2c 20 49 6e 74 50 74 72 20 64 62 29   hdl, IntPtr db)
8000: 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20  ..    {..       
8010: 20 69 66 20 28 28 68 64 6c 20 3d 3d 20 6e 75 6c   if ((hdl == nul
8020: 6c 29 20 7c 7c 20 28 64 62 20 3d 3d 20 49 6e 74  l) || (db == Int
8030: 50 74 72 2e 5a 65 72 6f 29 29 20 72 65 74 75 72  Ptr.Zero)) retur
8040: 6e 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 74 72  n;....        tr
8050: 79 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a 20 20  y..        {..  
8060: 20 20 20 20 20 20 20 20 20 20 2f 2f 20 64 6f 20            // do 
8070: 6e 6f 74 68 69 6e 67 2e 0d 0a 20 20 20 20 20 20  nothing...      
8080: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 66 69 6e    }..        fin
8090: 61 6c 6c 79 20 2f 2a 20 4e 4f 54 45 3a 20 54 68  ally /* NOTE: Th
80a0: 72 65 61 64 2e 41 62 6f 72 74 28 29 20 70 72 6f  read.Abort() pro
80b0: 74 65 63 74 69 6f 6e 2e 20 2a 2f 0d 0a 20 20 20  tection. */..   
80c0: 20 20 20 20 20 7b 0d 0a 23 69 66 20 50 4c 41 54       {..#if PLAT
80d0: 46 4f 52 4d 5f 43 4f 4d 50 41 43 54 46 52 41 4d  FORM_COMPACTFRAM
80e0: 45 57 4f 52 4b 0d 0a 20 20 20 20 20 20 20 20 20  EWORK..         
80f0: 20 20 20 6c 6f 63 6b 20 28 68 64 6c 2e 73 79 6e     lock (hdl.syn
8100: 63 52 6f 6f 74 29 0d 0a 23 65 6c 73 65 0d 0a 20  cRoot)..#else.. 
8110: 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20             lock 
8120: 28 68 64 6c 29 0d 0a 23 65 6e 64 69 66 0d 0a 20  (hdl)..#endif.. 
8130: 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 23 69             {..#i
8140: 66 20 21 53 51 4c 49 54 45 5f 53 54 41 4e 44 41  f !SQLITE_STANDA
8150: 52 44 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  RD..            
8160: 20 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43      SQLiteErrorC
8170: 6f 64 65 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61  ode n = UnsafeNa
8180: 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69  tiveMethods.sqli
8190: 74 65 33 5f 63 6c 6f 73 65 5f 69 6e 74 65 72 6f  te3_close_intero
81a0: 70 28 64 62 29 3b 0d 0a 23 65 6c 73 65 0d 0a 20  p(db);..#else.. 
81b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 52                 R
81c0: 65 73 65 74 43 6f 6e 6e 65 63 74 69 6f 6e 28 68  esetConnection(h
81d0: 64 6c 2c 20 64 62 2c 20 66 61 6c 73 65 29 3b 0d  dl, db, false);.
81e0: 0a 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ...             
81f0: 20 20 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f     SQLiteErrorCo
8200: 64 65 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74  de n = UnsafeNat
8210: 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74  iveMethods.sqlit
8220: 65 33 5f 63 6c 6f 73 65 5f 76 32 28 64 62 29 3b  e3_close_v2(db);
8230: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20 20  ..#endif..      
8240: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6e 20            if (n 
8250: 21 3d 20 53 51 4c 69 74 65 45 72 72 6f 72 43 6f  != SQLiteErrorCo
8260: 64 65 2e 4f 6b 29 20 74 68 72 6f 77 20 6e 65 77  de.Ok) throw new
8270: 20 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e   SQLiteException
8280: 28 6e 2c 20 47 65 74 4c 61 73 74 45 72 72 6f 72  (n, GetLastError
8290: 28 68 64 6c 2c 20 64 62 29 29 3b 0d 0a 20 20 20  (hdl, db));..   
82a0: 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20           }..    
82b0: 20 20 20 20 7d 0d 0a 20 20 20 20 7d 0d 0a 23 65      }..    }..#e
82c0: 6e 64 69 66 0d 0a 0d 0a 20 20 20 20 69 6e 74 65  ndif....    inte
82d0: 72 6e 61 6c 20 73 74 61 74 69 63 20 62 6f 6f 6c  rnal static bool
82e0: 20 52 65 73 65 74 43 6f 6e 6e 65 63 74 69 6f 6e   ResetConnection
82f0: 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f  (SQLiteConnectio
8300: 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74  nHandle hdl, Int
8310: 50 74 72 20 64 62 2c 20 62 6f 6f 6c 20 63 61 6e  Ptr db, bool can
8320: 54 68 72 6f 77 29 0d 0a 20 20 20 20 7b 0d 0a 20  Throw)..    {.. 
8330: 20 20 20 20 20 20 20 69 66 20 28 28 68 64 6c 20         if ((hdl 
8340: 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28 64 62 20  == null) || (db 
8350: 3d 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 29  == IntPtr.Zero))
8360: 20 72 65 74 75 72 6e 20 66 61 6c 73 65 3b 0d 0a   return false;..
8370: 0d 0a 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 72  ..        bool r
8380: 65 73 75 6c 74 20 3d 20 66 61 6c 73 65 3b 0d 0a  esult = false;..
8390: 0d 0a 20 20 20 20 20 20 20 20 74 72 79 0d 0a 20  ..        try.. 
83a0: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20         {..      
83b0: 20 20 20 20 20 20 2f 2f 20 64 6f 20 6e 6f 74 68        // do noth
83c0: 69 6e 67 2e 0d 0a 20 20 20 20 20 20 20 20 7d 0d  ing...        }.
83d0: 0a 20 20 20 20 20 20 20 20 66 69 6e 61 6c 6c 79  .        finally
83e0: 20 2f 2a 20 4e 4f 54 45 3a 20 54 68 72 65 61 64   /* NOTE: Thread
83f0: 2e 41 62 6f 72 74 28 29 20 70 72 6f 74 65 63 74  .Abort() protect
8400: 69 6f 6e 2e 20 2a 2f 0d 0a 20 20 20 20 20 20 20  ion. */..       
8410: 20 7b 0d 0a 23 69 66 20 50 4c 41 54 46 4f 52 4d   {..#if PLATFORM
8420: 5f 43 4f 4d 50 41 43 54 46 52 41 4d 45 57 4f 52  _COMPACTFRAMEWOR
8430: 4b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6c  K..            l
8440: 6f 63 6b 20 28 68 64 6c 2e 73 79 6e 63 52 6f 6f  ock (hdl.syncRoo
8450: 74 29 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20  t)..#else..     
8460: 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68 64 6c         lock (hdl
8470: 29 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20  )..#endif..     
8480: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20         {..      
8490: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 63 61            if (ca
84a0: 6e 54 68 72 6f 77 20 26 26 20 68 64 6c 2e 49 73  nThrow && hdl.Is
84b0: 49 6e 76 61 6c 69 64 29 0d 0a 20 20 20 20 20 20  Invalid)..      
84c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68                th
84d0: 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 4f  row new InvalidO
84e0: 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 6f  perationExceptio
84f0: 6e 28 22 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f  n("The connectio
8500: 6e 20 68 61 6e 64 6c 65 20 69 73 20 69 6e 76 61  n handle is inva
8510: 6c 69 64 2e 22 29 3b 0d 0a 0d 0a 20 20 20 20 20  lid.");....     
8520: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 63             if (c
8530: 61 6e 54 68 72 6f 77 20 26 26 20 68 64 6c 2e 49  anThrow && hdl.I
8540: 73 43 6c 6f 73 65 64 29 0d 0a 20 20 20 20 20 20  sClosed)..      
8550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68                th
8560: 72 6f 77 20 6e 65 77 20 49 6e 76 61 6c 69 64 4f  row new InvalidO
8570: 70 65 72 61 74 69 6f 6e 45 78 63 65 70 74 69 6f  perationExceptio
8580: 6e 28 22 54 68 65 20 63 6f 6e 6e 65 63 74 69 6f  n("The connectio
8590: 6e 20 68 61 6e 64 6c 65 20 69 73 20 63 6c 6f 73  n handle is clos
85a0: 65 64 2e 22 29 3b 0d 0a 0d 0a 20 20 20 20 20 20  ed.");....      
85b0: 20 20 20 20 20 20 20 20 20 20 69 66 20 28 21 68            if (!h
85c0: 64 6c 2e 49 73 49 6e 76 61 6c 69 64 20 26 26 20  dl.IsInvalid && 
85d0: 21 68 64 6c 2e 49 73 43 6c 6f 73 65 64 29 0d 0a  !hdl.IsClosed)..
85e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
85f0: 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  {..             
8600: 20 20 20 20 20 20 20 49 6e 74 50 74 72 20 73 74         IntPtr st
8610: 6d 74 20 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f  mt = IntPtr.Zero
8620: 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  ;..             
8630: 20 20 20 20 20 20 20 53 51 4c 69 74 65 45 72 72         SQLiteErr
8640: 6f 72 43 6f 64 65 20 6e 3b 0d 0a 0d 0a 20 20 20  orCode n;....   
8650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8660: 20 64 6f 0d 0a 20 20 20 20 20 20 20 20 20 20 20   do..           
8670: 20 20 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20           {..    
8680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8690: 20 20 20 20 73 74 6d 74 20 3d 20 55 6e 73 61 66      stmt = Unsaf
86a0: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73  eNativeMethods.s
86b0: 71 6c 69 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74  qlite3_next_stmt
86c0: 28 64 62 2c 20 73 74 6d 74 29 3b 0d 0a 20 20 20  (db, stmt);..   
86d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
86e0: 20 20 20 20 20 69 66 20 28 73 74 6d 74 20 21 3d       if (stmt !=
86f0: 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 0d 0a 20   IntPtr.Zero).. 
8700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8710: 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 53         {..#if !S
8720: 51 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a  QLITE_STANDARD..
8730: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8740: 20 20 20 20 20 20 20 20 20 20 20 20 6e 20 3d 20              n = 
8750: 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68  UnsafeNativeMeth
8760: 6f 64 73 2e 73 71 6c 69 74 65 33 5f 72 65 73 65  ods.sqlite3_rese
8770: 74 5f 69 6e 74 65 72 6f 70 28 73 74 6d 74 29 3b  t_interop(stmt);
8780: 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20  ..#else..       
8790: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
87a0: 20 20 20 20 20 6e 20 3d 20 55 6e 73 61 66 65 4e       n = UnsafeN
87b0: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c  ativeMethods.sql
87c0: 69 74 65 33 5f 72 65 73 65 74 28 73 74 6d 74 29  ite3_reset(stmt)
87d0: 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20  ;..#endif..     
87e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
87f0: 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20     }..          
8800: 20 20 20 20 20 20 20 20 20 20 7d 20 77 68 69 6c            } whil
8810: 65 20 28 73 74 6d 74 20 21 3d 20 49 6e 74 50 74  e (stmt != IntPt
8820: 72 2e 5a 65 72 6f 29 3b 0d 0a 0d 0a 20 20 20 20  r.Zero);....    
8830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8840: 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20  //..            
8850: 20 20 20 20 20 20 20 20 2f 2f 20 4e 4f 54 45 3a          // NOTE:
8860: 20 49 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f   Is a transactio
8870: 6e 20 4e 4f 54 20 70 65 6e 64 69 6e 67 20 6f 6e  n NOT pending on
8880: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3f   the connection?
8890: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
88a0: 20 20 20 20 20 20 2f 2f 0d 0a 20 20 20 20 20 20        //..      
88b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66                if
88c0: 20 28 49 73 41 75 74 6f 63 6f 6d 6d 69 74 28 68   (IsAutocommit(h
88d0: 64 6c 2c 20 64 62 29 29 0d 0a 20 20 20 20 20 20  dl, db))..      
88e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d                {.
88f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
8900: 20 20 20 20 20 20 20 20 20 72 65 73 75 6c 74 20           result 
8910: 3d 20 74 72 75 65 3b 0d 0a 20 20 20 20 20 20 20  = true;..       
8920: 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a               }..
8930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8940: 20 20 20 20 65 6c 73 65 0d 0a 20 20 20 20 20 20      else..      
8950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d                {.
8960: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
8970: 20 20 20 20 20 20 20 20 20 6e 20 3d 20 55 6e 73           n = Uns
8980: 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73  afeNativeMethods
8990: 2e 73 71 6c 69 74 65 33 5f 65 78 65 63 28 0d 0a  .sqlite3_exec(..
89a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
89b0: 20 20 20 20 20 20 20 20 20 20 20 20 64 62 2c 20              db, 
89c0: 54 6f 55 54 46 38 28 22 52 4f 4c 4c 42 41 43 4b  ToUTF8("ROLLBACK
89d0: 22 29 2c 20 49 6e 74 50 74 72 2e 5a 65 72 6f 2c  "), IntPtr.Zero,
89e0: 20 49 6e 74 50 74 72 2e 5a 65 72 6f 2c 0d 0a 20   IntPtr.Zero,.. 
89f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8a00: 20 20 20 20 20 20 20 20 20 20 20 72 65 66 20 73             ref s
8a10: 74 6d 74 29 3b 0d 0a 0d 0a 20 20 20 20 20 20 20  tmt);....       
8a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8a30: 20 69 66 20 28 6e 20 3d 3d 20 53 51 4c 69 74 65   if (n == SQLite
8a40: 45 72 72 6f 72 43 6f 64 65 2e 4f 6b 29 0d 0a 20  ErrorCode.Ok).. 
8a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8a60: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20         {..      
8a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8a80: 20 20 20 20 20 20 72 65 73 75 6c 74 20 3d 20 74        result = t
8a90: 72 75 65 3b 0d 0a 20 20 20 20 20 20 20 20 20 20  rue;..          
8aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d                }.
8ab0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
8ac0: 20 20 20 20 20 20 20 20 20 65 6c 73 65 20 69 66           else if
8ad0: 20 28 63 61 6e 54 68 72 6f 77 29 0d 0a 20 20 20   (canThrow)..   
8ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8af0: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20       {..        
8b00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8b10: 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 53 51      throw new SQ
8b20: 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 28 6e 2c  LiteException(n,
8b30: 20 47 65 74 4c 61 73 74 45 72 72 6f 72 28 68 64   GetLastError(hd
8b40: 6c 2c 20 64 62 29 29 3b 0d 0a 20 20 20 20 20 20  l, db));..      
8b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8b60: 20 20 7d 0d 0a 20 20 20 20 20 20 20 20 20 20 20    }..           
8b70: 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20           }..    
8b80: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20              }.. 
8b90: 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20             }..  
8ba0: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20        }..       
8bb0: 20 47 43 2e 4b 65 65 70 41 6c 69 76 65 28 68 64   GC.KeepAlive(hd
8bc0: 6c 29 3b 0d 0a 20 20 20 20 20 20 20 20 72 65 74  l);..        ret
8bd0: 75 72 6e 20 72 65 73 75 6c 74 3b 0d 0a 20 20 20  urn result;..   
8be0: 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e   }....    intern
8bf0: 61 6c 20 73 74 61 74 69 63 20 62 6f 6f 6c 20 49  al static bool I
8c00: 73 41 75 74 6f 63 6f 6d 6d 69 74 28 53 51 4c 69  sAutocommit(SQLi
8c10: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48 61 6e 64  teConnectionHand
8c20: 6c 65 20 68 64 6c 2c 20 49 6e 74 50 74 72 20 64  le hdl, IntPtr d
8c30: 62 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  b)..    {..     
8c40: 20 20 20 69 66 20 28 28 68 64 6c 20 3d 3d 20 6e     if ((hdl == n
8c50: 75 6c 6c 29 20 7c 7c 20 28 64 62 20 3d 3d 20 49  ull) || (db == I
8c60: 6e 74 50 74 72 2e 5a 65 72 6f 29 29 20 72 65 74  ntPtr.Zero)) ret
8c70: 75 72 6e 20 66 61 6c 73 65 3b 0d 0a 0d 0a 20 20  urn false;....  
8c80: 20 20 20 20 20 20 62 6f 6f 6c 20 72 65 73 75 6c        bool resul
8c90: 74 20 3d 20 66 61 6c 73 65 3b 0d 0a 0d 0a 20 20  t = false;....  
8ca0: 20 20 20 20 20 20 74 72 79 0d 0a 20 20 20 20 20        try..     
8cb0: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20     {..          
8cc0: 20 20 2f 2f 20 64 6f 20 6e 6f 74 68 69 6e 67 2e    // do nothing.
8cd0: 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20  ..        }..   
8ce0: 20 20 20 20 20 66 69 6e 61 6c 6c 79 20 2f 2a 20       finally /* 
8cf0: 4e 4f 54 45 3a 20 54 68 72 65 61 64 2e 41 62 6f  NOTE: Thread.Abo
8d00: 72 74 28 29 20 70 72 6f 74 65 63 74 69 6f 6e 2e  rt() protection.
8d10: 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a   */..        {..
8d20: 23 69 66 20 50 4c 41 54 46 4f 52 4d 5f 43 4f 4d  #if PLATFORM_COM
8d30: 50 41 43 54 46 52 41 4d 45 57 4f 52 4b 0d 0a 20  PACTFRAMEWORK.. 
8d40: 20 20 20 20 20 20 20 20 20 20 20 6c 6f 63 6b 20             lock 
8d50: 28 68 64 6c 2e 73 79 6e 63 52 6f 6f 74 29 0d 0a  (hdl.syncRoot)..
8d60: 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20  #else..         
8d70: 20 20 20 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 23     lock (hdl)..#
8d80: 65 6e 64 69 66 0d 0a 20 20 20 20 20 20 20 20 20  endif..         
8d90: 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20     {..          
8da0: 20 20 20 20 20 20 69 66 20 28 21 68 64 6c 2e 49        if (!hdl.I
8db0: 73 49 6e 76 61 6c 69 64 20 26 26 20 21 68 64 6c  sInvalid && !hdl
8dc0: 2e 49 73 43 6c 6f 73 65 64 29 0d 0a 20 20 20 20  .IsClosed)..    
8dd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8de0: 72 65 73 75 6c 74 20 3d 20 28 55 6e 73 61 66 65  result = (Unsafe
8df0: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71  NativeMethods.sq
8e00: 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 6f 63 6f  lite3_get_autoco
8e10: 6d 6d 69 74 28 64 62 29 20 3d 3d 20 31 29 3b 0d  mmit(db) == 1);.
8e20: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a  .            }..
8e30: 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20          }..     
8e40: 20 20 20 47 43 2e 4b 65 65 70 41 6c 69 76 65 28     GC.KeepAlive(
8e50: 68 64 6c 29 3b 20 2f 2a 20 4e 4f 54 45 3a 20 55  hdl); /* NOTE: U
8e60: 6e 72 65 61 63 68 61 62 6c 65 20 63 6f 64 65 2e  nreachable code.
8e70: 20 2a 2f 0d 0a 20 20 20 20 20 20 20 20 72 65 74   */..        ret
8e80: 75 72 6e 20 72 65 73 75 6c 74 3b 0d 0a 20 20 20  urn result;..   
8e90: 20 7d 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 2f 2f 2f   }..  }....  ///
8ea0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 2f 2f   <summary>..  //
8eb0: 2f 20 0d 0a 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  / ..  /// </summ
8ec0: 61 72 79 3e 0d 0a 20 20 70 75 62 6c 69 63 20 69  ary>..  public i
8ed0: 6e 74 65 72 66 61 63 65 20 49 53 51 4c 69 74 65  nterface ISQLite
8ee0: 53 63 68 65 6d 61 45 78 74 65 6e 73 69 6f 6e 73  SchemaExtensions
8ef0: 0d 0a 20 20 7b 0d 0a 20 20 20 20 20 20 2f 2f 2f  ..  {..      ///
8f00: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
8f10: 20 20 2f 2f 2f 20 43 72 65 61 74 65 73 20 74 65    /// Creates te
8f20: 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 73 20 6f  mporary tables o
8f30: 6e 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  n the connection
8f40: 20 73 6f 20 73 63 68 65 6d 61 20 69 6e 66 6f 72   so schema infor
8f50: 6d 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 71 75  mation can be qu
8f60: 65 72 69 65 64 2e 0d 0a 20 20 20 20 20 20 2f 2f  eried...      //
8f70: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
8f80: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
8f90: 61 6d 65 3d 22 63 6f 6e 6e 65 63 74 69 6f 6e 22  ame="connection"
8fa0: 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 54 68 65  >..      /// The
8fb0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 75 70 6f 6e   connection upon
8fc0: 20 77 68 69 63 68 20 74 6f 20 62 75 69 6c 64 20   which to build 
8fd0: 74 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65  the schema table
8fe0: 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f  s...      /// </
8ff0: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 20 20 76 6f  param>..      vo
9000: 69 64 20 42 75 69 6c 64 54 65 6d 70 53 63 68 65  id BuildTempSche
9010: 6d 61 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  ma(SQLiteConnect
9020: 69 6f 6e 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 3b  ion connection);
9030: 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 5b 46 6c 61 67  ..  }....  [Flag
9040: 73 5d 0d 0a 20 20 69 6e 74 65 72 6e 61 6c 20 65  s]..  internal e
9050: 6e 75 6d 20 53 51 4c 69 74 65 4f 70 65 6e 46 6c  num SQLiteOpenFl
9060: 61 67 73 45 6e 75 6d 0d 0a 20 20 7b 0d 0a 20 20  agsEnum..  {..  
9070: 20 20 4e 6f 6e 65 20 3d 20 30 2c 0d 0a 20 20 20    None = 0,..   
9080: 20 52 65 61 64 4f 6e 6c 79 20 3d 20 30 78 30 31   ReadOnly = 0x01
9090: 2c 0d 0a 20 20 20 20 52 65 61 64 57 72 69 74 65  ,..    ReadWrite
90a0: 20 3d 20 30 78 30 32 2c 0d 0a 20 20 20 20 43 72   = 0x02,..    Cr
90b0: 65 61 74 65 20 3d 20 30 78 30 34 2c 0d 0a 20 20  eate = 0x04,..  
90c0: 20 20 55 72 69 20 3d 20 30 78 34 30 2c 0d 0a 20    Uri = 0x40,.. 
90d0: 20 20 20 53 68 61 72 65 64 43 61 63 68 65 20 3d     SharedCache =
90e0: 20 30 78 30 31 30 30 30 30 30 30 2c 0d 0a 20 20   0x01000000,..  
90f0: 20 20 44 65 66 61 75 6c 74 20 3d 20 30 78 30 36    Default = 0x06
9100: 2c 0d 0a 20 20 7d 0d 0a 0d 0a 20 20 2f 2f 2f 20  ,..  }....  /// 
9110: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 2f 2f 2f  <summary>..  ///
9120: 20 54 68 65 20 65 78 74 72 61 20 62 65 68 61 76   The extra behav
9130: 69 6f 72 61 6c 20 66 6c 61 67 73 20 74 68 61 74  ioral flags that
9140: 20 63 61 6e 20 62 65 20 61 70 70 6c 69 65 64 20   can be applied 
9150: 74 6f 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  to a connection.
9160: 0d 0a 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72  ..  /// </summar
9170: 79 3e 0d 0a 20 20 5b 46 6c 61 67 73 28 29 5d 0d  y>..  [Flags()].
9180: 0a 20 20 70 75 62 6c 69 63 20 65 6e 75 6d 20 53  .  public enum S
9190: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46  QLiteConnectionF
91a0: 6c 61 67 73 0d 0a 20 20 7b 0d 0a 20 20 20 20 20  lags..  {..     
91b0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
91c0: 20 20 20 20 20 20 2f 2f 2f 20 4e 6f 20 65 78 74        /// No ext
91d0: 72 61 20 66 6c 61 67 73 2e 0d 0a 20 20 20 20 20  ra flags...     
91e0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
91f0: 0a 20 20 20 20 20 20 4e 6f 6e 65 20 3d 20 30 78  .      None = 0x
9200: 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  0,....      /// 
9210: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
9220: 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c 6f 67 67   /// Enable logg
9230: 69 6e 67 20 6f 66 20 61 6c 6c 20 53 51 4c 20 73  ing of all SQL s
9240: 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 62 65 20  tatements to be 
9250: 70 72 65 70 61 72 65 64 2e 0d 0a 20 20 20 20 20  prepared...     
9260: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
9270: 0a 20 20 20 20 20 20 4c 6f 67 50 72 65 70 61 72  .      LogPrepar
9280: 65 20 3d 20 30 78 31 2c 0d 0a 0d 0a 20 20 20 20  e = 0x1,....    
9290: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
92a0: 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c  .      /// Enabl
92b0: 65 20 6c 6f 67 67 69 6e 67 20 6f 66 20 61 6c 6c  e logging of all
92c0: 20 62 6f 75 6e 64 20 70 61 72 61 6d 65 74 65 72   bound parameter
92d0: 20 74 79 70 65 73 20 61 6e 64 20 72 61 77 20 76   types and raw v
92e0: 61 6c 75 65 73 2e 0d 0a 20 20 20 20 20 20 2f 2f  alues...      //
92f0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
9300: 20 20 20 20 4c 6f 67 50 72 65 42 69 6e 64 20 3d      LogPreBind =
9310: 20 30 78 32 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f   0x2,....      /
9320: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
9330: 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c      /// Enable l
9340: 6f 67 67 69 6e 67 20 6f 66 20 61 6c 6c 20 62 6f  ogging of all bo
9350: 75 6e 64 20 70 61 72 61 6d 65 74 65 72 20 73 74  und parameter st
9360: 72 6f 6e 67 6c 79 20 74 79 70 65 64 20 76 61 6c  rongly typed val
9370: 75 65 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ues...      /// 
9380: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
9390: 20 20 4c 6f 67 42 69 6e 64 20 3d 20 30 78 34 2c    LogBind = 0x4,
93a0: 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73  ....      /// <s
93b0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f  ummary>..      /
93c0: 2f 2f 20 45 6e 61 62 6c 65 20 6c 6f 67 67 69 6e  // Enable loggin
93d0: 67 20 6f 66 20 61 6c 6c 20 65 78 63 65 70 74 69  g of all excepti
93e0: 6f 6e 73 20 63 61 75 67 68 74 20 66 72 6f 6d 20  ons caught from 
93f0: 75 73 65 72 2d 70 72 6f 76 69 64 65 64 0d 0a 20  user-provided.. 
9400: 20 20 20 20 20 2f 2f 2f 20 6d 61 6e 61 67 65 64       /// managed
9410: 20 63 6f 64 65 20 63 61 6c 6c 65 64 20 66 72 6f   code called fro
9420: 6d 20 6e 61 74 69 76 65 20 63 6f 64 65 20 76 69  m native code vi
9430: 61 20 64 65 6c 65 67 61 74 65 73 2e 0d 0a 20 20  a delegates...  
9440: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
9450: 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 43 61 6c  y>..      LogCal
9460: 6c 62 61 63 6b 45 78 63 65 70 74 69 6f 6e 20 3d  lbackException =
9470: 20 30 78 38 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f   0x8,....      /
9480: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
9490: 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c      /// Enable l
94a0: 6f 67 67 69 6e 67 20 6f 66 20 62 61 63 6b 75 70  ogging of backup
94b0: 20 41 50 49 20 65 72 72 6f 72 73 2e 0d 0a 20 20   API errors...  
94c0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
94d0: 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 42 61 63  y>..      LogBac
94e0: 6b 75 70 20 3d 20 30 78 31 30 2c 0d 0a 0d 0a 20  kup = 0x10,.... 
94f0: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72       /// <summar
9500: 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 53 6b  y>..      /// Sk
9510: 69 70 20 61 64 64 69 6e 67 20 74 68 65 20 65 78  ip adding the ex
9520: 74 65 6e 73 69 6f 6e 20 66 75 6e 63 74 69 6f 6e  tension function
9530: 73 20 70 72 6f 76 69 64 65 64 20 62 79 20 74 68  s provided by th
9540: 65 20 6e 61 74 69 76 65 0d 0a 20 20 20 20 20 20  e native..      
9550: 2f 2f 2f 20 69 6e 74 65 72 6f 70 20 61 73 73 65  /// interop asse
9560: 6d 62 6c 79 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f  mbly...      ///
9570: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
9580: 20 20 20 4e 6f 45 78 74 65 6e 73 69 6f 6e 46 75     NoExtensionFu
9590: 6e 63 74 69 6f 6e 73 20 3d 20 30 78 32 30 2c 0d  nctions = 0x20,.
95a0: 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75  ...      /// <su
95b0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f  mmary>..      //
95c0: 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e 67 20 70  / When binding p
95d0: 61 72 61 6d 65 74 65 72 20 76 61 6c 75 65 73 20  arameter values 
95e0: 77 69 74 68 20 74 68 65 20 3c 73 65 65 20 63 72  with the <see cr
95f0: 65 66 3d 22 55 49 6e 74 33 32 22 20 2f 3e 0d 0a  ef="UInt32" />..
9600: 20 20 20 20 20 20 2f 2f 2f 20 74 79 70 65 2c 20        /// type, 
9610: 75 73 65 20 74 68 65 20 69 6e 74 65 72 6f 70 20  use the interop 
9620: 6d 65 74 68 6f 64 20 74 68 61 74 20 61 63 63 65  method that acce
9630: 70 74 73 20 61 6e 20 3c 73 65 65 20 63 72 65 66  pts an <see cref
9640: 3d 22 49 6e 74 36 34 22 20 2f 3e 0d 0a 20 20 20  ="Int64" />..   
9650: 20 20 20 2f 2f 2f 20 76 61 6c 75 65 2e 0d 0a 20     /// value... 
9660: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61       /// </summa
9670: 72 79 3e 0d 0a 20 20 20 20 20 20 42 69 6e 64 55  ry>..      BindU
9680: 49 6e 74 33 32 41 73 49 6e 74 36 34 20 3d 20 30  Int32AsInt64 = 0
9690: 78 34 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f  x40,....      //
96a0: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
96b0: 20 20 20 2f 2f 2f 20 57 68 65 6e 20 62 69 6e 64     /// When bind
96c0: 69 6e 67 20 70 61 72 61 6d 65 74 65 72 20 76 61  ing parameter va
96d0: 6c 75 65 73 2c 20 61 6c 77 61 79 73 20 62 69 6e  lues, always bin
96e0: 64 20 74 68 65 6d 20 61 73 20 74 68 6f 75 67 68  d them as though
96f0: 20 74 68 65 79 20 77 65 72 65 0d 0a 20 20 20 20   they were..    
9700: 20 20 2f 2f 2f 20 70 6c 61 69 6e 20 74 65 78 74    /// plain text
9710: 20 28 69 2e 65 2e 20 6e 6f 20 6e 75 6d 65 72 69   (i.e. no numeri
9720: 63 2c 20 64 61 74 65 2f 74 69 6d 65 2c 20 6f 72  c, date/time, or
9730: 20 6f 74 68 65 72 20 63 6f 6e 76 65 72 73 69 6f   other conversio
9740: 6e 73 20 73 68 6f 75 6c 64 0d 0a 20 20 20 20 20  ns should..     
9750: 20 2f 2f 2f 20 62 65 20 61 74 74 65 6d 70 74 65   /// be attempte
9760: 64 29 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  d)...      /// <
9770: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
9780: 20 42 69 6e 64 41 6c 6c 41 73 54 65 78 74 20 3d   BindAllAsText =
9790: 20 30 78 38 30 2c 0d 0a 0d 0a 20 20 20 20 20 20   0x80,....      
97a0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
97b0: 20 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 72 65       /// When re
97c0: 74 75 72 6e 69 6e 67 20 63 6f 6c 75 6d 6e 20 76  turning column v
97d0: 61 6c 75 65 73 2c 20 61 6c 77 61 79 73 20 72 65  alues, always re
97e0: 74 75 72 6e 20 74 68 65 6d 20 61 73 20 74 68 6f  turn them as tho
97f0: 75 67 68 20 74 68 65 79 20 77 65 72 65 0d 0a 20  ugh they were.. 
9800: 20 20 20 20 20 2f 2f 2f 20 70 6c 61 69 6e 20 74       /// plain t
9810: 65 78 74 20 28 69 2e 65 2e 20 6e 6f 20 6e 75 6d  ext (i.e. no num
9820: 65 72 69 63 2c 20 64 61 74 65 2f 74 69 6d 65 2c  eric, date/time,
9830: 20 6f 72 20 6f 74 68 65 72 20 63 6f 6e 76 65 72   or other conver
9840: 73 69 6f 6e 73 20 73 68 6f 75 6c 64 0d 0a 20 20  sions should..  
9850: 20 20 20 20 2f 2f 2f 20 62 65 20 61 74 74 65 6d      /// be attem
9860: 70 74 65 64 29 2e 0d 0a 20 20 20 20 20 20 2f 2f  pted)...      //
9870: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
9880: 20 20 20 20 47 65 74 41 6c 6c 41 73 54 65 78 74      GetAllAsText
9890: 20 3d 20 30 78 31 30 30 2c 0d 0a 0d 0a 20 20 20   = 0x100,....   
98a0: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
98b0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 50 72 65 76  ..      /// Prev
98c0: 65 6e 74 20 74 68 69 73 20 3c 73 65 65 20 63 72  ent this <see cr
98d0: 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e 6e 65 63  ef="SQLiteConnec
98e0: 74 69 6f 6e 22 20 2f 3e 20 6f 62 6a 65 63 74 20  tion" /> object 
98f0: 69 6e 73 74 61 6e 63 65 20 66 72 6f 6d 0d 0a 20  instance from.. 
9900: 20 20 20 20 20 2f 2f 2f 20 6c 6f 61 64 69 6e 67       /// loading
9910: 20 65 78 74 65 6e 73 69 6f 6e 73 2e 0d 0a 20 20   extensions...  
9920: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
9930: 79 3e 0d 0a 20 20 20 20 20 20 4e 6f 4c 6f 61 64  y>..      NoLoad
9940: 45 78 74 65 6e 73 69 6f 6e 20 3d 20 30 78 32 30  Extension = 0x20
9950: 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  0,....      /// 
9960: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
9970: 20 2f 2f 2f 20 50 72 65 76 65 6e 74 20 74 68 69   /// Prevent thi
9980: 73 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51 4c  s <see cref="SQL
9990: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 22 20 2f  iteConnection" /
99a0: 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e 63  > object instanc
99b0: 65 20 66 72 6f 6d 0d 0a 20 20 20 20 20 20 2f 2f  e from..      //
99c0: 2f 20 63 72 65 61 74 69 6e 67 20 76 69 72 74 75  / creating virtu
99d0: 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 6c 65 73  al table modules
99e0: 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73  ...      /// </s
99f0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4e  ummary>..      N
9a00: 6f 43 72 65 61 74 65 4d 6f 64 75 6c 65 20 3d 20  oCreateModule = 
9a10: 30 78 34 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20  0x400,....      
9a20: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
9a30: 20 20 20 20 20 2f 2f 2f 20 53 6b 69 70 20 62 69       /// Skip bi
9a40: 6e 64 69 6e 67 20 61 6e 79 20 66 75 6e 63 74 69  nding any functi
9a50: 6f 6e 73 20 70 72 6f 76 69 64 65 64 20 62 79 20  ons provided by 
9a60: 6f 74 68 65 72 20 6d 61 6e 61 67 65 64 20 61 73  other managed as
9a70: 73 65 6d 62 6c 69 65 73 20 77 68 65 6e 0d 0a 20  semblies when.. 
9a80: 20 20 20 20 20 2f 2f 2f 20 6f 70 65 6e 69 6e 67       /// opening
9a90: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e   the connection.
9aa0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  ..      /// </su
9ab0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4e 6f  mmary>..      No
9ac0: 42 69 6e 64 46 75 6e 63 74 69 6f 6e 73 20 3d 20  BindFunctions = 
9ad0: 30 78 38 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20  0x800,....      
9ae0: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
9af0: 20 20 20 20 20 2f 2f 2f 20 53 6b 69 70 20 73 65       /// Skip se
9b00: 74 74 69 6e 67 20 74 68 65 20 6c 6f 67 67 69 6e  tting the loggin
9b10: 67 20 72 65 6c 61 74 65 64 20 70 72 6f 70 65 72  g related proper
9b20: 74 69 65 73 20 6f 66 20 74 68 65 0d 0a 20 20 20  ties of the..   
9b30: 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66     /// <see cref
9b40: 3d 22 53 51 4c 69 74 65 4d 6f 64 75 6c 65 22 20  ="SQLiteModule" 
9b50: 2f 3e 20 6f 62 6a 65 63 74 20 69 6e 73 74 61 6e  /> object instan
9b60: 63 65 20 74 68 61 74 20 77 61 73 20 70 61 73 73  ce that was pass
9b70: 65 64 20 74 6f 0d 0a 20 20 20 20 20 20 2f 2f 2f  ed to..      ///
9b80: 20 74 68 65 20 3c 73 65 65 20 63 72 65 66 3d 22   the <see cref="
9b90: 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e  SQLiteConnection
9ba0: 2e 43 72 65 61 74 65 4d 6f 64 75 6c 65 22 20 2f  .CreateModule" /
9bb0: 3e 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20  > method...     
9bc0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
9bd0: 0a 20 20 20 20 20 20 4e 6f 4c 6f 67 4d 6f 64 75  .      NoLogModu
9be0: 6c 65 20 3d 20 30 78 31 30 30 30 2c 0d 0a 0d 0a  le = 0x1000,....
9bf0: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61        /// <summa
9c00: 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45  ry>..      /// E
9c10: 6e 61 62 6c 65 20 6c 6f 67 67 69 6e 67 20 6f 66  nable logging of
9c20: 20 61 6c 6c 20 76 69 72 74 75 61 6c 20 74 61 62   all virtual tab
9c30: 6c 65 20 6d 6f 64 75 6c 65 20 65 72 72 6f 72 73  le module errors
9c40: 20 73 65 65 6e 20 62 79 20 74 68 65 0d 0a 20 20   seen by the..  
9c50: 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65      /// <see cre
9c60: 66 3d 22 53 51 4c 69 74 65 4d 6f 64 75 6c 65 2e  f="SQLiteModule.
9c70: 53 65 74 54 61 62 6c 65 45 72 72 6f 72 28 49 6e  SetTableError(In
9c80: 74 50 74 72 2c 53 74 72 69 6e 67 29 22 20 2f 3e  tPtr,String)" />
9c90: 20 6d 65 74 68 6f 64 2e 0d 0a 20 20 20 20 20 20   method...      
9ca0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
9cb0: 20 20 20 20 20 20 4c 6f 67 4d 6f 64 75 6c 65 45        LogModuleE
9cc0: 72 72 6f 72 20 3d 20 30 78 32 30 30 30 2c 0d 0a  rror = 0x2000,..
9cd0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  ..      /// <sum
9ce0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f  mary>..      ///
9cf0: 20 45 6e 61 62 6c 65 20 6c 6f 67 67 69 6e 67 20   Enable logging 
9d00: 6f 66 20 63 65 72 74 61 69 6e 20 76 69 72 74 75  of certain virtu
9d10: 61 6c 20 74 61 62 6c 65 20 6d 6f 64 75 6c 65 20  al table module 
9d20: 65 78 63 65 70 74 69 6f 6e 73 20 74 68 61 74 20  exceptions that 
9d30: 63 61 6e 6e 6f 74 0d 0a 20 20 20 20 20 20 2f 2f  cannot..      //
9d40: 2f 20 62 65 20 65 61 73 69 6c 79 20 64 69 73 63  / be easily disc
9d50: 6f 76 65 72 65 64 20 76 69 61 20 6f 74 68 65 72  overed via other
9d60: 20 6d 65 61 6e 73 2e 0d 0a 20 20 20 20 20 20 2f   means...      /
9d70: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
9d80: 20 20 20 20 20 4c 6f 67 4d 6f 64 75 6c 65 45 78       LogModuleEx
9d90: 63 65 70 74 69 6f 6e 20 3d 20 30 78 34 30 30 30  ception = 0x4000
9da0: 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  ,....      /// <
9db0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20  summary>..      
9dc0: 2f 2f 2f 20 45 6e 61 62 6c 65 20 74 72 61 63 69  /// Enable traci
9dd0: 6e 67 20 6f 66 20 70 6f 74 65 6e 74 69 61 6c 6c  ng of potentiall
9de0: 79 20 69 6d 70 6f 72 74 61 6e 74 20 5b 6e 6f 6e  y important [non
9df0: 2d 66 61 74 61 6c 5d 20 65 72 72 6f 72 20 63 6f  -fatal] error co
9e00: 6e 64 69 74 69 6f 6e 73 0d 0a 20 20 20 20 20 20  nditions..      
9e10: 2f 2f 2f 20 74 68 61 74 20 63 61 6e 6e 6f 74 20  /// that cannot 
9e20: 62 65 20 65 61 73 69 6c 79 20 72 65 70 6f 72 74  be easily report
9e30: 65 64 20 74 68 72 6f 75 67 68 20 6f 74 68 65 72  ed through other
9e40: 20 6d 65 61 6e 73 2e 0d 0a 20 20 20 20 20 20 2f   means...      /
9e50: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
9e60: 20 20 20 20 20 54 72 61 63 65 57 61 72 6e 69 6e       TraceWarnin
9e70: 67 20 3d 20 30 78 38 30 30 30 2c 0d 0a 0d 0a 20  g = 0x8000,.... 
9e80: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72       /// <summar
9e90: 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 57 68  y>..      /// Wh
9ea0: 65 6e 20 62 69 6e 64 69 6e 67 20 70 61 72 61 6d  en binding param
9eb0: 65 74 65 72 20 76 61 6c 75 65 73 2c 20 61 6c 77  eter values, alw
9ec0: 61 79 73 20 75 73 65 20 74 68 65 20 69 6e 76 61  ays use the inva
9ed0: 72 69 61 6e 74 20 63 75 6c 74 75 72 65 20 77 68  riant culture wh
9ee0: 65 6e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 63 6f  en..      /// co
9ef0: 6e 76 65 72 74 69 6e 67 20 74 68 65 69 72 20 76  nverting their v
9f00: 61 6c 75 65 73 20 66 72 6f 6d 20 73 74 72 69 6e  alues from strin
9f10: 67 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  gs...      /// <
9f20: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
9f30: 20 43 6f 6e 76 65 72 74 49 6e 76 61 72 69 61 6e   ConvertInvarian
9f40: 74 54 65 78 74 20 3d 20 30 78 31 30 30 30 30 2c  tText = 0x10000,
9f50: 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73  ....      /// <s
9f60: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f  ummary>..      /
9f70: 2f 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e 67 20  // When binding 
9f80: 70 61 72 61 6d 65 74 65 72 20 76 61 6c 75 65 73  parameter values
9f90: 2c 20 61 6c 77 61 79 73 20 75 73 65 20 74 68 65  , always use the
9fa0: 20 69 6e 76 61 72 69 61 6e 74 20 63 75 6c 74 75   invariant cultu
9fb0: 72 65 20 77 68 65 6e 0d 0a 20 20 20 20 20 20 2f  re when..      /
9fc0: 2f 2f 20 63 6f 6e 76 65 72 74 69 6e 67 20 74 68  // converting th
9fd0: 65 69 72 20 76 61 6c 75 65 73 20 74 6f 20 73 74  eir values to st
9fe0: 72 69 6e 67 73 2e 0d 0a 20 20 20 20 20 20 2f 2f  rings...      //
9ff0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
a000: 20 20 20 20 42 69 6e 64 49 6e 76 61 72 69 61 6e      BindInvarian
a010: 74 54 65 78 74 20 3d 20 30 78 32 30 30 30 30 2c  tText = 0x20000,
a020: 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73  ....      /// <s
a030: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f  ummary>..      /
a040: 2f 2f 20 44 69 73 61 62 6c 65 20 75 73 69 6e 67  // Disable using
a050: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20   the connection 
a060: 70 6f 6f 6c 20 62 79 20 64 65 66 61 75 6c 74 2e  pool by default.
a070: 20 20 49 66 20 74 68 65 20 22 50 6f 6f 6c 69 6e    If the "Poolin
a080: 67 22 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 63 6f  g"..      /// co
a090: 6e 6e 65 63 74 69 6f 6e 20 73 74 72 69 6e 67 20  nnection string 
a0a0: 70 72 6f 70 65 72 74 79 20 69 73 20 73 70 65 63  property is spec
a0b0: 69 66 69 65 64 2c 20 69 74 73 20 76 61 6c 75 65  ified, its value
a0c0: 20 77 69 6c 6c 20 6f 76 65 72 72 69 64 65 0d 0a   will override..
a0d0: 20 20 20 20 20 20 2f 2f 2f 20 74 68 69 73 20 66        /// this f
a0e0: 6c 61 67 2e 20 20 54 68 65 20 70 72 65 63 69 73  lag.  The precis
a0f0: 65 20 6f 75 74 63 6f 6d 65 20 6f 66 20 63 6f 6d  e outcome of com
a100: 62 69 6e 69 6e 67 20 74 68 69 73 20 66 6c 61 67  bining this flag
a110: 20 77 69 74 68 20 74 68 65 0d 0a 20 20 20 20 20   with the..     
a120: 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22   /// <see cref="
a130: 55 73 65 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f  UseConnectionPoo
a140: 6c 22 20 2f 3e 20 66 6c 61 67 20 69 73 20 75 6e  l" /> flag is un
a150: 73 70 65 63 69 66 69 65 64 3b 20 68 6f 77 65 76  specified; howev
a160: 65 72 2c 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 6f  er,..      /// o
a170: 6e 65 20 6f 66 20 74 68 65 20 66 6c 61 67 73 20  ne of the flags 
a180: 77 69 6c 6c 20 62 65 20 69 6e 20 65 66 66 65 63  will be in effec
a190: 74 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f  t...      /// </
a1a0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20  summary>..      
a1b0: 4e 6f 43 6f 6e 6e 65 63 74 69 6f 6e 50 6f 6f 6c  NoConnectionPool
a1c0: 20 3d 20 30 78 34 30 30 30 30 2c 0d 0a 0d 0a 20   = 0x40000,.... 
a1d0: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72       /// <summar
a1e0: 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e  y>..      /// En
a1f0: 61 62 6c 65 20 75 73 69 6e 67 20 74 68 65 20 63  able using the c
a200: 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 6f 6c 20 62  onnection pool b
a210: 79 20 64 65 66 61 75 6c 74 2e 20 20 49 66 20 74  y default.  If t
a220: 68 65 20 22 50 6f 6f 6c 69 6e 67 22 0d 0a 20 20  he "Pooling"..  
a230: 20 20 20 20 2f 2f 2f 20 63 6f 6e 6e 65 63 74 69      /// connecti
a240: 6f 6e 20 73 74 72 69 6e 67 20 70 72 6f 70 65 72  on string proper
a250: 74 79 20 69 73 20 73 70 65 63 69 66 69 65 64 2c  ty is specified,
a260: 20 69 74 73 20 76 61 6c 75 65 20 77 69 6c 6c 20   its value will 
a270: 6f 76 65 72 72 69 64 65 0d 0a 20 20 20 20 20 20  override..      
a280: 2f 2f 2f 20 74 68 69 73 20 66 6c 61 67 2e 20 20  /// this flag.  
a290: 54 68 65 20 70 72 65 63 69 73 65 20 6f 75 74 63  The precise outc
a2a0: 6f 6d 65 20 6f 66 20 63 6f 6d 62 69 6e 69 6e 67  ome of combining
a2b0: 20 74 68 69 73 20 66 6c 61 67 20 77 69 74 68 20   this flag with 
a2c0: 74 68 65 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  the..      /// <
a2d0: 73 65 65 20 63 72 65 66 3d 22 4e 6f 43 6f 6e 6e  see cref="NoConn
a2e0: 65 63 74 69 6f 6e 50 6f 6f 6c 22 20 2f 3e 20 66  ectionPool" /> f
a2f0: 6c 61 67 20 69 73 20 75 6e 73 70 65 63 69 66 69  lag is unspecifi
a300: 65 64 3b 20 68 6f 77 65 76 65 72 2c 0d 0a 20 20  ed; however,..  
a310: 20 20 20 20 2f 2f 2f 20 6f 6e 65 20 6f 66 20 74      /// one of t
a320: 68 65 20 66 6c 61 67 73 20 77 69 6c 6c 20 62 65  he flags will be
a330: 20 69 6e 20 65 66 66 65 63 74 2e 0d 0a 20 20 20   in effect...   
a340: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
a350: 3e 0d 0a 20 20 20 20 20 20 55 73 65 43 6f 6e 6e  >..      UseConn
a360: 65 63 74 69 6f 6e 50 6f 6f 6c 20 3d 20 30 78 38  ectionPool = 0x8
a370: 30 30 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f  0000,....      /
a380: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
a390: 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 75      /// Enable u
a3a0: 73 69 6e 67 20 70 65 72 2d 63 6f 6e 6e 65 63 74  sing per-connect
a3b0: 69 6f 6e 20 6d 61 70 70 69 6e 67 73 20 62 65 74  ion mappings bet
a3c0: 77 65 65 6e 20 74 79 70 65 20 6e 61 6d 65 73 20  ween type names 
a3d0: 61 6e 64 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  and..      /// <
a3e0: 73 65 65 20 63 72 65 66 3d 22 44 62 54 79 70 65  see cref="DbType
a3f0: 22 20 2f 3e 20 76 61 6c 75 65 73 2e 20 20 41 6c  " /> values.  Al
a400: 73 6f 20 73 65 65 20 74 68 65 0d 0a 20 20 20 20  so see the..    
a410: 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d    /// <see cref=
a420: 22 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f  "SQLiteConnectio
a430: 6e 2e 43 6c 65 61 72 54 79 70 65 4d 61 70 70 69  n.ClearTypeMappi
a440: 6e 67 73 22 20 2f 3e 2c 0d 0a 20 20 20 20 20 20  ngs" />,..      
a450: 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 53  /// <see cref="S
a460: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 2e  QLiteConnection.
a470: 47 65 74 54 79 70 65 4d 61 70 70 69 6e 67 73 22  GetTypeMappings"
a480: 20 2f 3e 2c 20 61 6e 64 0d 0a 20 20 20 20 20 20   />, and..      
a490: 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 53  /// <see cref="S
a4a0: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 2e  QLiteConnection.
a4b0: 41 64 64 54 79 70 65 4d 61 70 70 69 6e 67 22 20  AddTypeMapping" 
a4c0: 2f 3e 20 6d 65 74 68 6f 64 73 2e 20 20 54 68 65  /> methods.  The
a4d0: 73 65 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 70 65  se..      /// pe
a4e0: 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 61 70  r-connection map
a4f0: 70 69 6e 67 73 2c 20 77 68 65 6e 20 70 72 65 73  pings, when pres
a500: 65 6e 74 2c 20 6f 76 65 72 72 69 64 65 20 74 68  ent, override th
a510: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0d  e corresponding.
a520: 0a 20 20 20 20 20 20 2f 2f 2f 20 67 6c 6f 62 61  .      /// globa
a530: 6c 20 6d 61 70 70 69 6e 67 73 2e 0d 0a 20 20 20  l mappings...   
a540: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
a550: 3e 0d 0a 20 20 20 20 20 20 55 73 65 43 6f 6e 6e  >..      UseConn
a560: 65 63 74 69 6f 6e 54 79 70 65 73 20 3d 20 30 78  ectionTypes = 0x
a570: 31 30 30 30 30 30 2c 0d 0a 0d 0a 20 20 20 20 20  100000,....     
a580: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
a590: 20 20 20 20 20 20 2f 2f 2f 20 44 69 73 61 62 6c        /// Disabl
a5a0: 65 20 75 73 69 6e 67 20 67 6c 6f 62 61 6c 20 6d  e using global m
a5b0: 61 70 70 69 6e 67 73 20 62 65 74 77 65 65 6e 20  appings between 
a5c0: 74 79 70 65 20 6e 61 6d 65 73 20 61 6e 64 0d 0a  type names and..
a5d0: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63        /// <see c
a5e0: 72 65 66 3d 22 44 62 54 79 70 65 22 20 2f 3e 20  ref="DbType" /> 
a5f0: 76 61 6c 75 65 73 2e 20 20 54 68 69 73 20 6d 61  values.  This ma
a600: 79 20 62 65 20 75 73 65 66 75 6c 20 69 6e 20 73  y be useful in s
a610: 6f 6d 65 20 76 65 72 79 20 6e 61 72 72 6f 77 0d  ome very narrow.
a620: 0a 20 20 20 20 20 20 2f 2f 2f 20 63 61 73 65 73  .      /// cases
a630: 3b 20 68 6f 77 65 76 65 72 2c 20 69 66 20 74 68  ; however, if th
a640: 65 72 65 20 61 72 65 20 6e 6f 20 70 65 72 2d 63  ere are no per-c
a650: 6f 6e 6e 65 63 74 69 6f 6e 20 74 79 70 65 20 6d  onnection type m
a660: 61 70 70 69 6e 67 73 2c 20 74 68 65 0d 0a 20 20  appings, the..  
a670: 20 20 20 20 2f 2f 2f 20 66 61 6c 6c 62 61 63 6b      /// fallback
a680: 20 64 65 66 61 75 6c 74 73 20 77 69 6c 6c 20 62   defaults will b
a690: 65 20 75 73 65 64 20 66 6f 72 20 62 6f 74 68 20  e used for both 
a6a0: 74 79 70 65 20 6e 61 6d 65 73 20 61 6e 64 20 74  type names and t
a6b0: 68 65 69 72 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  heir..      /// 
a6c0: 61 73 73 6f 63 69 61 74 65 64 20 3c 73 65 65 20  associated <see 
a6d0: 63 72 65 66 3d 22 44 62 54 79 70 65 22 20 2f 3e  cref="DbType" />
a6e0: 20 76 61 6c 75 65 73 2e 20 20 54 68 65 72 65 66   values.  Theref
a6f0: 6f 72 65 2c 20 75 73 65 20 6f 66 20 74 68 69 73  ore, use of this
a700: 20 66 6c 61 67 0d 0a 20 20 20 20 20 20 2f 2f 2f   flag..      ///
a710: 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e   is not recommen
a720: 64 65 64 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ded...      /// 
a730: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
a740: 20 20 4e 6f 47 6c 6f 62 61 6c 54 79 70 65 73 20    NoGlobalTypes 
a750: 3d 20 30 78 32 30 30 30 30 30 2c 0d 0a 0d 0a 20  = 0x200000,.... 
a760: 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72       /// <summar
a770: 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 57 68  y>..      /// Wh
a780: 65 6e 20 74 68 65 20 3c 73 65 65 20 63 72 65 66  en the <see cref
a790: 3d 22 53 51 4c 69 74 65 44 61 74 61 52 65 61 64  ="SQLiteDataRead
a7a0: 65 72 2e 48 61 73 52 6f 77 73 22 20 2f 3e 20 70  er.HasRows" /> p
a7b0: 72 6f 70 65 72 74 79 20 69 73 20 75 73 65 64 2c  roperty is used,
a7c0: 20 69 74 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 73   it..      /// s
a7d0: 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 6e 6f 6e  hould return non
a7e0: 2d 7a 65 72 6f 20 69 66 20 74 68 65 72 65 20 77  -zero if there w
a7f0: 65 72 65 20 65 76 65 72 20 61 6e 79 20 72 6f 77  ere ever any row
a800: 73 20 69 6e 20 74 68 65 20 61 73 73 6f 63 69 61  s in the associa
a810: 74 65 64 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 72  ted..      /// r
a820: 65 73 75 6c 74 20 73 65 74 73 2e 0d 0a 20 20 20  esult sets...   
a830: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
a840: 3e 0d 0a 20 20 20 20 20 20 53 74 69 63 6b 79 48  >..      StickyH
a850: 61 73 52 6f 77 73 20 3d 20 30 78 34 30 30 30 30  asRows = 0x40000
a860: 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  0,....      /// 
a870: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
a880: 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 22 73 74 72   /// Enable "str
a890: 69 63 74 22 20 74 72 61 6e 73 61 63 74 69 6f 6e  ict" transaction
a8a0: 20 65 6e 6c 69 73 74 6d 65 6e 74 20 73 65 6d 61   enlistment sema
a8b0: 6e 74 69 63 73 2e 20 20 53 65 74 74 69 6e 67 20  ntics.  Setting 
a8c0: 74 68 69 73 20 66 6c 61 67 0d 0a 20 20 20 20 20  this flag..     
a8d0: 20 2f 2f 2f 20 77 69 6c 6c 20 63 61 75 73 65 20   /// will cause 
a8e0: 61 6e 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20  an exception to 
a8f0: 62 65 20 74 68 72 6f 77 6e 20 69 66 20 61 6e 20  be thrown if an 
a900: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20  attempt is made 
a910: 74 6f 20 65 6e 6c 69 73 74 0d 0a 20 20 20 20 20  to enlist..     
a920: 20 2f 2f 2f 20 69 6e 20 61 20 74 72 61 6e 73 61   /// in a transa
a930: 63 74 69 6f 6e 20 77 69 74 68 20 61 6e 20 75 6e  ction with an un
a940: 61 76 61 69 6c 61 62 6c 65 20 6f 72 20 75 6e 73  available or uns
a950: 75 70 70 6f 72 74 65 64 20 69 73 6f 6c 61 74 69  upported isolati
a960: 6f 6e 20 6c 65 76 65 6c 2e 0d 0a 20 20 20 20 20  on level...     
a970: 20 2f 2f 2f 20 49 6e 20 74 68 65 20 66 75 74 75   /// In the futu
a980: 72 65 2c 20 6d 6f 72 65 20 65 78 74 65 6e 73 69  re, more extensi
a990: 76 65 20 63 68 65 63 6b 73 20 6d 61 79 20 62 65  ve checks may be
a9a0: 20 65 6e 61 62 6c 65 64 20 62 79 20 74 68 69 73   enabled by this
a9b0: 20 66 6c 61 67 20 61 73 0d 0a 20 20 20 20 20 20   flag as..      
a9c0: 2f 2f 2f 20 77 65 6c 6c 2e 0d 0a 20 20 20 20 20  /// well...     
a9d0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
a9e0: 0a 20 20 20 20 20 20 53 74 72 69 63 74 45 6e 6c  .      StrictEnl
a9f0: 69 73 74 6d 65 6e 74 20 3d 20 30 78 38 30 30 30  istment = 0x8000
aa00: 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f  00,....      ///
aa10: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
aa20: 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6d 61 70    /// Enable map
aa30: 70 69 6e 67 20 6f 66 20 75 6e 73 75 70 70 6f 72  ping of unsuppor
aa40: 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  ted transaction 
aa50: 69 73 6f 6c 61 74 69 6f 6e 20 6c 65 76 65 6c 73  isolation levels
aa60: 20 74 6f 20 74 68 65 0d 0a 20 20 20 20 20 20 2f   to the..      /
aa70: 2f 2f 20 63 6c 6f 73 65 73 74 20 73 75 70 70 6f  // closest suppo
aa80: 72 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e  rted transaction
aa90: 20 69 73 6f 6c 61 74 69 6f 6e 20 6c 65 76 65 6c   isolation level
aaa0: 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73  ...      /// </s
aab0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4d  ummary>..      M
aac0: 61 70 49 73 6f 6c 61 74 69 6f 6e 4c 65 76 65 6c  apIsolationLevel
aad0: 73 20 3d 20 30 78 31 30 30 30 30 30 30 2c 0d 0a  s = 0x1000000,..
aae0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  ..      /// <sum
aaf0: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f  mary>..      ///
ab00: 20 57 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 20   When returning 
ab10: 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 2c 20 61  column values, a
ab20: 74 74 65 6d 70 74 20 74 6f 20 64 65 74 65 63 74  ttempt to detect
ab30: 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66   the affinity of
ab40: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 74 65 78 74  ..      /// text
ab50: 75 61 6c 20 76 61 6c 75 65 73 20 62 79 20 63 68  ual values by ch
ab60: 65 63 6b 69 6e 67 20 69 66 20 74 68 65 79 20 66  ecking if they f
ab70: 75 6c 6c 79 20 63 6f 6e 66 6f 72 6d 20 74 6f 20  ully conform to 
ab80: 74 68 6f 73 65 20 6f 66 20 74 68 65 0d 0a 20 20  those of the..  
ab90: 20 20 20 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65      /// <see cre
aba0: 66 3d 22 54 79 70 65 41 66 66 69 6e 69 74 79 2e  f="TypeAffinity.
abb0: 4e 75 6c 6c 22 20 2f 3e 2c 0d 0a 20 20 20 20 20  Null" />,..     
abc0: 20 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22   /// <see cref="
abd0: 54 79 70 65 41 66 66 69 6e 69 74 79 2e 49 6e 74  TypeAffinity.Int
abe0: 36 34 22 20 2f 3e 2c 0d 0a 20 20 20 20 20 20 2f  64" />,..      /
abf0: 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 54 79  // <see cref="Ty
ac00: 70 65 41 66 66 69 6e 69 74 79 2e 44 6f 75 62 6c  peAffinity.Doubl
ac10: 65 22 20 2f 3e 2c 0d 0a 20 20 20 20 20 20 2f 2f  e" />,..      //
ac20: 2f 20 6f 72 20 3c 73 65 65 20 63 72 65 66 3d 22  / or <see cref="
ac30: 54 79 70 65 41 66 66 69 6e 69 74 79 2e 44 61 74  TypeAffinity.Dat
ac40: 65 54 69 6d 65 22 20 2f 3e 20 74 79 70 65 73 2e  eTime" /> types.
ac50: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  ..      /// </su
ac60: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 44 65  mmary>..      De
ac70: 74 65 63 74 54 65 78 74 41 66 66 69 6e 69 74 79  tectTextAffinity
ac80: 20 3d 20 30 78 32 30 30 30 30 30 30 2c 0d 0a 0d   = 0x2000000,...
ac90: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  .      /// <summ
aca0: 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ary>..      /// 
acb0: 57 68 65 6e 20 72 65 74 75 72 6e 69 6e 67 20 63  When returning c
acc0: 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 2c 20 61 74  olumn values, at
acd0: 74 65 6d 70 74 20 74 6f 20 64 65 74 65 63 74 20  tempt to detect 
ace0: 74 68 65 20 74 79 70 65 20 6f 66 0d 0a 20 20 20  the type of..   
acf0: 20 20 20 2f 2f 2f 20 73 74 72 69 6e 67 20 76 61     /// string va
ad00: 6c 75 65 73 20 62 79 20 63 68 65 63 6b 69 6e 67  lues by checking
ad10: 20 69 66 20 74 68 65 79 20 66 75 6c 6c 79 20 63   if they fully c
ad20: 6f 6e 66 6f 72 6d 20 74 6f 20 74 68 6f 73 65 20  onform to those 
ad30: 6f 66 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 74 68  of..      /// th
ad40: 65 20 3c 73 65 65 20 63 72 65 66 3d 22 54 79 70  e <see cref="Typ
ad50: 65 41 66 66 69 6e 69 74 79 2e 4e 75 6c 6c 22 20  eAffinity.Null" 
ad60: 2f 3e 2c 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  />,..      /// <
ad70: 73 65 65 20 63 72 65 66 3d 22 54 79 70 65 41 66  see cref="TypeAf
ad80: 66 69 6e 69 74 79 2e 49 6e 74 36 34 22 20 2f 3e  finity.Int64" />
ad90: 2c 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 65  ,..      /// <se
ada0: 65 20 63 72 65 66 3d 22 54 79 70 65 41 66 66 69  e cref="TypeAffi
adb0: 6e 69 74 79 2e 44 6f 75 62 6c 65 22 20 2f 3e 2c  nity.Double" />,
adc0: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 6f 72 20 3c  ..      /// or <
add0: 73 65 65 20 63 72 65 66 3d 22 54 79 70 65 41 66  see cref="TypeAf
ade0: 66 69 6e 69 74 79 2e 44 61 74 65 54 69 6d 65 22  finity.DateTime"
adf0: 20 2f 3e 20 74 79 70 65 73 2e 0d 0a 20 20 20 20   /> types...    
ae00: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
ae10: 0d 0a 20 20 20 20 20 20 44 65 74 65 63 74 53 74  ..      DetectSt
ae20: 72 69 6e 67 54 79 70 65 20 3d 20 30 78 34 30 30  ringType = 0x400
ae30: 30 30 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f  0000,....      /
ae40: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
ae50: 20 20 20 20 2f 2f 2f 20 53 6b 69 70 20 71 75 65      /// Skip que
ae60: 72 79 69 6e 67 20 72 75 6e 74 69 6d 65 20 63 6f  rying runtime co
ae70: 6e 66 69 67 75 72 61 74 69 6f 6e 20 73 65 74 74  nfiguration sett
ae80: 69 6e 67 73 20 66 6f 72 20 75 73 65 20 62 79 20  ings for use by 
ae90: 74 68 65 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  the..      /// <
aea0: 73 65 65 20 63 72 65 66 3d 22 53 51 4c 69 74 65  see cref="SQLite
aeb0: 43 6f 6e 76 65 72 74 22 20 2f 3e 20 63 6c 61 73  Convert" /> clas
aec0: 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65  s, including the
aed0: 20 64 65 66 61 75 6c 74 0d 0a 20 20 20 20 20 20   default..      
aee0: 2f 2f 2f 20 3c 73 65 65 20 63 72 65 66 3d 22 44  /// <see cref="D
aef0: 62 54 79 70 65 22 20 2f 3e 20 76 61 6c 75 65 20  bType" /> value 
af00: 61 6e 64 20 64 65 66 61 75 6c 74 20 64 61 74 61  and default data
af10: 62 61 73 65 20 74 79 70 65 20 6e 61 6d 65 2e 0d  base type name..
af20: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 62 3e 4e 4f  .      /// <b>NO
af30: 54 45 3a 20 49 66 20 74 68 65 20 3c 73 65 65 20  TE: If the <see 
af40: 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e 6e  cref="SQLiteConn
af50: 65 63 74 69 6f 6e 2e 44 65 66 61 75 6c 74 44 62  ection.DefaultDb
af60: 54 79 70 65 22 20 2f 3e 0d 0a 20 20 20 20 20 20  Type" />..      
af70: 2f 2f 2f 20 61 6e 64 2f 6f 72 20 3c 73 65 65 20  /// and/or <see 
af80: 63 72 65 66 3d 22 53 51 4c 69 74 65 43 6f 6e 6e  cref="SQLiteConn
af90: 65 63 74 69 6f 6e 2e 44 65 66 61 75 6c 74 54 79  ection.DefaultTy
afa0: 70 65 4e 61 6d 65 22 20 2f 3e 0d 0a 20 20 20 20  peName" />..    
afb0: 20 20 2f 2f 2f 20 70 72 6f 70 65 72 74 69 65 73    /// properties
afc0: 20 61 72 65 20 6e 6f 74 20 73 65 74 20 65 78 70   are not set exp
afd0: 6c 69 63 69 74 6c 79 20 6e 6f 72 20 73 65 74 20  licitly nor set 
afe0: 76 69 61 20 74 68 65 69 72 20 63 6f 6e 6e 65 63  via their connec
aff0: 74 69 6f 6e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  tion..      /// 
b000: 73 74 72 69 6e 67 20 70 72 6f 70 65 72 74 69 65  string propertie
b010: 73 20 61 6e 64 20 72 65 70 65 61 74 65 64 20 63  s and repeated c
b020: 61 6c 6c 73 20 74 6f 20 64 65 74 65 72 6d 69 6e  alls to determin
b030: 65 20 74 68 65 73 65 20 72 75 6e 74 69 6d 65 0d  e these runtime.
b040: 0a 20 20 20 20 20 20 2f 2f 2f 20 63 6f 6e 66 69  .      /// confi
b050: 67 75 72 61 74 69 6f 6e 20 73 65 74 74 69 6e 67  guration setting
b060: 73 20 61 72 65 20 73 65 65 6e 20 74 6f 20 62 65  s are seen to be
b070: 20 61 20 70 72 6f 62 6c 65 6d 2c 20 74 68 69 73   a problem, this
b080: 20 66 6c 61 67 0d 0a 20 20 20 20 20 20 2f 2f 2f   flag..      ///
b090: 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 2e 3c   should be set.<
b0a0: 2f 62 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  /b>..      /// <
b0b0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
b0c0: 20 4e 6f 43 6f 6e 76 65 72 74 53 65 74 74 69 6e   NoConvertSettin
b0d0: 67 73 20 3d 20 30 78 38 30 30 30 30 30 30 2c 0d  gs = 0x8000000,.
b0e0: 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75  ...      /// <su
b0f0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f  mmary>..      //
b100: 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e 67 20 70  / When binding p
b110: 61 72 61 6d 65 74 65 72 20 76 61 6c 75 65 73 20  arameter values 
b120: 77 69 74 68 20 74 68 65 20 3c 73 65 65 20 63 72  with the <see cr
b130: 65 66 3d 22 44 61 74 65 54 69 6d 65 22 20 2f 3e  ef="DateTime" />
b140: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 74 79 70 65  ..      /// type
b150: 2c 20 74 61 6b 65 20 74 68 65 69 72 20 3c 73 65  , take their <se
b160: 65 20 63 72 65 66 3d 22 44 61 74 65 54 69 6d 65  e cref="DateTime
b170: 4b 69 6e 64 22 20 2f 3e 20 69 6e 74 6f 20 61 63  Kind" /> into ac
b180: 63 6f 75 6e 74 20 61 73 0d 0a 20 20 20 20 20 20  count as..      
b190: 2f 2f 2f 20 77 65 6c 6c 20 61 73 20 74 68 61 74  /// well as that
b1a0: 20 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74   of the associat
b1b0: 65 64 20 3c 73 65 65 20 63 72 65 66 3d 22 53 51  ed <see cref="SQ
b1c0: 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 22 20  LiteConnection" 
b1d0: 2f 3e 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  />...      /// <
b1e0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  /summary>..     
b1f0: 20 42 69 6e 64 44 61 74 65 54 69 6d 65 57 69 74   BindDateTimeWit
b200: 68 4b 69 6e 64 20 3d 20 30 78 31 30 30 30 30 30  hKind = 0x100000
b210: 30 30 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f  00,....      ///
b220: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
b230: 20 20 2f 2f 2f 20 57 68 65 6e 20 62 69 6e 64 69    /// When bindi
b240: 6e 67 20 70 61 72 61 6d 65 74 65 72 20 76 61 6c  ng parameter val
b250: 75 65 73 20 6f 72 20 72 65 74 75 72 6e 69 6e 67  ues or returning
b260: 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 2c 20   column values, 
b270: 61 6c 77 61 79 73 0d 0a 20 20 20 20 20 20 2f 2f  always..      //
b280: 2f 20 74 72 65 61 74 20 74 68 65 6d 20 61 73 20  / treat them as 
b290: 74 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 65  though they were
b2a0: 20 70 6c 61 69 6e 20 74 65 78 74 20 28 69 2e 65   plain text (i.e
b2b0: 2e 20 6e 6f 20 6e 75 6d 65 72 69 63 2c 0d 0a 20  . no numeric,.. 
b2c0: 20 20 20 20 20 2f 2f 2f 20 64 61 74 65 2f 74 69       /// date/ti
b2d0: 6d 65 2c 20 6f 72 20 6f 74 68 65 72 20 63 6f 6e  me, or other con
b2e0: 76 65 72 73 69 6f 6e 73 20 73 68 6f 75 6c 64 20  versions should 
b2f0: 62 65 20 61 74 74 65 6d 70 74 65 64 29 2e 0d 0a  be attempted)...
b300: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
b310: 61 72 79 3e 0d 0a 20 20 20 20 20 20 42 69 6e 64  ary>..      Bind
b320: 41 6e 64 47 65 74 41 6c 6c 41 73 54 65 78 74 20  AndGetAllAsText 
b330: 3d 20 42 69 6e 64 41 6c 6c 41 73 54 65 78 74 20  = BindAllAsText 
b340: 7c 20 47 65 74 41 6c 6c 41 73 54 65 78 74 2c 0d  | GetAllAsText,.
b350: 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75  ...      /// <su
b360: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f  mmary>..      //
b370: 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e 67 20 70  / When binding p
b380: 61 72 61 6d 65 74 65 72 20 76 61 6c 75 65 73 2c  arameter values,
b390: 20 61 6c 77 61 79 73 20 75 73 65 20 74 68 65 20   always use the 
b3a0: 69 6e 76 61 72 69 61 6e 74 20 63 75 6c 74 75 72  invariant cultur
b3b0: 65 20 77 68 65 6e 0d 0a 20 20 20 20 20 20 2f 2f  e when..      //
b3c0: 2f 20 63 6f 6e 76 65 72 74 69 6e 67 20 74 68 65  / converting the
b3d0: 69 72 20 76 61 6c 75 65 73 20 74 6f 20 73 74 72  ir values to str
b3e0: 69 6e 67 73 20 6f 72 20 66 72 6f 6d 20 73 74 72  ings or from str
b3f0: 69 6e 67 73 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f  ings...      ///
b400: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
b410: 20 20 20 43 6f 6e 76 65 72 74 41 6e 64 42 69 6e     ConvertAndBin
b420: 64 49 6e 76 61 72 69 61 6e 74 54 65 78 74 20 3d  dInvariantText =
b430: 20 43 6f 6e 76 65 72 74 49 6e 76 61 72 69 61 6e   ConvertInvarian
b440: 74 54 65 78 74 20 7c 20 42 69 6e 64 49 6e 76 61  tText | BindInva
b450: 72 69 61 6e 74 54 65 78 74 2c 0d 0a 0d 0a 20 20  riantText,....  
b460: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
b470: 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 57 68 65  >..      /// Whe
b480: 6e 20 62 69 6e 64 69 6e 67 20 70 61 72 61 6d 65  n binding parame
b490: 74 65 72 20 76 61 6c 75 65 73 20 6f 72 20 72 65  ter values or re
b4a0: 74 75 72 6e 69 6e 67 20 63 6f 6c 75 6d 6e 20 76  turning column v
b4b0: 61 6c 75 65 73 2c 20 61 6c 77 61 79 73 0d 0a 20  alues, always.. 
b4c0: 20 20 20 20 20 2f 2f 2f 20 74 72 65 61 74 20 74       /// treat t
b4d0: 68 65 6d 20 61 73 20 74 68 6f 75 67 68 20 74 68  hem as though th
b4e0: 65 79 20 77 65 72 65 20 70 6c 61 69 6e 20 74 65  ey were plain te
b4f0: 78 74 20 28 69 2e 65 2e 20 6e 6f 20 6e 75 6d 65  xt (i.e. no nume
b500: 72 69 63 2c 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ric,..      /// 
b510: 64 61 74 65 2f 74 69 6d 65 2c 20 6f 72 20 6f 74  date/time, or ot
b520: 68 65 72 20 63 6f 6e 76 65 72 73 69 6f 6e 73 20  her conversions 
b530: 73 68 6f 75 6c 64 20 62 65 20 61 74 74 65 6d 70  should be attemp
b540: 74 65 64 29 20 61 6e 64 20 61 6c 77 61 79 73 0d  ted) and always.
b550: 0a 20 20 20 20 20 20 2f 2f 2f 20 75 73 65 20 74  .      /// use t
b560: 68 65 20 69 6e 76 61 72 69 61 6e 74 20 63 75 6c  he invariant cul
b570: 74 75 72 65 20 77 68 65 6e 20 63 6f 6e 76 65 72  ture when conver
b580: 74 69 6e 67 20 74 68 65 69 72 20 76 61 6c 75 65  ting their value
b590: 73 20 74 6f 20 73 74 72 69 6e 67 73 2e 0d 0a 20  s to strings... 
b5a0: 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61       /// </summa
b5b0: 72 79 3e 0d 0a 20 20 20 20 20 20 42 69 6e 64 41  ry>..      BindA
b5c0: 6e 64 47 65 74 41 6c 6c 41 73 49 6e 76 61 72 69  ndGetAllAsInvari
b5d0: 61 6e 74 54 65 78 74 20 3d 20 42 69 6e 64 41 6e  antText = BindAn
b5e0: 64 47 65 74 41 6c 6c 41 73 54 65 78 74 20 7c 20  dGetAllAsText | 
b5f0: 42 69 6e 64 49 6e 76 61 72 69 61 6e 74 54 65 78  BindInvariantTex
b600: 74 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  t,....      /// 
b610: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
b620: 20 2f 2f 2f 20 57 68 65 6e 20 62 69 6e 64 69 6e   /// When bindin
b630: 67 20 70 61 72 61 6d 65 74 65 72 20 76 61 6c 75  g parameter valu
b640: 65 73 20 6f 72 20 72 65 74 75 72 6e 69 6e 67 20  es or returning 
b650: 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 2c 20 61  column values, a
b660: 6c 77 61 79 73 0d 0a 20 20 20 20 20 20 2f 2f 2f  lways..      ///
b670: 20 74 72 65 61 74 20 74 68 65 6d 20 61 73 20 74   treat them as t
b680: 68 6f 75 67 68 20 74 68 65 79 20 77 65 72 65 20  hough they were 
b690: 70 6c 61 69 6e 20 74 65 78 74 20 28 69 2e 65 2e  plain text (i.e.
b6a0: 20 6e 6f 20 6e 75 6d 65 72 69 63 2c 0d 0a 20 20   no numeric,..  
b6b0: 20 20 20 20 2f 2f 2f 20 64 61 74 65 2f 74 69 6d      /// date/tim
b6c0: 65 2c 20 6f 72 20 6f 74 68 65 72 20 63 6f 6e 76  e, or other conv
b6d0: 65 72 73 69 6f 6e 73 20 73 68 6f 75 6c 64 20 62  ersions should b
b6e0: 65 20 61 74 74 65 6d 70 74 65 64 29 20 61 6e 64  e attempted) and
b6f0: 20 61 6c 77 61 79 73 0d 0a 20 20 20 20 20 20 2f   always..      /
b700: 2f 2f 20 75 73 65 20 74 68 65 20 69 6e 76 61 72  // use the invar
b710: 69 61 6e 74 20 63 75 6c 74 75 72 65 20 77 68 65  iant culture whe
b720: 6e 20 63 6f 6e 76 65 72 74 69 6e 67 20 74 68 65  n converting the
b730: 69 72 20 76 61 6c 75 65 73 20 74 6f 20 73 74 72  ir values to str
b740: 69 6e 67 73 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ings..      /// 
b750: 6f 72 20 66 72 6f 6d 20 73 74 72 69 6e 67 73 2e  or from strings.
b760: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  ..      /// </su
b770: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 43 6f  mmary>..      Co
b780: 6e 76 65 72 74 41 6e 64 42 69 6e 64 41 6e 64 47  nvertAndBindAndG
b790: 65 74 41 6c 6c 41 73 49 6e 76 61 72 69 61 6e 74  etAllAsInvariant
b7a0: 54 65 78 74 20 3d 20 42 69 6e 64 41 6e 64 47 65  Text = BindAndGe
b7b0: 74 41 6c 6c 41 73 54 65 78 74 20 7c 0d 0a 20 20  tAllAsText |..  
b7c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b7d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b7e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 43 6f 6e               Con
b7f0: 76 65 72 74 41 6e 64 42 69 6e 64 49 6e 76 61 72  vertAndBindInvar
b800: 69 61 6e 74 54 65 78 74 2c 0d 0a 0d 0a 20 20 20  iantText,....   
b810: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
b820: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61 62  ..      /// Enab
b830: 6c 65 20 61 6c 6c 20 6c 6f 67 67 69 6e 67 2e 0d  le all logging..
b840: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d  .      /// </sum
b850: 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67  mary>..      Log
b860: 41 6c 6c 20 3d 20 4c 6f 67 50 72 65 70 61 72 65  All = LogPrepare
b870: 20 7c 20 4c 6f 67 50 72 65 42 69 6e 64 20 7c 20   | LogPreBind | 
b880: 4c 6f 67 42 69 6e 64 20 7c 0d 0a 20 20 20 20 20  LogBind |..     
b890: 20 20 20 20 20 20 20 20 20 20 4c 6f 67 43 61 6c            LogCal
b8a0: 6c 62 61 63 6b 45 78 63 65 70 74 69 6f 6e 20 7c  lbackException |
b8b0: 20 4c 6f 67 42 61 63 6b 75 70 20 7c 20 4c 6f 67   LogBackup | Log
b8c0: 4d 6f 64 75 6c 65 45 72 72 6f 72 20 7c 0d 0a 20  ModuleError |.. 
b8d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4c 6f                Lo
b8e0: 67 4d 6f 64 75 6c 65 45 78 63 65 70 74 69 6f 6e  gModuleException
b8f0: 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c  ,....      /// <
b900: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20  summary>..      
b910: 2f 2f 2f 20 54 68 65 20 64 65 66 61 75 6c 74 20  /// The default 
b920: 65 78 74 72 61 20 66 6c 61 67 73 20 66 6f 72 20  extra flags for 
b930: 6e 65 77 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e  new connections.
b940: 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  ..      /// </su
b950: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 44 65  mmary>..      De
b960: 66 61 75 6c 74 20 3d 20 4c 6f 67 43 61 6c 6c 62  fault = LogCallb
b970: 61 63 6b 45 78 63 65 70 74 69 6f 6e 20 7c 20 4c  ackException | L
b980: 6f 67 4d 6f 64 75 6c 65 45 78 63 65 70 74 69 6f  ogModuleExceptio
b990: 6e 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  n,....      /// 
b9a0: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
b9b0: 20 2f 2f 2f 20 54 68 65 20 64 65 66 61 75 6c 74   /// The default
b9c0: 20 65 78 74 72 61 20 66 6c 61 67 73 20 66 6f 72   extra flags for
b9d0: 20 6e 65 77 20 63 6f 6e 6e 65 63 74 69 6f 6e 73   new connections
b9e0: 20 77 69 74 68 20 61 6c 6c 20 6c 6f 67 67 69 6e   with all loggin
b9f0: 67 20 65 6e 61 62 6c 65 64 2e 0d 0a 20 20 20 20  g enabled...    
ba00: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
ba10: 0d 0a 20 20 20 20 20 20 44 65 66 61 75 6c 74 41  ..      DefaultA
ba20: 6e 64 4c 6f 67 41 6c 6c 20 3d 20 44 65 66 61 75  ndLogAll = Defau
ba30: 6c 74 20 7c 20 4c 6f 67 41 6c 6c 0d 0a 20 20 7d  lt | LogAll..  }
ba40: 0d 0a 0d 0a 20 20 2f 2f 20 54 68 65 73 65 20 61  ....  // These a
ba50: 72 65 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 74  re the options t
ba60: 6f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73  o the internal s
ba70: 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 20 63 61  qlite3_config ca
ba80: 6c 6c 2e 0d 0a 20 20 69 6e 74 65 72 6e 61 6c 20  ll...  internal 
ba90: 65 6e 75 6d 20 53 51 4c 69 74 65 43 6f 6e 66 69  enum SQLiteConfi
baa0: 67 4f 70 73 45 6e 75 6d 0d 0a 20 20 7b 0d 0a 20  gOpsEnum..  {.. 
bab0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
bac0: 5f 4e 4f 4e 45 20 3d 20 30 2c 20 2f 2f 20 6e 69  _NONE = 0, // ni
bad0: 6c 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f  l..    SQLITE_CO
bae0: 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48 52 45 41  NFIG_SINGLETHREA
baf0: 44 20 3d 20 31 2c 20 2f 2f 20 6e 69 6c 0d 0a 20  D = 1, // nil.. 
bb00: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
bb10: 5f 4d 55 4c 54 49 54 48 52 45 41 44 20 3d 20 32  _MULTITHREAD = 2
bb20: 2c 20 2f 2f 20 6e 69 6c 0d 0a 20 20 20 20 53 51  , // nil..    SQ
bb30: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53 45 52 49  LITE_CONFIG_SERI
bb40: 41 4c 49 5a 45 44 20 3d 20 33 2c 20 2f 2f 20 6e  ALIZED = 3, // n
bb50: 69 6c 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43  il..    SQLITE_C
bb60: 4f 4e 46 49 47 5f 4d 41 4c 4c 4f 43 20 3d 20 34  ONFIG_MALLOC = 4
bb70: 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f 6d 65 6d  , // sqlite3_mem
bb80: 5f 6d 65 74 68 6f 64 73 2a 0d 0a 20 20 20 20 53  _methods*..    S
bb90: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54  QLITE_CONFIG_GET
bba0: 4d 41 4c 4c 4f 43 20 3d 20 35 2c 20 2f 2f 20 73  MALLOC = 5, // s
bbb0: 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f  qlite3_mem_metho
bbc0: 64 73 2a 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f  ds*..    SQLITE_
bbd0: 43 4f 4e 46 49 47 5f 53 43 52 41 54 43 48 20 3d  CONFIG_SCRATCH =
bbe0: 20 36 2c 20 2f 2f 20 76 6f 69 64 2a 2c 20 69 6e   6, // void*, in
bbf0: 74 20 73 7a 2c 20 69 6e 74 20 4e 0d 0a 20 20 20  t sz, int N..   
bc00: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 50   SQLITE_CONFIG_P
bc10: 41 47 45 43 41 43 48 45 20 3d 20 37 2c 20 2f 2f  AGECACHE = 7, //
bc20: 20 76 6f 69 64 2a 2c 20 69 6e 74 20 73 7a 2c 20   void*, int sz, 
bc30: 69 6e 74 20 4e 0d 0a 20 20 20 20 53 51 4c 49 54  int N..    SQLIT
bc40: 45 5f 43 4f 4e 46 49 47 5f 48 45 41 50 20 3d 20  E_CONFIG_HEAP = 
bc50: 38 2c 20 2f 2f 20 76 6f 69 64 2a 2c 20 69 6e 74  8, // void*, int
bc60: 20 6e 42 79 74 65 2c 20 69 6e 74 20 6d 69 6e 0d   nByte, int min.
bc70: 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46  .    SQLITE_CONF
bc80: 49 47 5f 4d 45 4d 53 54 41 54 55 53 20 3d 20 39  IG_MEMSTATUS = 9
bc90: 2c 20 2f 2f 20 62 6f 6f 6c 65 61 6e 0d 0a 20 20  , // boolean..  
bca0: 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f    SQLITE_CONFIG_
bcb0: 4d 55 54 45 58 20 3d 20 31 30 2c 20 2f 2f 20 73  MUTEX = 10, // s
bcc0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74  qlite3_mutex_met
bcd0: 68 6f 64 73 2a 0d 0a 20 20 20 20 53 51 4c 49 54  hods*..    SQLIT
bce0: 45 5f 43 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45  E_CONFIG_GETMUTE
bcf0: 58 20 3d 20 31 31 2c 20 2f 2f 20 73 71 6c 69 74  X = 11, // sqlit
bd00: 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73  e3_mutex_methods
bd10: 2a 0d 0a 20 20 20 20 2f 2f 20 70 72 65 76 69 6f  *..    // previo
bd20: 75 73 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46  usly SQLITE_CONF
bd30: 49 47 5f 43 48 55 4e 4b 41 4c 4c 4f 43 20 31 32  IG_CHUNKALLOC 12
bd40: 20 77 68 69 63 68 20 69 73 20 6e 6f 77 20 75 6e   which is now un
bd50: 75 73 65 64 0d 0a 20 20 20 20 53 51 4c 49 54 45  used..    SQLITE
bd60: 5f 43 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44  _CONFIG_LOOKASID
bd70: 45 20 3d 20 31 33 2c 20 2f 2f 20 69 6e 74 20 69  E = 13, // int i
bd80: 6e 74 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43  nt..    SQLITE_C
bd90: 4f 4e 46 49 47 5f 50 43 41 43 48 45 20 3d 20 31  ONFIG_PCACHE = 1
bda0: 34 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f 70 63  4, // sqlite3_pc
bdb0: 61 63 68 65 5f 6d 65 74 68 6f 64 73 2a 0d 0a 20  ache_methods*.. 
bdc0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
bdd0: 5f 47 45 54 50 43 41 43 48 45 20 3d 20 31 35 2c  _GETPCACHE = 15,
bde0: 20 2f 2f 20 73 71 6c 69 74 65 33 5f 70 63 61 63   // sqlite3_pcac
bdf0: 68 65 5f 6d 65 74 68 6f 64 73 2a 0d 0a 20 20 20  he_methods*..   
be00: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4c   SQLITE_CONFIG_L
be10: 4f 47 20 3d 20 31 36 2c 20 2f 2f 20 78 46 75 6e  OG = 16, // xFun
be20: 63 2c 20 76 6f 69 64 2a 0d 0a 20 20 20 20 53 51  c, void*..    SQ
be30: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 55 52 49 20  LITE_CONFIG_URI 
be40: 3d 20 31 37 2c 20 2f 2f 20 69 6e 74 0d 0a 20 20  = 17, // int..  
be50: 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f    SQLITE_CONFIG_
be60: 50 43 41 43 48 45 32 20 3d 20 31 38 2c 20 2f 2f  PCACHE2 = 18, //
be70: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
be80: 6d 65 74 68 6f 64 73 32 2a 0d 0a 20 20 20 20 53  methods2*..    S
be90: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 47 45 54  QLITE_CONFIG_GET
bea0: 50 43 41 43 48 45 32 20 3d 20 31 39 2c 20 2f 2f  PCACHE2 = 19, //
beb0: 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f   sqlite3_pcache_
bec0: 6d 65 74 68 6f 64 73 32 2a 0d 0a 20 20 20 20 53  methods2*..    S
bed0: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 43 4f 56  QLITE_CONFIG_COV
bee0: 45 52 49 4e 47 5f 49 4e 44 45 58 5f 53 43 41 4e  ERING_INDEX_SCAN
bef0: 20 3d 20 32 30 2c 20 2f 2f 20 69 6e 74 0d 0a 20   = 20, // int.. 
bf00: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
bf10: 5f 53 51 4c 4c 4f 47 20 3d 20 32 31 2c 20 2f 2f  _SQLLOG = 21, //
bf20: 20 78 53 71 6c 6c 6f 67 2c 20 76 6f 69 64 2a 0d   xSqllog, void*.
bf30: 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46  .    SQLITE_CONF
bf40: 49 47 5f 4d 4d 41 50 5f 53 49 5a 45 20 3d 20 32  IG_MMAP_SIZE = 2
bf50: 32 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f 69 6e  2, // sqlite3_in
bf60: 74 36 34 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74  t64, sqlite3_int
bf70: 36 34 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43  64..    SQLITE_C
bf80: 4f 4e 46 49 47 5f 57 49 4e 33 32 5f 48 45 41 50  ONFIG_WIN32_HEAP
bf90: 53 49 5a 45 20 3d 20 32 33 20 2f 2f 20 69 6e 74  SIZE = 23 // int
bfa0: 20 6e 42 79 74 65 0d 0a 20 20 7d 0d 0a 7d 0d 0a   nByte..  }..}..