System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact 22335a424939bf07e05a387432f8e2d254277d01:


0000: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  /***************
0010: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0020: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0030: 2a 2a 2a 2a 2a 2a 2a 2a 2a 0d 0a 20 2a 20 41 44  *********.. * AD
0040: 4f 2e 4e 45 54 20 32 2e 30 20 44 61 74 61 20 50  O.NET 2.0 Data P
0050: 72 6f 76 69 64 65 72 20 66 6f 72 20 53 51 4c 69  rovider for SQLi
0060: 74 65 20 56 65 72 73 69 6f 6e 20 33 2e 58 0d 0a  te Version 3.X..
0070: 20 2a 20 57 72 69 74 74 65 6e 20 62 79 20 52 6f   * Written by Ro
0080: 62 65 72 74 20 53 69 6d 70 73 6f 6e 20 28 72 6f  bert Simpson (ro
0090: 62 65 72 74 40 62 6c 61 63 6b 63 61 73 74 6c 65  bert@blackcastle
00a0: 73 6f 66 74 2e 63 6f 6d 29 0d 0a 20 2a 20 0d 0a  soft.com).. * ..
00b0: 20 2a 20 52 65 6c 65 61 73 65 64 20 74 6f 20 74   * Released to t
00c0: 68 65 20 70 75 62 6c 69 63 20 64 6f 6d 61 69 6e  he public domain
00d0: 2c 20 75 73 65 20 61 74 20 79 6f 75 72 20 6f 77  , use at your ow
00e0: 6e 20 72 69 73 6b 21 0d 0a 20 2a 2a 2a 2a 2a 2a  n risk!.. ******
00f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0100: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0110: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0120: 2a 2a 2f 0d 0a 0d 0a 6e 61 6d 65 73 70 61 63 65  **/....namespace
0130: 20 53 79 73 74 65 6d 2e 44 61 74 61 2e 53 51 4c   System.Data.SQL
0140: 69 74 65 0d 0a 7b 0d 0a 20 20 75 73 69 6e 67 20  ite..{..  using 
0150: 53 79 73 74 65 6d 3b 0d 0a 0d 0a 20 20 2f 2f 2f  System;....  ///
0160: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 2f 2f   <summary>..  //
0170: 2f 20 54 68 69 73 20 69 6e 74 65 72 6e 61 6c 20  / This internal 
0180: 63 6c 61 73 73 20 70 72 6f 76 69 64 65 73 20 74  class provides t
0190: 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e 20 6f 66  he foundation of
01a0: 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72 74 2e   SQLite support.
01b0: 20 20 49 74 20 64 65 66 69 6e 65 73 20 61 6c 6c    It defines all
01c0: 20 74 68 65 20 61 62 73 74 72 61 63 74 20 6d 65   the abstract me
01d0: 6d 62 65 72 73 20 6e 65 65 64 65 64 20 74 6f 20  mbers needed to 
01e0: 69 6d 70 6c 65 6d 65 6e 74 0d 0a 20 20 2f 2f 2f  implement..  ///
01f0: 20 61 20 53 51 4c 69 74 65 20 64 61 74 61 20 70   a SQLite data p
0200: 72 6f 76 69 64 65 72 2c 20 61 6e 64 20 69 6e 68  rovider, and inh
0210: 65 72 69 74 73 20 66 72 6f 6d 20 53 51 4c 69 74  erits from SQLit
0220: 65 43 6f 6e 76 65 72 74 20 77 68 69 63 68 20 61  eConvert which a
0230: 6c 6c 6f 77 73 20 66 6f 72 20 73 69 6d 70 6c 65  llows for simple
0240: 20 74 72 61 6e 73 6c 61 74 69 6f 6e 73 20 6f 66   translations of
0250: 20 73 74 72 69 6e 67 20 74 6f 20 61 6e 64 20 66   string to and f
0260: 72 6f 6d 20 53 51 4c 69 74 65 2e 0d 0a 20 20 2f  rom SQLite...  /
0270: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
0280: 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61   internal abstra
0290: 63 74 20 63 6c 61 73 73 20 53 51 4c 69 74 65 42  ct class SQLiteB
02a0: 61 73 65 20 3a 20 53 51 4c 69 74 65 43 6f 6e 76  ase : SQLiteConv
02b0: 65 72 74 2c 20 49 44 69 73 70 6f 73 61 62 6c 65  ert, IDisposable
02c0: 0d 0a 20 20 7b 0d 0a 20 20 20 20 69 6e 74 65 72  ..  {..    inter
02d0: 6e 61 6c 20 53 51 4c 69 74 65 42 61 73 65 28 53  nal SQLiteBase(S
02e0: 51 4c 69 74 65 44 61 74 65 46 6f 72 6d 61 74 73  QLiteDateFormats
02f0: 20 66 6d 74 2c 20 44 61 74 65 54 69 6d 65 4b 69   fmt, DateTimeKi
0300: 6e 64 20 6b 69 6e 64 29 0d 0a 20 20 20 20 20 20  nd kind)..      
0310: 3a 20 62 61 73 65 28 66 6d 74 2c 20 6b 69 6e 64  : base(fmt, kind
0320: 29 20 7b 20 7d 0d 0a 0d 0a 20 20 20 20 2f 2f 2f  ) { }....    ///
0330: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
0340: 2f 2f 2f 20 52 65 74 75 72 6e 73 20 61 20 73 74  /// Returns a st
0350: 72 69 6e 67 20 72 65 70 72 65 73 65 6e 74 69 6e  ring representin
0360: 67 20 74 68 65 20 61 63 74 69 76 65 20 76 65 72  g the active ver
0370: 73 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65 0d 0a  sion of SQLite..
0380: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
0390: 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  y>..    internal
03a0: 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e 67   abstract string
03b0: 20 56 65 72 73 69 6f 6e 20 7b 20 67 65 74 3b 20   Version { get; 
03c0: 7d 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  }..    /// <summ
03d0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
03e0: 74 75 72 6e 73 20 74 68 65 20 72 6f 77 69 64 20  turns the rowid 
03f0: 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65  of the most rece
0400: 6e 74 20 73 75 63 63 65 73 73 66 75 6c 20 49 4e  nt successful IN
0410: 53 45 52 54 20 69 6e 74 6f 20 74 68 65 20 64 61  SERT into the da
0420: 74 61 62 61 73 65 20 66 72 6f 6d 20 74 68 69 73  tabase from this
0430: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0d 0a 20 20   connection...  
0440: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
0450: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
0460: 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 4c 61 73  bstract long Las
0470: 74 49 6e 73 65 72 74 52 6f 77 49 64 20 7b 20 67  tInsertRowId { g
0480: 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f 2f 20 3c  et; }..    /// <
0490: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
04a0: 2f 20 52 65 74 75 72 6e 73 20 74 68 65 20 6e 75  / Returns the nu
04b0: 6d 62 65 72 20 6f 66 20 63 68 61 6e 67 65 73 20  mber of changes 
04c0: 74 68 65 20 6c 61 73 74 20 65 78 65 63 75 74 69  the last executi
04d0: 6e 67 20 69 6e 73 65 72 74 2f 75 70 64 61 74 65  ng insert/update
04e0: 20 63 61 75 73 65 64 2e 0d 0a 20 20 20 20 2f 2f   caused...    //
04f0: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
0500: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
0510: 61 63 74 20 69 6e 74 20 43 68 61 6e 67 65 73 20  act int Changes 
0520: 7b 20 67 65 74 3b 20 7d 0d 0a 20 20 20 20 2f 2f  { get; }..    //
0530: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
0540: 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65   /// Returns the
0550: 20 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72   amount of memor
0560: 79 20 28 69 6e 20 62 79 74 65 73 29 20 63 75 72  y (in bytes) cur
0570: 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 62 79  rently in use by
0580: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65   the SQLite core
0590: 20 6c 69 62 72 61 72 79 2e 20 20 54 68 69 73 20   library.  This 
05a0: 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 61 20  is not really a 
05b0: 70 65 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 0d 0a  per-connection..
05c0: 20 20 20 20 2f 2f 2f 20 76 61 6c 75 65 2c 20 69      /// value, i
05d0: 74 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f 20 74  t is global to t
05e0: 68 65 20 70 72 6f 63 65 73 73 2e 0d 0a 20 20 20  he process...   
05f0: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
0600: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
0610: 73 74 72 61 63 74 20 6c 6f 6e 67 20 4d 65 6d 6f  stract long Memo
0620: 72 79 55 73 65 64 20 7b 20 67 65 74 3b 20 7d 0d  ryUsed { get; }.
0630: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
0640: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74 75  y>..    /// Retu
0650: 72 6e 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  rns the maximum 
0660: 61 6d 6f 75 6e 74 20 6f 66 20 6d 65 6d 6f 72 79  amount of memory
0670: 20 28 69 6e 20 62 79 74 65 73 29 20 75 73 65 64   (in bytes) used
0680: 20 62 79 20 74 68 65 20 53 51 4c 69 74 65 20 63   by the SQLite c
0690: 6f 72 65 20 6c 69 62 72 61 72 79 20 73 69 6e 63  ore library sinc
06a0: 65 20 74 68 65 20 68 69 67 68 2d 77 61 74 65 72  e the high-water
06b0: 20 6d 61 72 6b 20 77 61 73 20 6c 61 73 74 20 72   mark was last r
06c0: 65 73 65 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20 54  eset...    /// T
06d0: 68 69 73 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c  his is not reall
06e0: 79 20 61 20 70 65 72 2d 63 6f 6e 6e 65 63 74 69  y a per-connecti
06f0: 6f 6e 20 76 61 6c 75 65 2c 20 69 74 20 69 73 20  on value, it is 
0700: 67 6c 6f 62 61 6c 20 74 6f 20 74 68 65 20 70 72  global to the pr
0710: 6f 63 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20  ocess...    /// 
0720: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
0730: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
0740: 74 20 6c 6f 6e 67 20 4d 65 6d 6f 72 79 48 69 67  t long MemoryHig
0750: 68 77 61 74 65 72 20 7b 20 67 65 74 3b 20 7d 0d  hwater { get; }.
0760: 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72  .    /// <summar
0770: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53 65 74 73  y>..    /// Sets
0780: 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 74   the status of t
0790: 68 65 20 6d 65 6d 6f 72 79 20 75 73 61 67 65 20  he memory usage 
07a0: 74 72 61 63 6b 69 6e 67 20 73 75 62 73 79 73 74  tracking subsyst
07b0: 65 6d 20 69 6e 20 74 68 65 20 53 51 4c 69 74 65  em in the SQLite
07c0: 20 63 6f 72 65 20 6c 69 62 72 61 72 79 2e 20 20   core library.  
07d0: 42 79 20 64 65 66 61 75 6c 74 2c 20 74 68 69 73  By default, this
07e0: 20 69 73 20 65 6e 61 62 6c 65 64 2e 0d 0a 20 20   is enabled...  
07f0: 20 20 2f 2f 2f 20 49 66 20 74 68 69 73 20 69 73    /// If this is
0800: 20 64 69 73 61 62 6c 65 64 2c 20 6d 65 6d 6f 72   disabled, memor
0810: 79 20 75 73 61 67 65 20 74 72 61 63 6b 69 6e 67  y usage tracking
0820: 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 65 72   will not be per
0830: 66 6f 72 6d 65 64 2e 20 20 54 68 69 73 20 69 73  formed.  This is
0840: 20 6e 6f 74 20 72 65 61 6c 6c 79 20 61 20 70 65   not really a pe
0850: 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 76 61 6c  r-connection val
0860: 75 65 2c 20 69 74 20 69 73 0d 0a 20 20 20 20 2f  ue, it is..    /
0870: 2f 2f 20 67 6c 6f 62 61 6c 20 74 6f 20 74 68 65  // global to the
0880: 20 70 72 6f 63 65 73 73 2e 0d 0a 20 20 20 20 2f   process...    /
0890: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
08a0: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61     /// <param na
08b0: 6d 65 3d 22 76 61 6c 75 65 22 3e 4e 6f 6e 2d 7a  me="value">Non-z
08c0: 65 72 6f 20 74 6f 20 65 6e 61 62 6c 65 20 6d 65  ero to enable me
08d0: 6d 6f 72 79 20 75 73 61 67 65 20 74 72 61 63 6b  mory usage track
08e0: 69 6e 67 2c 20 7a 65 72 6f 20 6f 74 68 65 72 77  ing, zero otherw
08f0: 69 73 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  ise.</param>..  
0900: 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 41    /// <returns>A
0910: 20 73 74 61 6e 64 61 72 64 20 53 51 4c 69 74 65   standard SQLite
0920: 20 72 65 74 75 72 6e 20 63 6f 64 65 20 28 69 2e   return code (i.
0930: 65 2e 20 7a 65 72 6f 20 66 6f 72 20 73 75 63 63  e. zero for succ
0940: 65 73 73 20 61 6e 64 20 6e 6f 6e 2d 7a 65 72 6f  ess and non-zero
0950: 20 66 6f 72 20 66 61 69 6c 75 72 65 29 2e 3c 2f   for failure).</
0960: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e  returns>..    in
0970: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
0980: 69 6e 74 20 53 65 74 4d 65 6d 6f 72 79 53 74 61  int SetMemorySta
0990: 74 75 73 28 62 6f 6f 6c 20 76 61 6c 75 65 29 3b  tus(bool value);
09a0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
09b0: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 53 68 75  ry>..    /// Shu
09c0: 74 64 6f 77 6e 20 74 68 65 20 53 51 4c 69 74 65  tdown the SQLite
09d0: 20 65 6e 67 69 6e 65 20 73 6f 20 74 68 61 74 20   engine so that 
09e0: 69 74 20 63 61 6e 20 62 65 20 72 65 73 74 61 72  it can be restar
09f0: 74 65 64 20 77 69 74 68 20 64 69 66 66 65 72 65  ted with differe
0a00: 6e 74 20 63 6f 6e 66 69 67 20 6f 70 74 69 6f 6e  nt config option
0a10: 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 57 65 20 64  s...    /// We d
0a20: 65 70 65 6e 64 20 6f 6e 20 61 75 74 6f 20 69 6e  epend on auto in
0a30: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 74 6f 20  itialization to 
0a40: 72 65 63 6f 76 65 72 2e 0d 0a 20 20 20 20 2f 2f  recover...    //
0a50: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
0a60: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
0a70: 61 63 74 20 69 6e 74 20 53 68 75 74 64 6f 77 6e  act int Shutdown
0a80: 28 29 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ();..    /// <su
0a90: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
0aa0: 52 65 74 75 72 6e 73 20 6e 6f 6e 2d 7a 65 72 6f  Returns non-zero
0ab0: 20 69 66 20 61 20 64 61 74 61 62 61 73 65 20 63   if a database c
0ac0: 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65  onnection is ope
0ad0: 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  n...    /// </su
0ae0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
0af0: 3c 72 65 74 75 72 6e 73 3e 3c 2f 72 65 74 75 72  <returns></retur
0b00: 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ns>..    interna
0b10: 6c 20 61 62 73 74 72 61 63 74 20 62 6f 6f 6c 20  l abstract bool 
0b20: 49 73 4f 70 65 6e 28 29 3b 0d 0a 20 20 20 20 2f  IsOpen();..    /
0b30: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
0b40: 20 20 2f 2f 2f 20 4f 70 65 6e 73 20 61 20 64 61    /// Opens a da
0b50: 74 61 62 61 73 65 2e 0d 0a 20 20 20 20 2f 2f 2f  tabase...    ///
0b60: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
0b70: 20 2f 2f 2f 20 3c 72 65 6d 61 72 6b 73 3e 0d 0a   /// <remarks>..
0b80: 20 20 20 20 2f 2f 2f 20 49 6d 70 6c 65 6d 65 6e      /// Implemen
0b90: 74 65 72 73 20 73 68 6f 75 6c 64 20 63 61 6c 6c  ters should call
0ba0: 20 53 51 4c 69 74 65 46 75 6e 63 74 69 6f 6e 2e   SQLiteFunction.
0bb0: 42 69 6e 64 46 75 6e 63 74 69 6f 6e 73 28 29 20  BindFunctions() 
0bc0: 61 6e 64 20 73 61 76 65 20 74 68 65 20 61 72 72  and save the arr
0bd0: 61 79 20 61 66 74 65 72 20 6f 70 65 6e 69 6e 67  ay after opening
0be0: 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 0d 0a 20   a connection.. 
0bf0: 20 20 20 2f 2f 2f 20 74 6f 20 62 69 6e 64 20 61     /// to bind a
0c00: 6c 6c 20 61 74 74 72 69 62 75 74 65 64 20 75 73  ll attributed us
0c10: 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74  er-defined funct
0c20: 69 6f 6e 73 20 61 6e 64 20 63 6f 6c 6c 61 74 69  ions and collati
0c30: 6e 67 20 73 65 71 75 65 6e 63 65 73 20 74 6f 20  ng sequences to 
0c40: 74 68 65 20 6e 65 77 20 63 6f 6e 6e 65 63 74 69  the new connecti
0c50: 6f 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72  on...    /// </r
0c60: 65 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 2f 2f 2f  emarks>..    ///
0c70: 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 74   <param name="st
0c80: 72 46 69 6c 65 6e 61 6d 65 22 3e 54 68 65 20 66  rFilename">The f
0c90: 69 6c 65 6e 61 6d 65 20 6f 66 20 74 68 65 20 64  ilename of the d
0ca0: 61 74 61 62 61 73 65 20 74 6f 20 6f 70 65 6e 2e  atabase to open.
0cb0: 20 20 53 51 4c 69 74 65 20 61 75 74 6f 6d 61 74    SQLite automat
0cc0: 69 63 61 6c 6c 79 20 63 72 65 61 74 65 73 20 69  ically creates i
0cd0: 74 20 69 66 20 69 74 20 64 6f 65 73 6e 27 74 20  t if it doesn't 
0ce0: 65 78 69 73 74 2e 3c 2f 70 61 72 61 6d 3e 0d 0a  exist.</param>..
0cf0: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
0d00: 61 6d 65 3d 22 63 6f 6e 6e 65 63 74 69 6f 6e 46  ame="connectionF
0d10: 6c 61 67 73 22 3e 54 68 65 20 66 6c 61 67 73 20  lags">The flags 
0d20: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
0d30: 74 68 65 20 70 61 72 65 6e 74 20 63 6f 6e 6e 65  the parent conne
0d40: 63 74 69 6f 6e 20 6f 62 6a 65 63 74 3c 2f 70 61  ction object</pa
0d50: 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ram>..    /// <p
0d60: 61 72 61 6d 20 6e 61 6d 65 3d 22 6f 70 65 6e 46  aram name="openF
0d70: 6c 61 67 73 22 3e 54 68 65 20 6f 70 65 6e 20 66  lags">The open f
0d80: 6c 61 67 73 20 74 6f 20 75 73 65 20 77 68 65 6e  lags to use when
0d90: 20 63 72 65 61 74 69 6e 67 20 74 68 65 20 63 6f   creating the co
0da0: 6e 6e 65 63 74 69 6f 6e 3c 2f 70 61 72 61 6d 3e  nnection</param>
0db0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
0dc0: 20 6e 61 6d 65 3d 22 6d 61 78 50 6f 6f 6c 53 69   name="maxPoolSi
0dd0: 7a 65 22 3e 54 68 65 20 6d 61 78 69 6d 75 6d 20  ze">The maximum 
0de0: 73 69 7a 65 20 6f 66 20 74 68 65 20 70 6f 6f 6c  size of the pool
0df0: 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 20 66   for the given f
0e00: 69 6c 65 6e 61 6d 65 3c 2f 70 61 72 61 6d 3e 0d  ilename</param>.
0e10: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
0e20: 6e 61 6d 65 3d 22 75 73 65 50 6f 6f 6c 22 3e 49  name="usePool">I
0e30: 66 20 74 72 75 65 2c 20 74 68 65 20 63 6f 6e 6e  f true, the conn
0e40: 65 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 70 75  ection can be pu
0e50: 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20 63 6f  lled from the co
0e60: 6e 6e 65 63 74 69 6f 6e 20 70 6f 6f 6c 3c 2f 70  nnection pool</p
0e70: 61 72 61 6d 3e 0d 0a 20 20 20 20 69 6e 74 65 72  aram>..    inter
0e80: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69  nal abstract voi
0e90: 64 20 4f 70 65 6e 28 73 74 72 69 6e 67 20 73 74  d Open(string st
0ea0: 72 46 69 6c 65 6e 61 6d 65 2c 20 53 51 4c 69 74  rFilename, SQLit
0eb0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
0ec0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73   connectionFlags
0ed0: 2c 20 53 51 4c 69 74 65 4f 70 65 6e 46 6c 61 67  , SQLiteOpenFlag
0ee0: 73 45 6e 75 6d 20 6f 70 65 6e 46 6c 61 67 73 2c  sEnum openFlags,
0ef0: 20 69 6e 74 20 6d 61 78 50 6f 6f 6c 53 69 7a 65   int maxPoolSize
0f00: 2c 20 62 6f 6f 6c 20 75 73 65 50 6f 6f 6c 29 3b  , bool usePool);
0f10: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
0f20: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43 6c 6f  ry>..    /// Clo
0f30: 73 65 73 20 74 68 65 20 63 75 72 72 65 6e 74 6c  ses the currentl
0f40: 79 2d 6f 70 65 6e 20 64 61 74 61 62 61 73 65 2e  y-open database.
0f50: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  ..    /// </summ
0f60: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72  ary>..    /// <r
0f70: 65 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 2f 2f 2f  emarks>..    ///
0f80: 20 41 66 74 65 72 20 74 68 65 20 64 61 74 61 62   After the datab
0f90: 61 73 65 20 68 61 73 20 62 65 65 6e 20 63 6c 6f  ase has been clo
0fa0: 73 65 64 20 69 6d 70 6c 65 6d 65 74 65 72 73 20  sed implemeters 
0fb0: 73 68 6f 75 6c 64 20 63 61 6c 6c 20 53 51 4c 69  should call SQLi
0fc0: 74 65 46 75 6e 63 74 69 6f 6e 2e 55 6e 62 69 6e  teFunction.Unbin
0fd0: 64 46 75 6e 63 74 69 6f 6e 73 28 29 20 74 6f 20  dFunctions() to 
0fe0: 64 65 61 6c 6c 6f 63 61 74 65 20 61 6c 6c 20 69  deallocate all i
0ff0: 6e 74 65 72 6f 70 20 61 6c 6c 6f 63 61 74 65 64  nterop allocated
1000: 0d 0a 20 20 20 20 2f 2f 2f 20 6d 65 6d 6f 72 79  ..    /// memory
1010: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
1020: 20 74 68 65 20 75 73 65 72 2d 64 65 66 69 6e 65   the user-define
1030: 64 20 66 75 6e 63 74 69 6f 6e 73 20 61 6e 64 20  d functions and 
1040: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e  collating sequen
1050: 63 65 73 20 74 69 65 64 20 74 6f 20 74 68 65 20  ces tied to the 
1060: 63 6c 6f 73 65 64 20 63 6f 6e 6e 65 63 74 69 6f  closed connectio
1070: 6e 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 72 65  n...    /// </re
1080: 6d 61 72 6b 73 3e 0d 0a 20 20 20 20 69 6e 74 65  marks>..    inte
1090: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
10a0: 69 64 20 43 6c 6f 73 65 28 29 3b 0d 0a 20 20 20  id Close();..   
10b0: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
10c0: 20 20 20 20 2f 2f 2f 20 53 65 74 73 20 74 68 65      /// Sets the
10d0: 20 62 75 73 79 20 74 69 6d 65 6f 75 74 20 6f 6e   busy timeout on
10e0: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e   the connection.
10f0: 20 20 53 51 4c 69 74 65 43 6f 6d 6d 61 6e 64 20    SQLiteCommand 
1100: 77 69 6c 6c 20 63 61 6c 6c 20 74 68 69 73 20 62  will call this b
1110: 65 66 6f 72 65 20 65 78 65 63 75 74 69 6e 67 20  efore executing 
1120: 61 6e 79 20 63 6f 6d 6d 61 6e 64 2e 0d 0a 20 20  any command...  
1130: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
1140: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
1150: 20 6e 61 6d 65 3d 22 6e 54 69 6d 65 6f 75 74 4d   name="nTimeoutM
1160: 53 22 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  S">The number of
1170: 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 74 6f   milliseconds to
1180: 20 77 61 69 74 20 62 65 66 6f 72 65 20 72 65 74   wait before ret
1190: 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f 42 55  urning SQLITE_BU
11a0: 53 59 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  SY</param>..    
11b0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
11c0: 74 20 76 6f 69 64 20 53 65 74 54 69 6d 65 6f 75  t void SetTimeou
11d0: 74 28 69 6e 74 20 6e 54 69 6d 65 6f 75 74 4d 53  t(int nTimeoutMS
11e0: 29 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d  );..    /// <sum
11f0: 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52  mary>..    /// R
1200: 65 74 75 72 6e 73 20 74 68 65 20 74 65 78 74 20  eturns the text 
1210: 6f 66 20 74 68 65 20 6c 61 73 74 20 65 72 72 6f  of the last erro
1220: 72 20 69 73 73 75 65 64 20 62 79 20 53 51 4c 69  r issued by SQLi
1230: 74 65 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75  te..    /// </su
1240: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
1250: 3c 72 65 74 75 72 6e 73 3e 3c 2f 72 65 74 75 72  <returns></retur
1260: 6e 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ns>..    interna
1270: 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69 6e  l abstract strin
1280: 67 20 47 65 74 4c 61 73 74 45 72 72 6f 72 28 29  g GetLastError()
1290: 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75  ;....    /// <su
12a0: 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20  mmary>..    /// 
12b0: 57 68 65 6e 20 70 6f 6f 6c 69 6e 67 20 69 73 20  When pooling is 
12c0: 65 6e 61 62 6c 65 64 2c 20 66 6f 72 63 65 20 74  enabled, force t
12d0: 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74  his connection t
12e0: 6f 20 62 65 20 64 69 73 70 6f 73 65 64 20 72 61  o be disposed ra
12f0: 74 68 65 72 20 74 68 61 6e 20 72 65 74 75 72 6e  ther than return
1300: 65 64 20 74 6f 20 74 68 65 20 70 6f 6f 6c 0d 0a  ed to the pool..
1310: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
1320: 79 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  y>..    internal
1330: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 43   abstract void C
1340: 6c 65 61 72 50 6f 6f 6c 28 29 3b 0d 0a 0d 0a 20  learPool();.... 
1350: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
1360: 0d 0a 20 20 20 20 2f 2f 2f 20 57 68 65 6e 20 70  ..    /// When p
1370: 6f 6f 6c 69 6e 67 20 69 73 20 65 6e 61 62 6c 65  ooling is enable
1380: 64 2c 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e  d, returns the n
1390: 75 6d 62 65 72 20 6f 66 20 70 6f 6f 6c 20 65 6e  umber of pool en
13a0: 74 72 69 65 73 20 6d 61 74 63 68 69 6e 67 20 74  tries matching t
13b0: 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65 20  he current file 
13c0: 6e 61 6d 65 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  name...    /// <
13d0: 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f  /summary>..    /
13e0: 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54 68 65 20  // <returns>The 
13f0: 6e 75 6d 62 65 72 20 6f 66 20 70 6f 6f 6c 20 65  number of pool e
1400: 6e 74 72 69 65 73 20 6d 61 74 63 68 69 6e 67 20  ntries matching 
1410: 74 68 65 20 63 75 72 72 65 6e 74 20 66 69 6c 65  the current file
1420: 20 6e 61 6d 65 2e 3c 2f 72 65 74 75 72 6e 73 3e   name.</returns>
1430: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
1440: 62 73 74 72 61 63 74 20 69 6e 74 20 43 6f 75 6e  bstract int Coun
1450: 74 50 6f 6f 6c 28 29 3b 0d 0a 0d 0a 20 20 20 20  tPool();....    
1460: 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20  /// <summary>.. 
1470: 20 20 20 2f 2f 2f 20 50 72 65 70 61 72 65 73 20     /// Prepares 
1480: 61 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  a SQL statement 
1490: 66 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 0d 0a  for execution...
14a0: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
14b0: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
14c0: 61 6d 20 6e 61 6d 65 3d 22 63 6e 6e 22 3e 54 68  am name="cnn">Th
14d0: 65 20 73 6f 75 72 63 65 20 63 6f 6e 6e 65 63 74  e source connect
14e0: 69 6f 6e 20 70 72 65 70 61 72 69 6e 67 20 74 68  ion preparing th
14f0: 65 20 63 6f 6d 6d 61 6e 64 2e 20 20 43 61 6e 20  e command.  Can 
1500: 62 65 20 6e 75 6c 6c 20 66 6f 72 20 61 6e 79 20  be null for any 
1510: 63 61 6c 6c 65 72 20 65 78 63 65 70 74 20 4c 49  caller except LI
1520: 4e 51 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  NQ</param>..    
1530: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
1540: 22 73 74 72 53 71 6c 22 3e 54 68 65 20 53 51 4c  "strSql">The SQL
1550: 20 63 6f 6d 6d 61 6e 64 20 74 65 78 74 20 74 6f   command text to
1560: 20 70 72 65 70 61 72 65 3c 2f 70 61 72 61 6d 3e   prepare</param>
1570: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
1580: 20 6e 61 6d 65 3d 22 70 72 65 76 69 6f 75 73 22   name="previous"
1590: 3e 54 68 65 20 70 72 65 76 69 6f 75 73 20 73 74  >The previous st
15a0: 61 74 65 6d 65 6e 74 20 69 6e 20 61 20 6d 75 6c  atement in a mul
15b0: 74 69 2d 73 74 61 74 65 6d 65 6e 74 20 63 6f 6d  ti-statement com
15c0: 6d 61 6e 64 2c 20 6f 72 20 6e 75 6c 6c 20 69 66  mand, or null if
15d0: 20 6e 6f 20 70 72 65 76 69 6f 75 73 20 73 74 61   no previous sta
15e0: 74 65 6d 65 6e 74 20 65 78 69 73 74 73 3c 2f 70  tement exists</p
15f0: 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c  aram>..    /// <
1600: 70 61 72 61 6d 20 6e 61 6d 65 3d 22 74 69 6d 65  param name="time
1610: 6f 75 74 4d 53 22 3e 54 68 65 20 74 69 6d 65 6f  outMS">The timeo
1620: 75 74 20 74 6f 20 77 61 69 74 20 62 65 66 6f 72  ut to wait befor
1630: 65 20 61 62 6f 72 74 69 6e 67 20 74 68 65 20 70  e aborting the p
1640: 72 65 70 61 72 65 3c 2f 70 61 72 61 6d 3e 0d 0a  repare</param>..
1650: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
1660: 61 6d 65 3d 22 73 74 72 52 65 6d 61 69 6e 22 3e  ame="strRemain">
1670: 54 68 65 20 72 65 6d 61 69 6e 64 65 72 20 6f 66  The remainder of
1680: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74   the statement t
1690: 68 61 74 20 77 61 73 20 6e 6f 74 20 70 72 6f 63  hat was not proc
16a0: 65 73 73 65 64 2e 20 20 45 61 63 68 20 63 61 6c  essed.  Each cal
16b0: 6c 20 74 6f 20 70 72 65 70 61 72 65 20 70 61 72  l to prepare par
16c0: 73 65 73 20 74 68 65 0d 0a 20 20 20 20 2f 2f 2f  ses the..    ///
16d0: 20 53 51 4c 20 75 70 20 74 6f 20 74 6f 20 65 69   SQL up to to ei
16e0: 74 68 65 72 20 74 68 65 20 65 6e 64 20 6f 66 20  ther the end of 
16f0: 74 68 65 20 74 65 78 74 20 6f 72 20 74 6f 20 74  the text or to t
1700: 68 65 20 66 69 72 73 74 20 73 65 6d 69 2d 63 6f  he first semi-co
1710: 6c 6f 6e 20 64 65 6c 69 6d 69 74 65 72 2e 20 20  lon delimiter.  
1720: 54 68 65 20 72 65 6d 61 69 6e 69 6e 67 20 74 65  The remaining te
1730: 78 74 20 69 73 20 72 65 74 75 72 6e 65 64 0d 0a  xt is returned..
1740: 20 20 20 20 2f 2f 2f 20 68 65 72 65 20 66 6f 72      /// here for
1750: 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 63 61   a subsequent ca
1760: 6c 6c 20 74 6f 20 50 72 65 70 61 72 65 28 29 20  ll to Prepare() 
1770: 75 6e 74 69 6c 20 61 6c 6c 20 74 68 65 20 74 65  until all the te
1780: 78 74 20 68 61 73 20 62 65 65 6e 20 70 72 6f 63  xt has been proc
1790: 65 73 73 65 64 2e 3c 2f 70 61 72 61 6d 3e 0d 0a  essed.</param>..
17a0: 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73      /// <returns
17b0: 3e 52 65 74 75 72 6e 73 20 61 6e 20 69 6e 69 74  >Returns an init
17c0: 69 61 6c 69 7a 65 64 20 53 51 4c 69 74 65 53 74  ialized SQLiteSt
17d0: 61 74 65 6d 65 6e 74 2e 3c 2f 72 65 74 75 72 6e  atement.</return
17e0: 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  s>..    internal
17f0: 20 61 62 73 74 72 61 63 74 20 53 51 4c 69 74 65   abstract SQLite
1800: 53 74 61 74 65 6d 65 6e 74 20 50 72 65 70 61 72  Statement Prepar
1810: 65 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  e(SQLiteConnecti
1820: 6f 6e 20 63 6e 6e 2c 20 73 74 72 69 6e 67 20 73  on cnn, string s
1830: 74 72 53 71 6c 2c 20 53 51 4c 69 74 65 53 74 61  trSql, SQLiteSta
1840: 74 65 6d 65 6e 74 20 70 72 65 76 69 6f 75 73 2c  tement previous,
1850: 20 75 69 6e 74 20 74 69 6d 65 6f 75 74 4d 53 2c   uint timeoutMS,
1860: 20 6f 75 74 20 73 74 72 69 6e 67 20 73 74 72 52   out string strR
1870: 65 6d 61 69 6e 29 3b 0d 0a 20 20 20 20 2f 2f 2f  emain);..    ///
1880: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
1890: 2f 2f 2f 20 53 74 65 70 73 20 74 68 72 6f 75 67  /// Steps throug
18a0: 68 20 61 20 70 72 65 70 61 72 65 64 20 73 74 61  h a prepared sta
18b0: 74 65 6d 65 6e 74 2e 0d 0a 20 20 20 20 2f 2f 2f  tement...    ///
18c0: 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20   </summary>..   
18d0: 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65   /// <param name
18e0: 3d 22 73 74 6d 74 22 3e 54 68 65 20 53 51 4c 69  ="stmt">The SQLi
18f0: 74 65 53 74 61 74 65 6d 65 6e 74 20 74 6f 20 73  teStatement to s
1900: 74 65 70 20 74 68 72 6f 75 67 68 3c 2f 70 61 72  tep through</par
1910: 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65  am>..    /// <re
1920: 74 75 72 6e 73 3e 54 72 75 65 20 69 66 20 61 20  turns>True if a 
1930: 72 6f 77 20 77 61 73 20 72 65 74 75 72 6e 65 64  row was returned
1940: 2c 20 46 61 6c 73 65 20 69 66 20 6e 6f 74 2e 3c  , False if not.<
1950: 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69  /returns>..    i
1960: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
1970: 20 62 6f 6f 6c 20 53 74 65 70 28 53 51 4c 69 74   bool Step(SQLit
1980: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 29  eStatement stmt)
1990: 3b 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ;..    /// <summ
19a0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65  ary>..    /// Re
19b0: 73 65 74 73 20 61 20 70 72 65 70 61 72 65 64 20  sets a prepared 
19c0: 73 74 61 74 65 6d 65 6e 74 20 73 6f 20 69 74 20  statement so it 
19d0: 63 61 6e 20 62 65 20 65 78 65 63 75 74 65 64 20  can be executed 
19e0: 61 67 61 69 6e 2e 20 20 49 66 20 74 68 65 20 65  again.  If the e
19f0: 72 72 6f 72 20 72 65 74 75 72 6e 65 64 20 69 73  rror returned is
1a00: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2c 20   SQLITE_SCHEMA, 
1a10: 0d 0a 20 20 20 20 2f 2f 2f 20 74 72 61 6e 73 70  ..    /// transp
1a20: 61 72 65 6e 74 6c 79 20 61 74 74 65 6d 70 74 20  arently attempt 
1a30: 74 6f 20 72 65 62 75 69 6c 64 20 74 68 65 20 53  to rebuild the S
1a40: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64  QL statement and
1a50: 20 74 68 72 6f 77 20 61 6e 20 65 72 72 6f 72 20   throw an error 
1a60: 69 66 20 74 68 61 74 20 77 61 73 20 6e 6f 74 20  if that was not 
1a70: 70 6f 73 73 69 62 6c 65 2e 0d 0a 20 20 20 20 2f  possible...    /
1a80: 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20  // </summary>.. 
1a90: 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61     /// <param na
1aa0: 6d 65 3d 22 73 74 6d 74 22 3e 54 68 65 20 73 74  me="stmt">The st
1ab0: 61 74 65 6d 65 6e 74 20 74 6f 20 72 65 73 65 74  atement to reset
1ac0: 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f  </param>..    //
1ad0: 2f 20 3c 72 65 74 75 72 6e 73 3e 52 65 74 75 72  / <returns>Retur
1ae0: 6e 73 20 2d 31 20 69 66 20 74 68 65 20 73 63 68  ns -1 if the sch
1af0: 65 6d 61 20 63 68 61 6e 67 65 64 20 77 68 69 6c  ema changed whil
1b00: 65 20 72 65 73 65 74 74 69 6e 67 2c 20 30 20 69  e resetting, 0 i
1b10: 66 20 74 68 65 20 72 65 73 65 74 20 77 61 73 20  f the reset was 
1b20: 73 75 63 65 73 73 66 75 6c 20 6f 72 20 36 20 28  sucessful or 6 (
1b30: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 29 20 69  SQLITE_LOCKED) i
1b40: 66 20 74 68 65 20 72 65 73 65 74 20 66 61 69 6c  f the reset fail
1b50: 65 64 20 64 75 65 20 74 6f 20 61 20 6c 6f 63 6b  ed due to a lock
1b60: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20  </returns>..    
1b70: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
1b80: 74 20 69 6e 74 20 52 65 73 65 74 28 53 51 4c 69  t int Reset(SQLi
1b90: 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74  teStatement stmt
1ba0: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
1bb0: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 43   abstract void C
1bc0: 61 6e 63 65 6c 28 29 3b 0d 0a 0d 0a 20 20 20 20  ancel();....    
1bd0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
1be0: 74 20 76 6f 69 64 20 42 69 6e 64 5f 44 6f 75 62  t void Bind_Doub
1bf0: 6c 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  le(SQLiteStateme
1c00: 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43  nt stmt, SQLiteC
1c10: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66  onnectionFlags f
1c20: 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 2c  lags, int index,
1c30: 20 64 6f 75 62 6c 65 20 76 61 6c 75 65 29 3b 0d   double value);.
1c40: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
1c50: 73 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e 64  stract void Bind
1c60: 5f 49 6e 74 33 32 28 53 51 4c 69 74 65 53 74 61  _Int32(SQLiteSta
1c70: 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c  tement stmt, SQL
1c80: 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61  iteConnectionFla
1c90: 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e  gs flags, int in
1ca0: 64 65 78 2c 20 49 6e 74 33 32 20 76 61 6c 75 65  dex, Int32 value
1cb0: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
1cc0: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42   abstract void B
1cd0: 69 6e 64 5f 55 49 6e 74 33 32 28 53 51 4c 69 74  ind_UInt32(SQLit
1ce0: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
1cf0: 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f   SQLiteConnectio
1d00: 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e  nFlags flags, in
1d10: 74 20 69 6e 64 65 78 2c 20 55 49 6e 74 33 32 20  t index, UInt32 
1d20: 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74  value);..    int
1d30: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
1d40: 6f 69 64 20 42 69 6e 64 5f 49 6e 74 36 34 28 53  oid Bind_Int64(S
1d50: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
1d60: 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65  tmt, SQLiteConne
1d70: 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73  ctionFlags flags
1d80: 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20 49 6e 74  , int index, Int
1d90: 36 34 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20  64 value);..    
1da0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
1db0: 74 20 76 6f 69 64 20 42 69 6e 64 5f 55 49 6e 74  t void Bind_UInt
1dc0: 36 34 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  64(SQLiteStateme
1dd0: 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43  nt stmt, SQLiteC
1de0: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66  onnectionFlags f
1df0: 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 2c  lags, int index,
1e00: 20 55 49 6e 74 36 34 20 76 61 6c 75 65 29 3b 0d   UInt64 value);.
1e10: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
1e20: 73 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e 64  stract void Bind
1e30: 5f 54 65 78 74 28 53 51 4c 69 74 65 53 74 61 74  _Text(SQLiteStat
1e40: 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69  ement stmt, SQLi
1e50: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67  teConnectionFlag
1e60: 73 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64  s flags, int ind
1e70: 65 78 2c 20 73 74 72 69 6e 67 20 76 61 6c 75 65  ex, string value
1e80: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
1e90: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 42   abstract void B
1ea0: 69 6e 64 5f 42 6c 6f 62 28 53 51 4c 69 74 65 53  ind_Blob(SQLiteS
1eb0: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 53  tatement stmt, S
1ec0: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 46  QLiteConnectionF
1ed0: 6c 61 67 73 20 66 6c 61 67 73 2c 20 69 6e 74 20  lags flags, int 
1ee0: 69 6e 64 65 78 2c 20 62 79 74 65 5b 5d 20 62 6c  index, byte[] bl
1ef0: 6f 62 44 61 74 61 29 3b 0d 0a 20 20 20 20 69 6e  obData);..    in
1f00: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
1f10: 76 6f 69 64 20 42 69 6e 64 5f 44 61 74 65 54 69  void Bind_DateTi
1f20: 6d 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  me(SQLiteStateme
1f30: 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43  nt stmt, SQLiteC
1f40: 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66  onnectionFlags f
1f50: 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 2c  lags, int index,
1f60: 20 44 61 74 65 54 69 6d 65 20 64 74 29 3b 0d 0a   DateTime dt);..
1f70: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
1f80: 74 72 61 63 74 20 76 6f 69 64 20 42 69 6e 64 5f  tract void Bind_
1f90: 4e 75 6c 6c 28 53 51 4c 69 74 65 53 74 61 74 65  Null(SQLiteState
1fa0: 6d 65 6e 74 20 73 74 6d 74 2c 20 53 51 4c 69 74  ment stmt, SQLit
1fb0: 65 43 6f 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73  eConnectionFlags
1fc0: 20 66 6c 61 67 73 2c 20 69 6e 74 20 69 6e 64 65   flags, int inde
1fd0: 78 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72  x);....    inter
1fe0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
1ff0: 20 42 69 6e 64 5f 50 61 72 61 6d 43 6f 75 6e 74   Bind_ParamCount
2000: 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74  (SQLiteStatement
2010: 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f 6e   stmt, SQLiteCon
2020: 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c 61  nectionFlags fla
2030: 67 73 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  gs);..    intern
2040: 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72 69  al abstract stri
2050: 6e 67 20 42 69 6e 64 5f 50 61 72 61 6d 4e 61 6d  ng Bind_ParamNam
2060: 65 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e  e(SQLiteStatemen
2070: 74 20 73 74 6d 74 2c 20 53 51 4c 69 74 65 43 6f  t stmt, SQLiteCo
2080: 6e 6e 65 63 74 69 6f 6e 46 6c 61 67 73 20 66 6c  nnectionFlags fl
2090: 61 67 73 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  ags, int index);
20a0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
20b0: 62 73 74 72 61 63 74 20 69 6e 74 20 42 69 6e 64  bstract int Bind
20c0: 5f 50 61 72 61 6d 49 6e 64 65 78 28 53 51 4c 69  _ParamIndex(SQLi
20d0: 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74  teStatement stmt
20e0: 2c 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69  , SQLiteConnecti
20f0: 6f 6e 46 6c 61 67 73 20 66 6c 61 67 73 2c 20 73  onFlags flags, s
2100: 74 72 69 6e 67 20 70 61 72 61 6d 4e 61 6d 65 29  tring paramName)
2110: 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  ;....    interna
2120: 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 43  l abstract int C
2130: 6f 6c 75 6d 6e 43 6f 75 6e 74 28 53 51 4c 69 74  olumnCount(SQLit
2140: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 29  eStatement stmt)
2150: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
2160: 61 62 73 74 72 61 63 74 20 73 74 72 69 6e 67 20  abstract string 
2170: 43 6f 6c 75 6d 6e 4e 61 6d 65 28 53 51 4c 69 74  ColumnName(SQLit
2180: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2190: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
21a0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
21b0: 61 63 74 20 54 79 70 65 41 66 66 69 6e 69 74 79  act TypeAffinity
21c0: 20 43 6f 6c 75 6d 6e 41 66 66 69 6e 69 74 79 28   ColumnAffinity(
21d0: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
21e0: 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29  stmt, int index)
21f0: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
2200: 61 62 73 74 72 61 63 74 20 73 74 72 69 6e 67 20  abstract string 
2210: 43 6f 6c 75 6d 6e 54 79 70 65 28 53 51 4c 69 74  ColumnType(SQLit
2220: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2230: 20 69 6e 74 20 69 6e 64 65 78 2c 20 6f 75 74 20   int index, out 
2240: 54 79 70 65 41 66 66 69 6e 69 74 79 20 6e 41 66  TypeAffinity nAf
2250: 66 69 6e 69 74 79 29 3b 0d 0a 20 20 20 20 69 6e  finity);..    in
2260: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2270: 69 6e 74 20 43 6f 6c 75 6d 6e 49 6e 64 65 78 28  int ColumnIndex(
2280: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
2290: 73 74 6d 74 2c 20 73 74 72 69 6e 67 20 63 6f 6c  stmt, string col
22a0: 75 6d 6e 4e 61 6d 65 29 3b 0d 0a 20 20 20 20 69  umnName);..    i
22b0: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
22c0: 20 73 74 72 69 6e 67 20 43 6f 6c 75 6d 6e 4f 72   string ColumnOr
22d0: 69 67 69 6e 61 6c 4e 61 6d 65 28 53 51 4c 69 74  iginalName(SQLit
22e0: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
22f0: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
2300: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2310: 61 63 74 20 73 74 72 69 6e 67 20 43 6f 6c 75 6d  act string Colum
2320: 6e 44 61 74 61 62 61 73 65 4e 61 6d 65 28 53 51  nDatabaseName(SQ
2330: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74  LiteStatement st
2340: 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d  mt, int index);.
2350: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
2360: 73 74 72 61 63 74 20 73 74 72 69 6e 67 20 43 6f  stract string Co
2370: 6c 75 6d 6e 54 61 62 6c 65 4e 61 6d 65 28 53 51  lumnTableName(SQ
2380: 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74  LiteStatement st
2390: 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d  mt, int index);.
23a0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
23b0: 73 74 72 61 63 74 20 76 6f 69 64 20 43 6f 6c 75  stract void Colu
23c0: 6d 6e 4d 65 74 61 44 61 74 61 28 73 74 72 69 6e  mnMetaData(strin
23d0: 67 20 64 61 74 61 42 61 73 65 2c 20 73 74 72 69  g dataBase, stri
23e0: 6e 67 20 74 61 62 6c 65 2c 20 73 74 72 69 6e 67  ng table, string
23f0: 20 63 6f 6c 75 6d 6e 2c 20 6f 75 74 20 73 74 72   column, out str
2400: 69 6e 67 20 64 61 74 61 54 79 70 65 2c 20 6f 75  ing dataType, ou
2410: 74 20 73 74 72 69 6e 67 20 63 6f 6c 6c 61 74 65  t string collate
2420: 53 65 71 75 65 6e 63 65 2c 20 6f 75 74 20 62 6f  Sequence, out bo
2430: 6f 6c 20 6e 6f 74 4e 75 6c 6c 2c 20 6f 75 74 20  ol notNull, out 
2440: 62 6f 6f 6c 20 70 72 69 6d 61 72 79 4b 65 79 2c  bool primaryKey,
2450: 20 6f 75 74 20 62 6f 6f 6c 20 61 75 74 6f 49 6e   out bool autoIn
2460: 63 72 65 6d 65 6e 74 29 3b 0d 0a 20 20 20 20 69  crement);..    i
2470: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
2480: 20 76 6f 69 64 20 47 65 74 49 6e 64 65 78 43 6f   void GetIndexCo
2490: 6c 75 6d 6e 45 78 74 65 6e 64 65 64 49 6e 66 6f  lumnExtendedInfo
24a0: 28 73 74 72 69 6e 67 20 64 61 74 61 62 61 73 65  (string database
24b0: 2c 20 73 74 72 69 6e 67 20 69 6e 64 65 78 2c 20  , string index, 
24c0: 73 74 72 69 6e 67 20 63 6f 6c 75 6d 6e 2c 20 6f  string column, o
24d0: 75 74 20 69 6e 74 20 73 6f 72 74 4d 6f 64 65 2c  ut int sortMode,
24e0: 20 6f 75 74 20 69 6e 74 20 6f 6e 45 72 72 6f 72   out int onError
24f0: 2c 20 6f 75 74 20 73 74 72 69 6e 67 20 63 6f 6c  , out string col
2500: 6c 61 74 69 6f 6e 53 65 71 75 65 6e 63 65 29 3b  lationSequence);
2510: 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  ....    internal
2520: 20 61 62 73 74 72 61 63 74 20 64 6f 75 62 6c 65   abstract double
2530: 20 47 65 74 44 6f 75 62 6c 65 28 53 51 4c 69 74   GetDouble(SQLit
2540: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
2550: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
2560: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2570: 61 63 74 20 49 6e 74 33 32 20 47 65 74 49 6e 74  act Int32 GetInt
2580: 33 32 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  32(SQLiteStateme
2590: 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64  nt stmt, int ind
25a0: 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ex);..    intern
25b0: 61 6c 20 61 62 73 74 72 61 63 74 20 49 6e 74 36  al abstract Int6
25c0: 34 20 47 65 74 49 6e 74 36 34 28 53 51 4c 69 74  4 GetInt64(SQLit
25d0: 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c  eStatement stmt,
25e0: 20 69 6e 74 20 69 6e 64 65 78 29 3b 0d 0a 20 20   int index);..  
25f0: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2600: 61 63 74 20 73 74 72 69 6e 67 20 47 65 74 54 65  act string GetTe
2610: 78 74 28 53 51 4c 69 74 65 53 74 61 74 65 6d 65  xt(SQLiteStateme
2620: 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e 64  nt stmt, int ind
2630: 65 78 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  ex);..    intern
2640: 61 6c 20 61 62 73 74 72 61 63 74 20 6c 6f 6e 67  al abstract long
2650: 20 47 65 74 42 79 74 65 73 28 53 51 4c 69 74 65   GetBytes(SQLite
2660: 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20  Statement stmt, 
2670: 69 6e 74 20 69 6e 64 65 78 2c 20 69 6e 74 20 6e  int index, int n
2680: 44 61 74 61 6f 66 66 73 65 74 2c 20 62 79 74 65  Dataoffset, byte
2690: 5b 5d 20 62 44 65 73 74 2c 20 69 6e 74 20 6e 53  [] bDest, int nS
26a0: 74 61 72 74 2c 20 69 6e 74 20 6e 4c 65 6e 67 74  tart, int nLengt
26b0: 68 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61  h);..    interna
26c0: 6c 20 61 62 73 74 72 61 63 74 20 6c 6f 6e 67 20  l abstract long 
26d0: 47 65 74 43 68 61 72 73 28 53 51 4c 69 74 65 53  GetChars(SQLiteS
26e0: 74 61 74 65 6d 65 6e 74 20 73 74 6d 74 2c 20 69  tatement stmt, i
26f0: 6e 74 20 69 6e 64 65 78 2c 20 69 6e 74 20 6e 44  nt index, int nD
2700: 61 74 61 6f 66 66 73 65 74 2c 20 63 68 61 72 5b  ataoffset, char[
2710: 5d 20 62 44 65 73 74 2c 20 69 6e 74 20 6e 53 74  ] bDest, int nSt
2720: 61 72 74 2c 20 69 6e 74 20 6e 4c 65 6e 67 74 68  art, int nLength
2730: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2740: 20 61 62 73 74 72 61 63 74 20 44 61 74 65 54 69   abstract DateTi
2750: 6d 65 20 47 65 74 44 61 74 65 54 69 6d 65 28 53  me GetDateTime(S
2760: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
2770: 74 6d 74 2c 20 69 6e 74 20 69 6e 64 65 78 29 3b  tmt, int index);
2780: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2790: 62 73 74 72 61 63 74 20 62 6f 6f 6c 20 49 73 4e  bstract bool IsN
27a0: 75 6c 6c 28 53 51 4c 69 74 65 53 74 61 74 65 6d  ull(SQLiteStatem
27b0: 65 6e 74 20 73 74 6d 74 2c 20 69 6e 74 20 69 6e  ent stmt, int in
27c0: 64 65 78 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74  dex);....    int
27d0: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
27e0: 6f 69 64 20 43 72 65 61 74 65 43 6f 6c 6c 61 74  oid CreateCollat
27f0: 69 6f 6e 28 73 74 72 69 6e 67 20 73 74 72 43 6f  ion(string strCo
2800: 6c 6c 61 74 69 6f 6e 2c 20 53 51 4c 69 74 65 43  llation, SQLiteC
2810: 6f 6c 6c 61 74 69 6f 6e 20 66 75 6e 63 2c 20 53  ollation func, S
2820: 51 4c 69 74 65 43 6f 6c 6c 61 74 69 6f 6e 20 66  QLiteCollation f
2830: 75 6e 63 31 36 29 3b 0d 0a 20 20 20 20 69 6e 74  unc16);..    int
2840: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
2850: 6f 69 64 20 43 72 65 61 74 65 46 75 6e 63 74 69  oid CreateFuncti
2860: 6f 6e 28 73 74 72 69 6e 67 20 73 74 72 46 75 6e  on(string strFun
2870: 63 74 69 6f 6e 2c 20 69 6e 74 20 6e 41 72 67 73  ction, int nArgs
2880: 2c 20 62 6f 6f 6c 20 6e 65 65 64 43 6f 6c 6c 53  , bool needCollS
2890: 65 71 2c 20 53 51 4c 69 74 65 43 61 6c 6c 62 61  eq, SQLiteCallba
28a0: 63 6b 20 66 75 6e 63 2c 20 53 51 4c 69 74 65 43  ck func, SQLiteC
28b0: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 73 74 65 70  allback funcstep
28c0: 2c 20 53 51 4c 69 74 65 46 69 6e 61 6c 43 61 6c  , SQLiteFinalCal
28d0: 6c 62 61 63 6b 20 66 75 6e 63 66 69 6e 61 6c 29  lback funcfinal)
28e0: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
28f0: 61 62 73 74 72 61 63 74 20 43 6f 6c 6c 61 74 69  abstract Collati
2900: 6f 6e 53 65 71 75 65 6e 63 65 20 47 65 74 43 6f  onSequence GetCo
2910: 6c 6c 61 74 69 6f 6e 53 65 71 75 65 6e 63 65 28  llationSequence(
2920: 53 51 4c 69 74 65 46 75 6e 63 74 69 6f 6e 20 66  SQLiteFunction f
2930: 75 6e 63 2c 20 49 6e 74 50 74 72 20 63 6f 6e 74  unc, IntPtr cont
2940: 65 78 74 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  ext);..    inter
2950: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74  nal abstract int
2960: 20 43 6f 6e 74 65 78 74 43 6f 6c 6c 61 74 65 43   ContextCollateC
2970: 6f 6d 70 61 72 65 28 43 6f 6c 6c 61 74 69 6f 6e  ompare(Collation
2980: 45 6e 63 6f 64 69 6e 67 45 6e 75 6d 20 65 6e 63  EncodingEnum enc
2990: 2c 20 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74  , IntPtr context
29a0: 2c 20 73 74 72 69 6e 67 20 73 31 2c 20 73 74 72  , string s1, str
29b0: 69 6e 67 20 73 32 29 3b 0d 0a 20 20 20 20 69 6e  ing s2);..    in
29c0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
29d0: 69 6e 74 20 43 6f 6e 74 65 78 74 43 6f 6c 6c 61  int ContextColla
29e0: 74 65 43 6f 6d 70 61 72 65 28 43 6f 6c 6c 61 74  teCompare(Collat
29f0: 69 6f 6e 45 6e 63 6f 64 69 6e 67 45 6e 75 6d 20  ionEncodingEnum 
2a00: 65 6e 63 2c 20 49 6e 74 50 74 72 20 63 6f 6e 74  enc, IntPtr cont
2a10: 65 78 74 2c 20 63 68 61 72 5b 5d 20 63 31 2c 20  ext, char[] c1, 
2a20: 63 68 61 72 5b 5d 20 63 32 29 3b 0d 0a 0d 0a 20  char[] c2);.... 
2a30: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2a40: 72 61 63 74 20 69 6e 74 20 41 67 67 72 65 67 61  ract int Aggrega
2a50: 74 65 43 6f 75 6e 74 28 49 6e 74 50 74 72 20 63  teCount(IntPtr c
2a60: 6f 6e 74 65 78 74 29 3b 0d 0a 20 20 20 20 69 6e  ontext);..    in
2a70: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2a80: 49 6e 74 50 74 72 20 41 67 67 72 65 67 61 74 65  IntPtr Aggregate
2a90: 43 6f 6e 74 65 78 74 28 49 6e 74 50 74 72 20 63  Context(IntPtr c
2aa0: 6f 6e 74 65 78 74 29 3b 0d 0a 0d 0a 20 20 20 20  ontext);....    
2ab0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
2ac0: 74 20 6c 6f 6e 67 20 47 65 74 50 61 72 61 6d 56  t long GetParamV
2ad0: 61 6c 75 65 42 79 74 65 73 28 49 6e 74 50 74 72  alueBytes(IntPtr
2ae0: 20 70 74 72 2c 20 69 6e 74 20 6e 44 61 74 61 4f   ptr, int nDataO
2af0: 66 66 73 65 74 2c 20 62 79 74 65 5b 5d 20 62 44  ffset, byte[] bD
2b00: 65 73 74 2c 20 69 6e 74 20 6e 53 74 61 72 74 2c  est, int nStart,
2b10: 20 69 6e 74 20 6e 4c 65 6e 67 74 68 29 3b 0d 0a   int nLength);..
2b20: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73      internal abs
2b30: 74 72 61 63 74 20 64 6f 75 62 6c 65 20 47 65 74  tract double Get
2b40: 50 61 72 61 6d 56 61 6c 75 65 44 6f 75 62 6c 65  ParamValueDouble
2b50: 28 49 6e 74 50 74 72 20 70 74 72 29 3b 0d 0a 20  (IntPtr ptr);.. 
2b60: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2b70: 72 61 63 74 20 69 6e 74 20 47 65 74 50 61 72 61  ract int GetPara
2b80: 6d 56 61 6c 75 65 49 6e 74 33 32 28 49 6e 74 50  mValueInt32(IntP
2b90: 74 72 20 70 74 72 29 3b 0d 0a 20 20 20 20 69 6e  tr ptr);..    in
2ba0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2bb0: 49 6e 74 36 34 20 47 65 74 50 61 72 61 6d 56 61  Int64 GetParamVa
2bc0: 6c 75 65 49 6e 74 36 34 28 49 6e 74 50 74 72 20  lueInt64(IntPtr 
2bd0: 70 74 72 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  ptr);..    inter
2be0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 73 74 72  nal abstract str
2bf0: 69 6e 67 20 47 65 74 50 61 72 61 6d 56 61 6c 75  ing GetParamValu
2c00: 65 54 65 78 74 28 49 6e 74 50 74 72 20 70 74 72  eText(IntPtr ptr
2c10: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2c20: 20 61 62 73 74 72 61 63 74 20 54 79 70 65 41 66   abstract TypeAf
2c30: 66 69 6e 69 74 79 20 47 65 74 50 61 72 61 6d 56  finity GetParamV
2c40: 61 6c 75 65 54 79 70 65 28 49 6e 74 50 74 72 20  alueType(IntPtr 
2c50: 70 74 72 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74  ptr);....    int
2c60: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
2c70: 6f 69 64 20 52 65 74 75 72 6e 42 6c 6f 62 28 49  oid ReturnBlob(I
2c80: 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 62  ntPtr context, b
2c90: 79 74 65 5b 5d 20 76 61 6c 75 65 29 3b 0d 0a 20  yte[] value);.. 
2ca0: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
2cb0: 72 61 63 74 20 76 6f 69 64 20 52 65 74 75 72 6e  ract void Return
2cc0: 44 6f 75 62 6c 65 28 49 6e 74 50 74 72 20 63 6f  Double(IntPtr co
2cd0: 6e 74 65 78 74 2c 20 64 6f 75 62 6c 65 20 76 61  ntext, double va
2ce0: 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72  lue);..    inter
2cf0: 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f 69  nal abstract voi
2d00: 64 20 52 65 74 75 72 6e 45 72 72 6f 72 28 49 6e  d ReturnError(In
2d10: 74 50 74 72 20 63 6f 6e 74 65 78 74 2c 20 73 74  tPtr context, st
2d20: 72 69 6e 67 20 76 61 6c 75 65 29 3b 0d 0a 20 20  ring value);..  
2d30: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
2d40: 61 63 74 20 76 6f 69 64 20 52 65 74 75 72 6e 49  act void ReturnI
2d50: 6e 74 33 32 28 49 6e 74 50 74 72 20 63 6f 6e 74  nt32(IntPtr cont
2d60: 65 78 74 2c 20 49 6e 74 33 32 20 76 61 6c 75 65  ext, Int32 value
2d70: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
2d80: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 52   abstract void R
2d90: 65 74 75 72 6e 49 6e 74 36 34 28 49 6e 74 50 74  eturnInt64(IntPt
2da0: 72 20 63 6f 6e 74 65 78 74 2c 20 49 6e 74 36 34  r context, Int64
2db0: 20 76 61 6c 75 65 29 3b 0d 0a 20 20 20 20 69 6e   value);..    in
2dc0: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
2dd0: 76 6f 69 64 20 52 65 74 75 72 6e 4e 75 6c 6c 28  void ReturnNull(
2de0: 49 6e 74 50 74 72 20 63 6f 6e 74 65 78 74 29 3b  IntPtr context);
2df0: 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61  ..    internal a
2e00: 62 73 74 72 61 63 74 20 76 6f 69 64 20 52 65 74  bstract void Ret
2e10: 75 72 6e 54 65 78 74 28 49 6e 74 50 74 72 20 63  urnText(IntPtr c
2e20: 6f 6e 74 65 78 74 2c 20 73 74 72 69 6e 67 20 76  ontext, string v
2e30: 61 6c 75 65 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f  alue);....    //
2e40: 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20  / <summary>..   
2e50: 20 2f 2f 2f 20 45 6e 61 62 6c 65 73 20 6f 72 20   /// Enables or 
2e60: 64 69 73 61 62 6c 65 64 20 65 78 74 65 6e 65 64  disabled extened
2e70: 20 72 65 73 75 6c 74 20 63 6f 64 65 73 20 72 65   result codes re
2e80: 74 75 72 6e 65 64 20 62 79 20 53 51 4c 69 74 65  turned by SQLite
2e90: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  ..    /// </summ
2ea0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ary>..    /// <p
2eb0: 61 72 61 6d 20 6e 61 6d 65 3d 22 62 4f 6e 4f 66  aram name="bOnOf
2ec0: 66 22 3e 74 72 75 65 20 74 6f 20 65 6e 61 62 6c  f">true to enabl
2ed0: 65 20 65 78 74 65 6e 64 65 64 20 72 65 73 75 6c  e extended resul
2ee0: 74 20 63 6f 64 65 73 2c 20 66 61 6c 73 65 20 74  t codes, false t
2ef0: 6f 20 64 69 73 61 62 6c 65 2e 3c 2f 70 61 72 61  o disable.</para
2f00: 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74  m>..    /// <ret
2f10: 75 72 6e 73 3e 3c 2f 72 65 74 75 72 6e 73 3e 0d  urns></returns>.
2f20: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
2f30: 73 74 72 61 63 74 20 76 6f 69 64 20 53 65 74 45  stract void SetE
2f40: 78 74 65 6e 64 65 64 52 65 73 75 6c 74 43 6f 64  xtendedResultCod
2f50: 65 73 28 62 6f 6f 6c 20 62 4f 6e 4f 66 66 29 3b  es(bool bOnOff);
2f60: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
2f70: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74  ry>..    /// Ret
2f80: 75 72 6e 73 20 74 68 65 20 6e 75 6d 65 72 69 63  urns the numeric
2f90: 20 72 65 73 75 6c 74 20 63 6f 64 65 20 66 6f 72   result code for
2fa0: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74   the most recent
2fb0: 20 66 61 69 6c 65 64 20 53 51 4c 69 74 65 20 41   failed SQLite A
2fc0: 50 49 20 63 61 6c 6c 20 0d 0a 20 20 20 20 2f 2f  PI call ..    //
2fd0: 2f 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  / associated wit
2fe0: 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63  h the database c
2ff0: 6f 6e 6e 65 63 74 69 6f 6e 2e 20 0d 0a 20 20 20  onnection. ..   
3000: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
3010: 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e  .    /// <return
3020: 73 3e 52 65 73 75 6c 74 20 63 6f 64 65 3c 2f 72  s>Result code</r
3030: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74  eturns>..    int
3040: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 69  ernal abstract i
3050: 6e 74 20 52 65 73 75 6c 74 43 6f 64 65 28 29 3b  nt ResultCode();
3060: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
3070: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 52 65 74  ry>..    /// Ret
3080: 75 72 6e 73 20 74 68 65 20 65 78 74 65 6e 64 65  urns the extende
3090: 64 20 6e 75 6d 65 72 69 63 20 72 65 73 75 6c 74  d numeric result
30a0: 20 63 6f 64 65 20 66 6f 72 20 74 68 65 20 6d 6f   code for the mo
30b0: 73 74 20 72 65 63 65 6e 74 20 66 61 69 6c 65 64  st recent failed
30c0: 20 53 51 4c 69 74 65 20 41 50 49 20 63 61 6c 6c   SQLite API call
30d0: 20 0d 0a 20 20 20 20 2f 2f 2f 20 61 73 73 6f 63   ..    /// assoc
30e0: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 64  iated with the d
30f0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
3100: 6f 6e 2e 20 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  on. ..    /// </
3110: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
3120: 2f 20 3c 72 65 74 75 72 6e 73 3e 45 78 74 65 6e  / <returns>Exten
3130: 64 65 64 20 72 65 73 75 6c 74 20 63 6f 64 65 3c  ded result code<
3140: 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69  /returns>..    i
3150: 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74  nternal abstract
3160: 20 69 6e 74 20 45 78 74 65 6e 64 65 64 52 65 73   int ExtendedRes
3170: 75 6c 74 43 6f 64 65 28 29 3b 0d 0a 0d 0a 20 20  ultCode();....  
3180: 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d    /// <summary>.
3190: 0a 20 20 20 20 2f 2f 2f 20 41 64 64 20 61 20 6c  .    /// Add a l
31a0: 6f 67 20 6d 65 73 73 61 67 65 20 76 69 61 20 74  og message via t
31b0: 68 65 20 53 51 4c 69 74 65 20 73 71 6c 69 74 65  he SQLite sqlite
31c0: 33 5f 6c 6f 67 20 69 6e 74 65 72 66 61 63 65 2e  3_log interface.
31d0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d  ..    /// </summ
31e0: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70  ary>..    /// <p
31f0: 61 72 61 6d 20 6e 61 6d 65 3d 22 69 45 72 72 43  aram name="iErrC
3200: 6f 64 65 22 3e 45 72 72 6f 72 20 63 6f 64 65 20  ode">Error code 
3210: 74 6f 20 62 65 20 6c 6f 67 67 65 64 20 77 69 74  to be logged wit
3220: 68 20 74 68 65 20 6d 65 73 73 61 67 65 2e 3c 2f  h the message.</
3230: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
3240: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 7a 4d 65  <param name="zMe
3250: 73 73 61 67 65 22 3e 53 74 72 69 6e 67 20 74 6f  ssage">String to
3260: 20 62 65 20 6c 6f 67 67 65 64 2e 20 20 55 6e 6c   be logged.  Unl
3270: 69 6b 65 20 74 68 65 20 53 51 4c 69 74 65 20 73  ike the SQLite s
3280: 71 6c 69 74 65 33 5f 6c 6f 67 28 29 20 0d 0a 20  qlite3_log() .. 
3290: 20 20 20 2f 2f 2f 20 69 6e 74 65 72 66 61 63 65     /// interface
32a0: 2c 20 74 68 69 73 20 73 68 6f 75 6c 64 20 62 65  , this should be
32b0: 20 70 72 65 2d 66 6f 72 6d 61 74 74 65 64 2e 20   pre-formatted. 
32c0: 20 43 6f 6e 73 69 64 65 72 20 75 73 69 6e 67 20   Consider using 
32d0: 74 68 65 20 0d 0a 20 20 20 20 2f 2f 2f 20 53 74  the ..    /// St
32e0: 72 69 6e 67 2e 46 6f 72 6d 61 74 28 29 20 66 75  ring.Format() fu
32f0: 6e 63 74 69 6f 6e 2e 3c 2f 70 61 72 61 6d 3e 0d  nction.</param>.
3300: 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e  .    /// <return
3310: 73 3e 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20  s></returns>..  
3320: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
3330: 61 63 74 20 76 6f 69 64 20 4c 6f 67 4d 65 73 73  act void LogMess
3340: 61 67 65 28 69 6e 74 20 69 45 72 72 43 6f 64 65  age(int iErrCode
3350: 2c 20 73 74 72 69 6e 67 20 7a 4d 65 73 73 61 67  , string zMessag
3360: 65 29 3b 0d 0a 0d 0a 23 69 66 20 49 4e 54 45 52  e);....#if INTER
3370: 4f 50 5f 43 4f 44 45 43 0d 0a 20 20 20 20 69 6e  OP_CODEC..    in
3380: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3390: 76 6f 69 64 20 53 65 74 50 61 73 73 77 6f 72 64  void SetPassword
33a0: 28 62 79 74 65 5b 5d 20 70 61 73 73 77 6f 72 64  (byte[] password
33b0: 42 79 74 65 73 29 3b 0d 0a 20 20 20 20 69 6e 74  Bytes);..    int
33c0: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76  ernal abstract v
33d0: 6f 69 64 20 43 68 61 6e 67 65 50 61 73 73 77 6f  oid ChangePasswo
33e0: 72 64 28 62 79 74 65 5b 5d 20 6e 65 77 50 61 73  rd(byte[] newPas
33f0: 73 77 6f 72 64 42 79 74 65 73 29 3b 0d 0a 23 65  swordBytes);..#e
3400: 6e 64 69 66 0d 0a 0d 0a 20 20 20 20 69 6e 74 65  ndif....    inte
3410: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
3420: 69 64 20 53 65 74 55 70 64 61 74 65 48 6f 6f 6b  id SetUpdateHook
3430: 28 53 51 4c 69 74 65 55 70 64 61 74 65 43 61 6c  (SQLiteUpdateCal
3440: 6c 62 61 63 6b 20 66 75 6e 63 29 3b 0d 0a 20 20  lback func);..  
3450: 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72    internal abstr
3460: 61 63 74 20 76 6f 69 64 20 53 65 74 43 6f 6d 6d  act void SetComm
3470: 69 74 48 6f 6f 6b 28 53 51 4c 69 74 65 43 6f 6d  itHook(SQLiteCom
3480: 6d 69 74 43 61 6c 6c 62 61 63 6b 20 66 75 6e 63  mitCallback func
3490: 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  );..    internal
34a0: 20 61 62 73 74 72 61 63 74 20 76 6f 69 64 20 53   abstract void S
34b0: 65 74 54 72 61 63 65 43 61 6c 6c 62 61 63 6b 28  etTraceCallback(
34c0: 53 51 4c 69 74 65 54 72 61 63 65 43 61 6c 6c 62  SQLiteTraceCallb
34d0: 61 63 6b 20 66 75 6e 63 29 3b 0d 0a 20 20 20 20  ack func);..    
34e0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
34f0: 74 20 76 6f 69 64 20 53 65 74 52 6f 6c 6c 62 61  t void SetRollba
3500: 63 6b 48 6f 6f 6b 28 53 51 4c 69 74 65 52 6f 6c  ckHook(SQLiteRol
3510: 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 20 66 75  lbackCallback fu
3520: 6e 63 29 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e  nc);..    intern
3530: 61 6c 20 61 62 73 74 72 61 63 74 20 69 6e 74 20  al abstract int 
3540: 53 65 74 4c 6f 67 43 61 6c 6c 62 61 63 6b 28 53  SetLogCallback(S
3550: 51 4c 69 74 65 4c 6f 67 43 61 6c 6c 62 61 63 6b  QLiteLogCallback
3560: 20 66 75 6e 63 29 3b 0d 0a 0d 0a 20 20 20 20 2f   func);....    /
3570: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
3580: 20 20 2f 2f 2f 20 43 68 65 63 6b 73 20 69 66 20    /// Checks if 
3590: 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65 20  the SQLite core 
35a0: 6c 69 62 72 61 72 79 20 68 61 73 20 62 65 65 6e  library has been
35b0: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 6e 20   initialized in 
35c0: 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f 63  the current proc
35d0: 65 73 73 2e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 2f  ess...    /// </
35e0: 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 2f 2f  summary>..    //
35f0: 2f 20 3c 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20  / <returns>..   
3600: 20 2f 2f 2f 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66   /// Non-zero if
3610: 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f 72 65   the SQLite core
3620: 20 6c 69 62 72 61 72 79 20 68 61 73 20 62 65 65   library has bee
3630: 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 69 6e  n initialized in
3640: 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 72 6f   the current pro
3650: 63 65 73 73 2c 0d 0a 20 20 20 20 2f 2f 2f 20 7a  cess,..    /// z
3660: 65 72 6f 20 6f 74 68 65 72 77 69 73 65 2e 0d 0a  ero otherwise...
3670: 20 20 20 20 2f 2f 2f 20 3c 2f 72 65 74 75 72 6e      /// </return
3680: 73 3e 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  s>..    internal
3690: 20 61 62 73 74 72 61 63 74 20 62 6f 6f 6c 20 49   abstract bool I
36a0: 73 49 6e 69 74 69 61 6c 69 7a 65 64 28 29 3b 0d  sInitialized();.
36b0: 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ...    internal 
36c0: 61 62 73 74 72 61 63 74 20 69 6e 74 20 47 65 74  abstract int Get
36d0: 43 75 72 73 6f 72 46 6f 72 54 61 62 6c 65 28 53  CursorForTable(S
36e0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20 73  QLiteStatement s
36f0: 74 6d 74 2c 20 69 6e 74 20 64 61 74 61 62 61 73  tmt, int databas
3700: 65 2c 20 69 6e 74 20 72 6f 6f 74 50 61 67 65 29  e, int rootPage)
3710: 3b 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ;..    internal 
3720: 61 62 73 74 72 61 63 74 20 6c 6f 6e 67 20 47 65  abstract long Ge
3730: 74 52 6f 77 49 64 46 6f 72 43 75 72 73 6f 72 28  tRowIdForCursor(
3740: 53 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 20  SQLiteStatement 
3750: 73 74 6d 74 2c 20 69 6e 74 20 63 75 72 73 6f 72  stmt, int cursor
3760: 29 3b 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e  );....    intern
3770: 61 6c 20 61 62 73 74 72 61 63 74 20 6f 62 6a 65  al abstract obje
3780: 63 74 20 47 65 74 56 61 6c 75 65 28 53 51 4c 69  ct GetValue(SQLi
3790: 74 65 53 74 61 74 65 6d 65 6e 74 20 73 74 6d 74  teStatement stmt
37a0: 2c 20 69 6e 74 20 69 6e 64 65 78 2c 20 53 51 4c  , int index, SQL
37b0: 69 74 65 54 79 70 65 20 74 79 70 29 3b 0d 0a 0d  iteType typ);...
37c0: 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62  .    internal ab
37d0: 73 74 72 61 63 74 20 62 6f 6f 6c 20 41 75 74 6f  stract bool Auto
37e0: 43 6f 6d 6d 69 74 0d 0a 20 20 20 20 7b 0d 0a 20  Commit..    {.. 
37f0: 20 20 20 20 20 67 65 74 3b 0d 0a 20 20 20 20 7d       get;..    }
3800: 0d 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c  ....    internal
3810: 20 61 62 73 74 72 61 63 74 20 69 6e 74 20 46 69   abstract int Fi
3820: 6c 65 43 6f 6e 74 72 6f 6c 28 73 74 72 69 6e 67  leControl(string
3830: 20 7a 44 62 4e 61 6d 65 2c 20 69 6e 74 20 6f 70   zDbName, int op
3840: 2c 20 49 6e 74 50 74 72 20 70 41 72 67 29 3b 0d  , IntPtr pArg);.
3850: 0a 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  ...    /// <summ
3860: 61 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43 72  ary>..    /// Cr
3870: 65 61 74 65 73 20 61 20 6e 65 77 20 53 51 4c 69  eates a new SQLi
3880: 74 65 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74  te backup object
3890: 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 70 72   based on the pr
38a0: 6f 76 69 64 65 64 20 64 65 73 74 69 6e 61 74 69  ovided destinati
38b0: 6f 6e 0d 0a 20 20 20 20 2f 2f 2f 20 64 61 74 61  on..    /// data
38c0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e  base connection.
38d0: 20 20 54 68 65 20 73 6f 75 72 63 65 20 64 61 74    The source dat
38e0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
38f0: 20 69 73 20 74 68 65 20 6f 6e 65 0d 0a 20 20 20   is the one..   
3900: 20 2f 2f 2f 20 61 73 73 6f 63 69 61 74 65 64 20   /// associated 
3910: 77 69 74 68 20 74 68 69 73 20 6f 62 6a 65 63 74  with this object
3920: 2e 20 20 54 68 65 20 73 6f 75 72 63 65 20 61 6e  .  The source an
3930: 64 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61  d destination da
3940: 74 61 62 61 73 65 0d 0a 20 20 20 20 2f 2f 2f 20  tabase..    /// 
3950: 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 63 61 6e 6e  connections cann
3960: 6f 74 20 62 65 20 74 68 65 20 73 61 6d 65 2e 0d  ot be the same..
3970: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61  .    /// </summa
3980: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61  ry>..    /// <pa
3990: 72 61 6d 20 6e 61 6d 65 3d 22 64 65 73 74 43 6e  ram name="destCn
39a0: 6e 22 3e 54 68 65 20 64 65 73 74 69 6e 61 74 69  n">The destinati
39b0: 6f 6e 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  on database conn
39c0: 65 63 74 69 6f 6e 2e 3c 2f 70 61 72 61 6d 3e 0d  ection.</param>.
39d0: 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20  .    /// <param 
39e0: 6e 61 6d 65 3d 22 64 65 73 74 4e 61 6d 65 22 3e  name="destName">
39f0: 54 68 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 20  The destination 
3a00: 64 61 74 61 62 61 73 65 20 6e 61 6d 65 2e 3c 2f  database name.</
3a10: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 2f 2f 2f 20  param>..    /// 
3a20: 3c 70 61 72 61 6d 20 6e 61 6d 65 3d 22 73 6f 75  <param name="sou
3a30: 72 63 65 4e 61 6d 65 22 3e 54 68 65 20 73 6f 75  rceName">The sou
3a40: 72 63 65 20 64 61 74 61 62 61 73 65 20 6e 61 6d  rce database nam
3a50: 65 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20 20 20  e.</param>..    
3a60: 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54 68 65  /// <returns>The
3a70: 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 62   newly created b
3a80: 61 63 6b 75 70 20 6f 62 6a 65 63 74 2e 3c 2f 72  ackup object.</r
3a90: 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e 74  eturns>..    int
3aa0: 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 53  ernal abstract S
3ab0: 51 4c 69 74 65 42 61 63 6b 75 70 20 49 6e 69 74  QLiteBackup Init
3ac0: 69 61 6c 69 7a 65 42 61 63 6b 75 70 28 0d 0a 20  ializeBackup(.. 
3ad0: 20 20 20 20 20 20 20 53 51 4c 69 74 65 43 6f 6e         SQLiteCon
3ae0: 6e 65 63 74 69 6f 6e 20 64 65 73 74 43 6e 6e 2c  nection destCnn,
3af0: 20 73 74 72 69 6e 67 20 64 65 73 74 4e 61 6d 65   string destName
3b00: 2c 0d 0a 20 20 20 20 20 20 20 20 73 74 72 69 6e  ,..        strin
3b10: 67 20 73 6f 75 72 63 65 4e 61 6d 65 29 3b 0d 0a  g sourceName);..
3b20: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61  ..    /// <summa
3b30: 72 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 43 6f 70  ry>..    /// Cop
3b40: 69 65 73 20 75 70 20 74 6f 20 4e 20 70 61 67 65  ies up to N page
3b50: 73 20 66 72 6f 6d 20 74 68 65 20 73 6f 75 72 63  s from the sourc
3b60: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 74 68  e database to th
3b70: 65 20 64 65 73 74 69 6e 61 74 69 6f 6e 0d 0a 20  e destination.. 
3b80: 20 20 20 2f 2f 2f 20 64 61 74 61 62 61 73 65 20     /// database 
3b90: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
3ba0: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 62 61  the specified ba
3bb0: 63 6b 75 70 20 6f 62 6a 65 63 74 2e 0d 0a 20 20  ckup object...  
3bc0: 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e    /// </summary>
3bd0: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
3be0: 20 6e 61 6d 65 3d 22 62 61 63 6b 75 70 22 3e 54   name="backup">T
3bf0: 68 65 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74  he backup object
3c00: 20 74 6f 20 75 73 65 2e 3c 2f 70 61 72 61 6d 3e   to use.</param>
3c10: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d  ..    /// <param
3c20: 20 6e 61 6d 65 3d 22 6e 50 61 67 65 22 3e 0d 0a   name="nPage">..
3c30: 20 20 20 20 2f 2f 2f 20 54 68 65 20 6e 75 6d 62      /// The numb
3c40: 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20 63  er of pages to c
3c50: 6f 70 79 20 6f 72 20 6e 65 67 61 74 69 76 65 20  opy or negative 
3c60: 74 6f 20 63 6f 70 79 20 61 6c 6c 20 72 65 6d 61  to copy all rema
3c70: 69 6e 69 6e 67 20 70 61 67 65 73 2e 0d 0a 20 20  ining pages...  
3c80: 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d 3e 0d 0a    /// </param>..
3c90: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
3ca0: 61 6d 65 3d 22 72 65 74 72 79 22 3e 0d 0a 20 20  ame="retry">..  
3cb0: 20 20 2f 2f 2f 20 53 65 74 20 74 6f 20 74 72 75    /// Set to tru
3cc0: 65 20 69 66 20 74 68 65 20 6f 70 65 72 61 74 69  e if the operati
3cd0: 6f 6e 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72  on needs to be r
3ce0: 65 74 72 69 65 64 20 64 75 65 20 74 6f 20 64 61  etried due to da
3cf0: 74 61 62 61 73 65 0d 0a 20 20 20 20 2f 2f 2f 20  tabase..    /// 
3d00: 6c 6f 63 6b 69 6e 67 20 69 73 73 75 65 73 2e 0d  locking issues..
3d10: 0a 20 20 20 20 2f 2f 2f 20 3c 2f 70 61 72 61 6d  .    /// </param
3d20: 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75  >..    /// <retu
3d30: 72 6e 73 3e 0d 0a 20 20 20 20 2f 2f 2f 20 54 72  rns>..    /// Tr
3d40: 75 65 20 69 66 20 74 68 65 72 65 20 61 72 65 20  ue if there are 
3d50: 6d 6f 72 65 20 70 61 67 65 73 20 74 6f 20 62 65  more pages to be
3d60: 20 63 6f 70 69 65 64 2c 20 66 61 6c 73 65 20 6f   copied, false o
3d70: 74 68 65 72 77 69 73 65 2e 0d 0a 20 20 20 20 2f  therwise...    /
3d80: 2f 2f 20 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20  // </returns>.. 
3d90: 20 20 20 69 6e 74 65 72 6e 61 6c 20 61 62 73 74     internal abst
3da0: 72 61 63 74 20 62 6f 6f 6c 20 53 74 65 70 42 61  ract bool StepBa
3db0: 63 6b 75 70 28 53 51 4c 69 74 65 42 61 63 6b 75  ckup(SQLiteBacku
3dc0: 70 20 62 61 63 6b 75 70 2c 20 69 6e 74 20 6e 50  p backup, int nP
3dd0: 61 67 65 2c 20 6f 75 74 20 62 6f 6f 6c 20 72 65  age, out bool re
3de0: 74 72 79 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f  try);....    ///
3df0: 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20   <summary>..    
3e00: 2f 2f 2f 20 52 65 74 75 72 6e 73 20 74 68 65 20  /// Returns the 
3e10: 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20  number of pages 
3e20: 72 65 6d 61 69 6e 69 6e 67 20 74 6f 20 62 65 20  remaining to be 
3e30: 63 6f 70 69 65 64 20 66 72 6f 6d 20 74 68 65 20  copied from the 
3e40: 73 6f 75 72 63 65 0d 0a 20 20 20 20 2f 2f 2f 20  source..    /// 
3e50: 64 61 74 61 62 61 73 65 20 74 6f 20 74 68 65 20  database to the 
3e60: 64 65 73 74 69 6e 61 74 69 6f 6e 20 64 61 74 61  destination data
3e70: 62 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20  base associated 
3e80: 77 69 74 68 20 74 68 65 20 73 70 65 63 69 66 69  with the specifi
3e90: 65 64 0d 0a 20 20 20 20 2f 2f 2f 20 62 61 63 6b  ed..    /// back
3ea0: 75 70 20 6f 62 6a 65 63 74 2e 0d 0a 20 20 20 20  up object...    
3eb0: 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a  /// </summary>..
3ec0: 20 20 20 20 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e      /// <param n
3ed0: 61 6d 65 3d 22 62 61 63 6b 75 70 22 3e 54 68 65  ame="backup">The
3ee0: 20 62 61 63 6b 75 70 20 6f 62 6a 65 63 74 20 74   backup object t
3ef0: 6f 20 63 68 65 63 6b 2e 3c 2f 70 61 72 61 6d 3e  o check.</param>
3f00: 0d 0a 20 20 20 20 2f 2f 2f 20 3c 72 65 74 75 72  ..    /// <retur
3f10: 6e 73 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  ns>The number of
3f20: 20 70 61 67 65 73 20 72 65 6d 61 69 6e 69 6e 67   pages remaining
3f30: 20 74 6f 20 62 65 20 63 6f 70 69 65 64 2e 3c 2f   to be copied.</
3f40: 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20 69 6e  returns>..    in
3f50: 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20  ternal abstract 
3f60: 69 6e 74 20 52 65 6d 61 69 6e 69 6e 67 42 61 63  int RemainingBac
3f70: 6b 75 70 28 53 51 4c 69 74 65 42 61 63 6b 75 70  kup(SQLiteBackup
3f80: 20 62 61 63 6b 75 70 29 3b 0d 0a 0d 0a 20 20 20   backup);....   
3f90: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
3fa0: 20 20 20 20 2f 2f 2f 20 52 65 74 75 72 6e 73 20      /// Returns 
3fb0: 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  the total number
3fc0: 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65   of pages in the
3fd0: 20 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65   source database
3fe0: 20 61 73 73 6f 63 69 61 74 65 64 0d 0a 20 20 20   associated..   
3ff0: 20 2f 2f 2f 20 77 69 74 68 20 74 68 65 20 73 70   /// with the sp
4000: 65 63 69 66 69 65 64 20 62 61 63 6b 75 70 20 6f  ecified backup o
4010: 62 6a 65 63 74 2e 0d 0a 20 20 20 20 2f 2f 2f 20  bject...    /// 
4020: 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20  </summary>..    
4030: 2f 2f 2f 20 3c 70 61 72 61 6d 20 6e 61 6d 65 3d  /// <param name=
4040: 22 62 61 63 6b 75 70 22 3e 54 68 65 20 62 61 63  "backup">The bac
4050: 6b 75 70 20 6f 62 6a 65 63 74 20 74 6f 20 63 68  kup object to ch
4060: 65 63 6b 2e 3c 2f 70 61 72 61 6d 3e 0d 0a 20 20  eck.</param>..  
4070: 20 20 2f 2f 2f 20 3c 72 65 74 75 72 6e 73 3e 54    /// <returns>T
4080: 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20  he total number 
4090: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20  of pages in the 
40a0: 73 6f 75 72 63 65 20 64 61 74 61 62 61 73 65 2e  source database.
40b0: 3c 2f 72 65 74 75 72 6e 73 3e 0d 0a 20 20 20 20  </returns>..    
40c0: 69 6e 74 65 72 6e 61 6c 20 61 62 73 74 72 61 63  internal abstrac
40d0: 74 20 69 6e 74 20 50 61 67 65 43 6f 75 6e 74 42  t int PageCountB
40e0: 61 63 6b 75 70 28 53 51 4c 69 74 65 42 61 63 6b  ackup(SQLiteBack
40f0: 75 70 20 62 61 63 6b 75 70 29 3b 0d 0a 0d 0a 20  up backup);.... 
4100: 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e     /// <summary>
4110: 0d 0a 20 20 20 20 2f 2f 2f 20 44 65 73 74 72 6f  ..    /// Destro
4120: 79 73 20 74 68 65 20 62 61 63 6b 75 70 20 6f 62  ys the backup ob
4130: 6a 65 63 74 2c 20 72 6f 6c 6c 69 6e 67 20 62 61  ject, rolling ba
4140: 63 6b 20 61 6e 79 20 62 61 63 6b 75 70 20 74 68  ck any backup th
4150: 61 74 20 6d 61 79 20 62 65 20 69 6e 0d 0a 20 20  at may be in..  
4160: 20 20 2f 2f 2f 20 70 72 6f 67 65 73 73 2e 0d 0a    /// progess...
4170: 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72      /// </summar
4180: 79 3e 0d 0a 20 20 20 20 2f 2f 2f 20 3c 70 61 72  y>..    /// <par
4190: 61 6d 20 6e 61 6d 65 3d 22 62 61 63 6b 75 70 22  am name="backup"
41a0: 3e 54 68 65 20 62 61 63 6b 75 70 20 6f 62 6a 65  >The backup obje
41b0: 63 74 20 74 6f 20 64 65 73 74 72 6f 79 2e 3c 2f  ct to destroy.</
41c0: 70 61 72 61 6d 3e 0d 0a 20 20 20 20 69 6e 74 65  param>..    inte
41d0: 72 6e 61 6c 20 61 62 73 74 72 61 63 74 20 76 6f  rnal abstract vo
41e0: 69 64 20 46 69 6e 69 73 68 42 61 63 6b 75 70 28  id FinishBackup(
41f0: 53 51 4c 69 74 65 42 61 63 6b 75 70 20 62 61 63  SQLiteBackup bac
4200: 6b 75 70 29 3b 0d 0a 0d 0a 20 20 20 20 2f 2f 2f  kup);....    ///
4210: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4220: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4230: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4240: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4250: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4260: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a  ////////////....
4270: 20 20 20 20 23 72 65 67 69 6f 6e 20 49 44 69 73      #region IDis
4280: 70 6f 73 61 62 6c 65 20 4d 65 6d 62 65 72 73 0d  posable Members.
4290: 0a 20 20 20 20 70 75 62 6c 69 63 20 76 6f 69 64  .    public void
42a0: 20 44 69 73 70 6f 73 65 28 29 0d 0a 20 20 20 20   Dispose()..    
42b0: 7b 0d 0a 20 20 20 20 20 20 20 20 44 69 73 70 6f  {..        Dispo
42c0: 73 65 28 74 72 75 65 29 3b 0d 0a 20 20 20 20 20  se(true);..     
42d0: 20 20 20 47 43 2e 53 75 70 70 72 65 73 73 46 69     GC.SuppressFi
42e0: 6e 61 6c 69 7a 65 28 74 68 69 73 29 3b 0d 0a 20  nalize(this);.. 
42f0: 20 20 20 7d 0d 0a 20 20 20 20 23 65 6e 64 72 65     }..    #endre
4300: 67 69 6f 6e 0d 0a 0d 0a 20 20 20 20 2f 2f 2f 2f  gion....    ////
4310: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4320: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4330: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4340: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4350: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4360: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20  ///////////.... 
4370: 20 20 20 23 72 65 67 69 6f 6e 20 49 44 69 73 70     #region IDisp
4380: 6f 73 61 62 6c 65 20 22 50 61 74 74 65 72 6e 22  osable "Pattern"
4390: 20 4d 65 6d 62 65 72 73 0d 0a 20 20 20 20 70 72   Members..    pr
43a0: 69 76 61 74 65 20 62 6f 6f 6c 20 64 69 73 70 6f  ivate bool dispo
43b0: 73 65 64 3b 0d 0a 20 20 20 20 70 72 69 76 61 74  sed;..    privat
43c0: 65 20 76 6f 69 64 20 43 68 65 63 6b 44 69 73 70  e void CheckDisp
43d0: 6f 73 65 64 28 29 20 2f 2a 20 74 68 72 6f 77 20  osed() /* throw 
43e0: 2a 2f 0d 0a 20 20 20 20 7b 0d 0a 23 69 66 20 54  */..    {..#if T
43f0: 48 52 4f 57 5f 4f 4e 5f 44 49 53 50 4f 53 45 44  HROW_ON_DISPOSED
4400: 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28 64 69  ..        if (di
4410: 73 70 6f 73 65 64 29 0d 0a 20 20 20 20 20 20 20  sposed)..       
4420: 20 20 20 20 20 74 68 72 6f 77 20 6e 65 77 20 4f       throw new O
4430: 62 6a 65 63 74 44 69 73 70 6f 73 65 64 45 78 63  bjectDisposedExc
4440: 65 70 74 69 6f 6e 28 74 79 70 65 6f 66 28 53 51  eption(typeof(SQ
4450: 4c 69 74 65 42 61 73 65 29 2e 4e 61 6d 65 29 3b  LiteBase).Name);
4460: 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 7d 0d  ..#endif..    }.
4470: 0a 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f  ...    /////////
4480: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4490: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
44a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
44b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
44c0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
44d0: 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 70 72  //////....    pr
44e0: 6f 74 65 63 74 65 64 20 76 69 72 74 75 61 6c 20  otected virtual 
44f0: 76 6f 69 64 20 44 69 73 70 6f 73 65 28 62 6f 6f  void Dispose(boo
4500: 6c 20 64 69 73 70 6f 73 69 6e 67 29 0d 0a 20 20  l disposing)..  
4510: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 69 66 20    {..        if 
4520: 28 21 64 69 73 70 6f 73 65 64 29 0d 0a 20 20 20  (!disposed)..   
4530: 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20       {..        
4540: 20 20 20 20 2f 2f 69 66 20 28 64 69 73 70 6f 73      //if (dispos
4550: 69 6e 67 29 0d 0a 20 20 20 20 20 20 20 20 20 20  ing)..          
4560: 20 20 2f 2f 7b 0d 0a 20 20 20 20 20 20 20 20 20    //{..         
4570: 20 20 20 2f 2f 20 20 20 20 2f 2f 2f 2f 2f 2f 2f     //    ///////
4580: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4590: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20  /////////////.. 
45a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 20 20             //   
45b0: 20 2f 2f 20 64 69 73 70 6f 73 65 20 6d 61 6e 61   // dispose mana
45c0: 67 65 64 20 72 65 73 6f 75 72 63 65 73 20 68 65  ged resources he
45d0: 72 65 2e 2e 2e 0d 0a 20 20 20 20 20 20 20 20 20  re.....         
45e0: 20 20 20 2f 2f 20 20 20 20 2f 2f 2f 2f 2f 2f 2f     //    ///////
45f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4600: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 20  /////////////.. 
4610: 20 20 20 20 20 20 20 20 20 20 20 2f 2f 7d 0d 0a             //}..
4620: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f  ..            //
4630: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4640: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4650: 2f 2f 2f 2f 0d 0a 20 20 20 20 20 20 20 20 20 20  ////..          
4660: 20 20 2f 2f 20 72 65 6c 65 61 73 65 20 75 6e 6d    // release unm
4670: 61 6e 61 67 65 64 20 72 65 73 6f 75 72 63 65 73  anaged resources
4680: 20 68 65 72 65 2e 2e 2e 0d 0a 20 20 20 20 20 20   here.....      
4690: 20 20 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f        //////////
46a0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
46b0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 0d 0a 0d 0a  ////////////....
46c0: 20 20 20 20 20 20 20 20 20 20 20 20 64 69 73 70              disp
46d0: 6f 73 65 64 20 3d 20 74 72 75 65 3b 0d 0a 20 20  osed = true;..  
46e0: 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 7d 0d 0a        }..    }..
46f0: 20 20 20 20 23 65 6e 64 72 65 67 69 6f 6e 0d 0a      #endregion..
4700: 0d 0a 20 20 20 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ..    //////////
4710: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4720: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4730: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4740: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4750: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4760: 2f 2f 2f 2f 2f 0d 0a 0d 0a 20 20 20 20 23 72 65  /////....    #re
4770: 67 69 6f 6e 20 44 65 73 74 72 75 63 74 6f 72 0d  gion Destructor.
4780: 0a 20 20 20 20 7e 53 51 4c 69 74 65 42 61 73 65  .    ~SQLiteBase
4790: 28 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  ()..    {..     
47a0: 20 20 20 44 69 73 70 6f 73 65 28 66 61 6c 73 65     Dispose(false
47b0: 29 3b 0d 0a 20 20 20 20 7d 0d 0a 20 20 20 20 23  );..    }..    #
47c0: 65 6e 64 72 65 67 69 6f 6e 0d 0a 0d 0a 20 20 20  endregion....   
47d0: 20 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f   ///////////////
47e0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
47f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4800: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4810: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4820: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f  ////////////////
4830: 0d 0a 0d 0a 20 20 20 20 2f 2f 20 54 68 65 73 65  ....    // These
4840: 20 73 74 61 74 69 63 73 20 61 72 65 20 68 65 72   statics are her
4850: 65 20 66 6f 72 20 6c 61 63 6b 20 6f 66 20 61 20  e for lack of a 
4860: 62 65 74 74 65 72 20 70 6c 61 63 65 20 74 6f 20  better place to 
4870: 70 75 74 20 74 68 65 6d 2e 0d 0a 20 20 20 20 2f  put them...    /
4880: 2f 20 54 68 65 79 20 65 78 69 73 74 20 68 65 72  / They exist her
4890: 65 20 62 65 63 61 75 73 65 20 74 68 65 79 20 61  e because they a
48a0: 72 65 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67  re called during
48b0: 20 74 68 65 20 66 69 6e 61 6c 69 7a 61 74 69 6f   the finalizatio
48c0: 6e 20 6f 66 0d 0a 20 20 20 20 2f 2f 20 61 20 53  n of..    // a S
48d0: 51 4c 69 74 65 53 74 61 74 65 6d 65 6e 74 48 61  QLiteStatementHa
48e0: 6e 64 6c 65 2c 20 53 51 4c 69 74 65 43 6f 6e 6e  ndle, SQLiteConn
48f0: 65 63 74 69 6f 6e 48 61 6e 64 6c 65 2c 20 61 6e  ectionHandle, an
4900: 64 20 53 51 4c 69 74 65 46 75 6e 63 74 69 6f 6e  d SQLiteFunction
4910: 43 6f 6f 6b 69 65 48 61 6e 64 6c 65 2e 0d 0a 20  CookieHandle... 
4920: 20 20 20 2f 2f 20 54 68 65 72 65 66 6f 72 65 20     // Therefore 
4930: 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20  these functions 
4940: 68 61 76 65 20 74 6f 20 62 65 20 73 74 61 74 69  have to be stati
4950: 63 2c 20 61 6e 64 20 68 61 76 65 20 74 6f 20 62  c, and have to b
4960: 65 20 6c 6f 77 2d 6c 65 76 65 6c 2e 0d 0a 0d 0a  e low-level.....
4970: 20 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74 61      internal sta
4980: 74 69 63 20 73 74 72 69 6e 67 20 47 65 74 4c 61  tic string GetLa
4990: 73 74 45 72 72 6f 72 28 53 51 4c 69 74 65 43 6f  stError(SQLiteCo
49a0: 6e 6e 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20 68  nnectionHandle h
49b0: 64 6c 2c 20 49 6e 74 50 74 72 20 64 62 29 0d 0a  dl, IntPtr db)..
49c0: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 69      {..        i
49d0: 66 20 28 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29  f ((hdl == null)
49e0: 20 7c 7c 20 28 64 62 20 3d 3d 20 49 6e 74 50 74   || (db == IntPt
49f0: 72 2e 5a 65 72 6f 29 29 0d 0a 20 20 20 20 20 20  r.Zero))..      
4a00: 20 20 20 20 20 20 72 65 74 75 72 6e 20 22 6e 75        return "nu
4a10: 6c 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 72  ll connection or
4a20: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   database handle
4a30: 22 3b 0d 0a 0d 0a 20 20 20 20 20 20 20 20 6c 6f  ";....        lo
4a40: 63 6b 20 28 68 64 6c 29 0d 0a 20 20 20 20 20 20  ck (hdl)..      
4a50: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20    {..           
4a60: 20 69 66 20 28 68 64 6c 2e 49 73 43 6c 6f 73 65   if (hdl.IsClose
4a70: 64 20 7c 7c 20 68 64 6c 2e 49 73 49 6e 76 61 6c  d || hdl.IsInval
4a80: 69 64 29 0d 0a 20 20 20 20 20 20 20 20 20 20 20  id)..           
4a90: 20 20 20 20 20 72 65 74 75 72 6e 20 22 63 6c 6f       return "clo
4aa0: 73 65 64 20 6f 72 20 69 6e 76 61 6c 69 64 20 63  sed or invalid c
4ab0: 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65  onnection handle
4ac0: 22 3b 0d 0a 0d 0a 23 69 66 20 21 53 51 4c 49 54  ";....#if !SQLIT
4ad0: 45 5f 53 54 41 4e 44 41 52 44 0d 0a 20 20 20 20  E_STANDARD..    
4ae0: 20 20 20 20 20 20 20 20 69 6e 74 20 6c 65 6e 3b          int len;
4af0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65  ..            re
4b00: 74 75 72 6e 20 55 54 46 38 54 6f 53 74 72 69 6e  turn UTF8ToStrin
4b10: 67 28 55 6e 73 61 66 65 4e 61 74 69 76 65 4d 65  g(UnsafeNativeMe
4b20: 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 65 72  thods.sqlite3_er
4b30: 72 6d 73 67 5f 69 6e 74 65 72 6f 70 28 64 62 2c  rmsg_interop(db,
4b40: 20 6f 75 74 20 6c 65 6e 29 2c 20 6c 65 6e 29 3b   out len), len);
4b50: 0d 0a 23 65 6c 73 65 0d 0a 20 20 20 20 20 20 20  ..#else..       
4b60: 20 20 20 20 20 72 65 74 75 72 6e 20 55 54 46 38       return UTF8
4b70: 54 6f 53 74 72 69 6e 67 28 55 6e 73 61 66 65 4e  ToString(UnsafeN
4b80: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c  ativeMethods.sql
4b90: 69 74 65 33 5f 65 72 72 6d 73 67 28 64 62 29 2c  ite3_errmsg(db),
4ba0: 20 2d 31 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20   -1);..#endif.. 
4bb0: 20 20 20 20 20 20 20 7d 0d 0a 0d 0a 23 70 72 61         }....#pra
4bc0: 67 6d 61 20 77 61 72 6e 69 6e 67 20 64 69 73 61  gma warning disa
4bd0: 62 6c 65 20 31 36 32 0d 0a 20 20 20 20 20 20 20  ble 162..       
4be0: 20 47 43 2e 4b 65 65 70 41 6c 69 76 65 28 68 64   GC.KeepAlive(hd
4bf0: 6c 29 3b 20 2f 2a 20 4e 4f 54 45 3a 20 55 6e 72  l); /* NOTE: Unr
4c00: 65 61 63 68 61 62 6c 65 20 63 6f 64 65 2e 20 2a  eachable code. *
4c10: 2f 0d 0a 23 70 72 61 67 6d 61 20 77 61 72 6e 69  /..#pragma warni
4c20: 6e 67 20 72 65 73 74 6f 72 65 20 31 36 32 0d 0a  ng restore 162..
4c30: 20 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e 74      }....    int
4c40: 65 72 6e 61 6c 20 73 74 61 74 69 63 20 76 6f 69  ernal static voi
4c50: 64 20 46 69 6e 69 73 68 42 61 63 6b 75 70 28 53  d FinishBackup(S
4c60: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48  QLiteConnectionH
4c70: 61 6e 64 6c 65 20 68 64 6c 2c 20 49 6e 74 50 74  andle hdl, IntPt
4c80: 72 20 62 61 63 6b 75 70 29 0d 0a 20 20 20 20 7b  r backup)..    {
4c90: 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28 28 68  ..        if ((h
4ca0: 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c 20 28  dl == null) || (
4cb0: 62 61 63 6b 75 70 20 3d 3d 20 49 6e 74 50 74 72  backup == IntPtr
4cc0: 2e 5a 65 72 6f 29 29 20 72 65 74 75 72 6e 3b 0d  .Zero)) return;.
4cd0: 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68  .        lock (h
4ce0: 64 6c 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a  dl)..        {..
4cf0: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20              int 
4d00: 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65  n = UnsafeNative
4d10: 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f  Methods.sqlite3_
4d20: 62 61 63 6b 75 70 5f 66 69 6e 69 73 68 28 62 61  backup_finish(ba
4d30: 63 6b 75 70 29 3b 0d 0a 20 20 20 20 20 20 20 20  ckup);..        
4d40: 20 20 20 20 69 66 20 28 6e 20 3e 20 30 29 20 74      if (n > 0) t
4d50: 68 72 6f 77 20 6e 65 77 20 53 51 4c 69 74 65 45  hrow new SQLiteE
4d60: 78 63 65 70 74 69 6f 6e 28 6e 2c 20 6e 75 6c 6c  xception(n, null
4d70: 29 3b 0d 0a 20 20 20 20 20 20 20 20 7d 0d 0a 20  );..        }.. 
4d80: 20 20 20 7d 0d 0a 0d 0a 20 20 20 20 69 6e 74 65     }....    inte
4d90: 72 6e 61 6c 20 73 74 61 74 69 63 20 76 6f 69 64  rnal static void
4da0: 20 46 69 6e 61 6c 69 7a 65 53 74 61 74 65 6d 65   FinalizeStateme
4db0: 6e 74 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  nt(SQLiteConnect
4dc0: 69 6f 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49  ionHandle hdl, I
4dd0: 6e 74 50 74 72 20 73 74 6d 74 29 0d 0a 20 20 20  ntPtr stmt)..   
4de0: 20 7b 0d 0a 20 20 20 20 20 20 20 20 69 66 20 28   {..        if (
4df0: 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29 20 7c 7c  (hdl == null) ||
4e00: 20 28 73 74 6d 74 20 3d 3d 20 49 6e 74 50 74 72   (stmt == IntPtr
4e10: 2e 5a 65 72 6f 29 29 20 72 65 74 75 72 6e 3b 0d  .Zero)) return;.
4e20: 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28 68  .        lock (h
4e30: 64 6c 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d 0a  dl)..        {..
4e40: 23 69 66 20 21 53 51 4c 49 54 45 5f 53 54 41 4e  #if !SQLITE_STAN
4e50: 44 41 52 44 0d 0a 20 20 20 20 20 20 20 20 20 20  DARD..          
4e60: 20 20 69 6e 74 20 6e 20 3d 20 55 6e 73 61 66 65    int n = Unsafe
4e70: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71  NativeMethods.sq
4e80: 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 5f 69  lite3_finalize_i
4e90: 6e 74 65 72 6f 70 28 73 74 6d 74 29 3b 0d 0a 23  nterop(stmt);..#
4ea0: 65 6c 73 65 0d 0a 20 20 20 20 20 20 20 20 20 20  else..          
4eb0: 20 20 69 6e 74 20 6e 20 3d 20 55 6e 73 61 66 65    int n = Unsafe
4ec0: 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71  NativeMethods.sq
4ed0: 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 73  lite3_finalize(s
4ee0: 74 6d 74 29 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20  tmt);..#endif.. 
4ef0: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 28 6e             if (n
4f00: 20 3e 20 30 29 20 74 68 72 6f 77 20 6e 65 77 20   > 0) throw new 
4f10: 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f 6e 28  SQLiteException(
4f20: 6e 2c 20 6e 75 6c 6c 29 3b 0d 0a 20 20 20 20 20  n, null);..     
4f30: 20 20 20 7d 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20     }..    }.... 
4f40: 20 20 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74     internal stat
4f50: 69 63 20 76 6f 69 64 20 43 6c 6f 73 65 43 6f 6e  ic void CloseCon
4f60: 6e 65 63 74 69 6f 6e 28 53 51 4c 69 74 65 43 6f  nection(SQLiteCo
4f70: 6e 6e 65 63 74 69 6f 6e 48 61 6e 64 6c 65 20 68  nnectionHandle h
4f80: 64 6c 2c 20 49 6e 74 50 74 72 20 64 62 29 0d 0a  dl, IntPtr db)..
4f90: 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 69      {..        i
4fa0: 66 20 28 28 68 64 6c 20 3d 3d 20 6e 75 6c 6c 29  f ((hdl == null)
4fb0: 20 7c 7c 20 28 64 62 20 3d 3d 20 49 6e 74 50 74   || (db == IntPt
4fc0: 72 2e 5a 65 72 6f 29 29 20 72 65 74 75 72 6e 3b  r.Zero)) return;
4fd0: 0d 0a 20 20 20 20 20 20 20 20 6c 6f 63 6b 20 28  ..        lock (
4fe0: 68 64 6c 29 0d 0a 20 20 20 20 20 20 20 20 7b 0d  hdl)..        {.
4ff0: 0a 23 69 66 20 21 53 51 4c 49 54 45 5f 53 54 41  .#if !SQLITE_STA
5000: 4e 44 41 52 44 0d 0a 20 20 20 20 20 20 20 20 20  NDARD..         
5010: 20 20 20 69 6e 74 20 6e 20 3d 20 55 6e 73 61 66     int n = Unsaf
5020: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73  eNativeMethods.s
5030: 71 6c 69 74 65 33 5f 63 6c 6f 73 65 5f 69 6e 74  qlite3_close_int
5040: 65 72 6f 70 28 64 62 29 3b 0d 0a 23 65 6c 73 65  erop(db);..#else
5050: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 52 65  ..            Re
5060: 73 65 74 43 6f 6e 6e 65 63 74 69 6f 6e 28 68 64  setConnection(hd
5070: 6c 2c 20 64 62 29 3b 0d 0a 0d 0a 20 20 20 20 20  l, db);....     
5080: 20 20 20 20 20 20 20 69 6e 74 20 6e 3b 0d 0a 0d         int n;...
5090: 0a 20 20 20 20 20 20 20 20 20 20 20 20 74 72 79  .            try
50a0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d  ..            {.
50b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
50c0: 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76   n = UnsafeNativ
50d0: 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33  eMethods.sqlite3
50e0: 5f 63 6c 6f 73 65 5f 76 32 28 64 62 29 3b 0d 0a  _close_v2(db);..
50f0: 20 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20              }.. 
5100: 20 20 20 20 20 20 20 20 20 20 20 63 61 74 63 68             catch
5110: 20 28 45 6e 74 72 79 50 6f 69 6e 74 4e 6f 74 46   (EntryPointNotF
5120: 6f 75 6e 64 45 78 63 65 70 74 69 6f 6e 29 0d 0a  oundException)..
5130: 20 20 20 20 20 20 20 20 20 20 20 20 7b 0d 0a 20              {.. 
5140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e                 n
5150: 20 3d 20 55 6e 73 61 66 65 4e 61 74 69 76 65 4d   = UnsafeNativeM
5160: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 63  ethods.sqlite3_c
5170: 6c 6f 73 65 28 64 62 29 3b 0d 0a 20 20 20 20 20  lose(db);..     
5180: 20 20 20 20 20 20 20 7d 0d 0a 23 65 6e 64 69 66         }..#endif
5190: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  ..            if
51a0: 20 28 6e 20 3e 20 30 29 20 74 68 72 6f 77 20 6e   (n > 0) throw n
51b0: 65 77 20 53 51 4c 69 74 65 45 78 63 65 70 74 69  ew SQLiteExcepti
51c0: 6f 6e 28 6e 2c 20 47 65 74 4c 61 73 74 45 72 72  on(n, GetLastErr
51d0: 6f 72 28 68 64 6c 2c 20 64 62 29 29 3b 0d 0a 20  or(hdl, db));.. 
51e0: 20 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 7d 0d         }..    }.
51f0: 0a 0d 0a 20 20 20 20 69 6e 74 65 72 6e 61 6c 20  ...    internal 
5200: 73 74 61 74 69 63 20 76 6f 69 64 20 52 65 73 65  static void Rese
5210: 74 43 6f 6e 6e 65 63 74 69 6f 6e 28 53 51 4c 69  tConnection(SQLi
5220: 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 48 61 6e 64  teConnectionHand
5230: 6c 65 20 68 64 6c 2c 20 49 6e 74 50 74 72 20 64  le hdl, IntPtr d
5240: 62 29 0d 0a 20 20 20 20 7b 0d 0a 20 20 20 20 20  b)..    {..     
5250: 20 20 20 69 66 20 28 28 68 64 6c 20 3d 3d 20 6e     if ((hdl == n
5260: 75 6c 6c 29 20 7c 7c 20 28 64 62 20 3d 3d 20 49  ull) || (db == I
5270: 6e 74 50 74 72 2e 5a 65 72 6f 29 29 20 72 65 74  ntPtr.Zero)) ret
5280: 75 72 6e 3b 0d 0a 20 20 20 20 20 20 20 20 69 66  urn;..        if
5290: 20 28 68 64 6c 2e 49 73 43 6c 6f 73 65 64 20 7c   (hdl.IsClosed |
52a0: 7c 20 68 64 6c 2e 49 73 49 6e 76 61 6c 69 64 29  | hdl.IsInvalid)
52b0: 20 72 65 74 75 72 6e 3b 0d 0a 20 20 20 20 20 20   return;..      
52c0: 20 20 6c 6f 63 6b 20 28 68 64 6c 29 0d 0a 20 20    lock (hdl)..  
52d0: 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20 20        {..       
52e0: 20 20 20 20 20 49 6e 74 50 74 72 20 73 74 6d 74       IntPtr stmt
52f0: 20 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 3b 0d   = IntPtr.Zero;.
5300: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74  .            int
5310: 20 6e 3b 0d 0a 20 20 20 20 20 20 20 20 20 20 20   n;..           
5320: 20 64 6f 0d 0a 20 20 20 20 20 20 20 20 20 20 20   do..           
5330: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
5340: 20 20 20 20 73 74 6d 74 20 3d 20 55 6e 73 61 66      stmt = Unsaf
5350: 65 4e 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73  eNativeMethods.s
5360: 71 6c 69 74 65 33 5f 6e 65 78 74 5f 73 74 6d 74  qlite3_next_stmt
5370: 28 64 62 2c 20 73 74 6d 74 29 3b 0d 0a 20 20 20  (db, stmt);..   
5380: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20               if 
5390: 28 73 74 6d 74 20 21 3d 20 49 6e 74 50 74 72 2e  (stmt != IntPtr.
53a0: 5a 65 72 6f 29 0d 0a 20 20 20 20 20 20 20 20 20  Zero)..         
53b0: 20 20 20 20 20 20 20 7b 0d 0a 23 69 66 20 21 53         {..#if !S
53c0: 51 4c 49 54 45 5f 53 54 41 4e 44 41 52 44 0d 0a  QLITE_STANDARD..
53d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
53e0: 20 20 20 20 6e 20 3d 20 55 6e 73 61 66 65 4e 61      n = UnsafeNa
53f0: 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c 69  tiveMethods.sqli
5400: 74 65 33 5f 72 65 73 65 74 5f 69 6e 74 65 72 6f  te3_reset_intero
5410: 70 28 73 74 6d 74 29 3b 0d 0a 23 65 6c 73 65 0d  p(stmt);..#else.
5420: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
5430: 20 20 20 20 20 6e 20 3d 20 55 6e 73 61 66 65 4e       n = UnsafeN
5440: 61 74 69 76 65 4d 65 74 68 6f 64 73 2e 73 71 6c  ativeMethods.sql
5450: 69 74 65 33 5f 72 65 73 65 74 28 73 74 6d 74 29  ite3_reset(stmt)
5460: 3b 0d 0a 23 65 6e 64 69 66 0d 0a 20 20 20 20 20  ;..#endif..     
5470: 20 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20             }..  
5480: 20 20 20 20 20 20 20 20 20 20 7d 20 77 68 69 6c            } whil
5490: 65 20 28 73 74 6d 74 20 21 3d 20 49 6e 74 50 74  e (stmt != IntPt
54a0: 72 2e 5a 65 72 6f 29 3b 0d 0a 0d 0a 20 20 20 20  r.Zero);....    
54b0: 20 20 20 20 20 20 20 20 69 66 20 28 49 73 41 75          if (IsAu
54c0: 74 6f 63 6f 6d 6d 69 74 28 68 64 6c 2c 20 64 62  tocommit(hdl, db
54d0: 29 20 3d 3d 20 66 61 6c 73 65 29 20 2f 2f 20 61  ) == false) // a
54e0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
54f0: 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 63  pending on the c
5500: 6f 6e 6e 65 63 74 69 6f 6e 0d 0a 20 20 20 20 20  onnection..     
5510: 20 20 20 20 20 20 20 7b 0d 0a 20 20 20 20 20 20         {..      
5520: 20 20 20 20 20 20 20 20 20 20 6e 20 3d 20 55 6e            n = Un
5530: 73 61 66 65 4e 61 74 69 76 65 4d 65 74 68 6f 64  safeNativeMethod
5540: 73 2e 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64  s.sqlite3_exec(d
5550: 62 2c 20 54 6f 55 54 46 38 28 22 52 4f 4c 4c 42  b, ToUTF8("ROLLB
5560: 41 43 4b 22 29 2c 20 49 6e 74 50 74 72 2e 5a 65  ACK"), IntPtr.Ze
5570: 72 6f 2c 20 49 6e 74 50 74 72 2e 5a 65 72 6f 2c  ro, IntPtr.Zero,
5580: 20 6f 75 74 20 73 74 6d 74 29 3b 0d 0a 20 20 20   out stmt);..   
5590: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 20               if 
55a0: 28 6e 20 3e 20 30 29 20 74 68 72 6f 77 20 6e 65  (n > 0) throw ne
55b0: 77 20 53 51 4c 69 74 65 45 78 63 65 70 74 69 6f  w SQLiteExceptio
55c0: 6e 28 6e 2c 20 47 65 74 4c 61 73 74 45 72 72 6f  n(n, GetLastErro
55d0: 72 28 68 64 6c 2c 20 64 62 29 29 3b 0d 0a 20 20  r(hdl, db));..  
55e0: 20 20 20 20 20 20 20 20 20 20 7d 0d 0a 20 20 20            }..   
55f0: 20 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 20 20       }..        
5600: 47 43 2e 4b 65 65 70 41 6c 69 76 65 28 68 64 6c  GC.KeepAlive(hdl
5610: 29 3b 0d 0a 20 20 20 20 7d 0d 0a 0d 0a 20 20 20  );..    }....   
5620: 20 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 69 63   internal static
5630: 20 62 6f 6f 6c 20 49 73 41 75 74 6f 63 6f 6d 6d   bool IsAutocomm
5640: 69 74 28 53 51 4c 69 74 65 43 6f 6e 6e 65 63 74  it(SQLiteConnect
5650: 69 6f 6e 48 61 6e 64 6c 65 20 68 64 6c 2c 20 49  ionHandle hdl, I
5660: 6e 74 50 74 72 20 64 62 29 0d 0a 20 20 20 20 7b  ntPtr db)..    {
5670: 0d 0a 20 20 20 20 20 20 69 66 20 28 64 62 20 3d  ..      if (db =
5680: 3d 20 49 6e 74 50 74 72 2e 5a 65 72 6f 29 20 72  = IntPtr.Zero) r
5690: 65 74 75 72 6e 20 66 61 6c 73 65 3b 0d 0a 20 20  eturn false;..  
56a0: 20 20 20 20 69 66 20 28 68 64 6c 2e 49 73 43 6c      if (hdl.IsCl
56b0: 6f 73 65 64 20 7c 7c 20 68 64 6c 2e 49 73 49 6e  osed || hdl.IsIn
56c0: 76 61 6c 69 64 29 20 72 65 74 75 72 6e 20 66 61  valid) return fa
56d0: 6c 73 65 3b 0d 0a 20 20 20 20 20 20 6c 6f 63 6b  lse;..      lock
56e0: 20 28 68 64 6c 29 0d 0a 20 20 20 20 20 20 7b 0d   (hdl)..      {.
56f0: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72  .          retur
5700: 6e 20 28 55 6e 73 61 66 65 4e 61 74 69 76 65 4d  n (UnsafeNativeM
5710: 65 74 68 6f 64 73 2e 73 71 6c 69 74 65 33 5f 67  ethods.sqlite3_g
5720: 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74 28 64 62  et_autocommit(db
5730: 29 20 3d 3d 20 31 29 3b 0d 0a 20 20 20 20 20 20  ) == 1);..      
5740: 7d 0d 0a 23 70 72 61 67 6d 61 20 77 61 72 6e 69  }..#pragma warni
5750: 6e 67 20 64 69 73 61 62 6c 65 20 31 36 32 0d 0a  ng disable 162..
5760: 20 20 20 20 20 20 47 43 2e 4b 65 65 70 41 6c 69        GC.KeepAli
5770: 76 65 28 68 64 6c 29 3b 20 2f 2a 20 4e 4f 54 45  ve(hdl); /* NOTE
5780: 3a 20 55 6e 72 65 61 63 68 61 62 6c 65 20 63 6f  : Unreachable co
5790: 64 65 2e 20 2a 2f 0d 0a 23 70 72 61 67 6d 61 20  de. */..#pragma 
57a0: 77 61 72 6e 69 6e 67 20 72 65 73 74 6f 72 65 20  warning restore 
57b0: 31 36 32 0d 0a 20 20 20 20 7d 0d 0a 20 20 7d 0d  162..    }..  }.
57c0: 0a 0d 0a 20 20 69 6e 74 65 72 6e 61 6c 20 69 6e  ...  internal in
57d0: 74 65 72 66 61 63 65 20 49 53 51 4c 69 74 65 53  terface ISQLiteS
57e0: 63 68 65 6d 61 45 78 74 65 6e 73 69 6f 6e 73 0d  chemaExtensions.
57f0: 0a 20 20 7b 0d 0a 20 20 20 20 76 6f 69 64 20 42  .  {..    void B
5800: 75 69 6c 64 54 65 6d 70 53 63 68 65 6d 61 28 53  uildTempSchema(S
5810: 51 4c 69 74 65 43 6f 6e 6e 65 63 74 69 6f 6e 20  QLiteConnection 
5820: 63 6e 6e 29 3b 0d 0a 20 20 7d 0d 0a 0d 0a 20 20  cnn);..  }....  
5830: 5b 46 6c 61 67 73 5d 0d 0a 20 20 69 6e 74 65 72  [Flags]..  inter
5840: 6e 61 6c 20 65 6e 75 6d 20 53 51 4c 69 74 65 4f  nal enum SQLiteO
5850: 70 65 6e 46 6c 61 67 73 45 6e 75 6d 0d 0a 20 20  penFlagsEnum..  
5860: 7b 0d 0a 20 20 20 20 4e 6f 6e 65 20 3d 20 30 2c  {..    None = 0,
5870: 0d 0a 20 20 20 20 52 65 61 64 4f 6e 6c 79 20 3d  ..    ReadOnly =
5880: 20 30 78 30 31 2c 0d 0a 20 20 20 20 52 65 61 64   0x01,..    Read
5890: 57 72 69 74 65 20 3d 20 30 78 30 32 2c 0d 0a 20  Write = 0x02,.. 
58a0: 20 20 20 43 72 65 61 74 65 20 3d 20 30 78 30 34     Create = 0x04
58b0: 2c 0d 0a 20 20 20 20 55 72 69 20 3d 20 30 78 34  ,..    Uri = 0x4
58c0: 30 2c 0d 0a 20 20 20 20 53 68 61 72 65 64 43 61  0,..    SharedCa
58d0: 63 68 65 20 3d 20 30 78 30 31 30 30 30 30 30 30  che = 0x01000000
58e0: 2c 0d 0a 20 20 20 20 44 65 66 61 75 6c 74 20 3d  ,..    Default =
58f0: 20 30 78 30 36 2c 0d 0a 20 20 7d 0d 0a 0d 0a 20   0x06,..  }.... 
5900: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
5910: 20 20 2f 2f 2f 20 54 68 65 20 65 78 74 72 61 20    /// The extra 
5920: 62 65 68 61 76 69 6f 72 61 6c 20 66 6c 61 67 73  behavioral flags
5930: 20 74 68 61 74 20 63 61 6e 20 62 65 20 61 70 70   that can be app
5940: 6c 69 65 64 20 74 6f 20 61 20 63 6f 6e 6e 65 63  lied to a connec
5950: 74 69 6f 6e 2e 0d 0a 20 20 2f 2f 2f 20 3c 2f 73  tion...  /// </s
5960: 75 6d 6d 61 72 79 3e 0d 0a 20 20 5b 46 6c 61 67  ummary>..  [Flag
5970: 73 28 29 5d 0d 0a 20 20 70 75 62 6c 69 63 20 65  s()]..  public e
5980: 6e 75 6d 20 53 51 4c 69 74 65 43 6f 6e 6e 65 63  num SQLiteConnec
5990: 74 69 6f 6e 46 6c 61 67 73 0d 0a 20 20 7b 0d 0a  tionFlags..  {..
59a0: 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61        /// <summa
59b0: 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 4e  ry>..      /// N
59c0: 6f 20 65 78 74 72 61 20 66 6c 61 67 73 2e 0d 0a  o extra flags...
59d0: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
59e0: 61 72 79 3e 0d 0a 20 20 20 20 20 20 4e 6f 6e 65  ary>..      None
59f0: 20 3d 20 30 78 30 2c 0d 0a 0d 0a 20 20 20 20 20   = 0x0,....     
5a00: 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a   /// <summary>..
5a10: 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65        /// Enable
5a20: 20 6c 6f 67 67 69 6e 67 20 6f 66 20 61 6c 6c 20   logging of all 
5a30: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 74  SQL statements t
5a40: 6f 20 62 65 20 70 72 65 70 61 72 65 64 2e 0d 0a  o be prepared...
5a50: 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d        /// </summ
5a60: 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 50  ary>..      LogP
5a70: 72 65 70 61 72 65 20 3d 20 30 78 31 2c 0d 0a 0d  repare = 0x1,...
5a80: 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d  .      /// <summ
5a90: 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  ary>..      /// 
5aa0: 45 6e 61 62 6c 65 20 6c 6f 67 67 69 6e 67 20 6f  Enable logging o
5ab0: 66 20 61 6c 6c 20 62 6f 75 6e 64 20 70 61 72 61  f all bound para
5ac0: 6d 65 74 65 72 20 74 79 70 65 73 20 61 6e 64 20  meter types and 
5ad0: 72 61 77 20 76 61 6c 75 65 73 2e 0d 0a 20 20 20  raw values...   
5ae0: 20 20 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79     /// </summary
5af0: 3e 0d 0a 20 20 20 20 20 20 4c 6f 67 50 72 65 42  >..      LogPreB
5b00: 69 6e 64 20 3d 20 30 78 32 2c 0d 0a 0d 0a 20 20  ind = 0x2,....  
5b10: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
5b20: 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61  >..      /// Ena
5b30: 62 6c 65 20 6c 6f 67 67 69 6e 67 20 6f 66 20 61  ble logging of a
5b40: 6c 6c 20 62 6f 75 6e 64 20 70 61 72 61 6d 65 74  ll bound paramet
5b50: 65 72 20 73 74 72 6f 6e 67 6c 79 20 74 79 70 65  er strongly type
5b60: 64 20 76 61 6c 75 65 73 2e 0d 0a 20 20 20 20 20  d values...     
5b70: 20 2f 2f 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d   /// </summary>.
5b80: 0a 20 20 20 20 20 20 4c 6f 67 42 69 6e 64 20 3d  .      LogBind =
5b90: 20 30 78 34 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f   0x4,....      /
5ba0: 2f 2f 20 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  // <summary>..  
5bb0: 20 20 20 20 2f 2f 2f 20 45 6e 61 62 6c 65 20 6c      /// Enable l
5bc0: 6f 67 67 69 6e 67 20 6f 66 20 61 6c 6c 20 65 78  ogging of all ex
5bd0: 63 65 70 74 69 6f 6e 73 20 63 61 75 67 68 74 20  ceptions caught 
5be0: 66 72 6f 6d 20 75 73 65 72 2d 70 72 6f 76 69 64  from user-provid
5bf0: 65 64 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 6d 61  ed..      /// ma
5c00: 6e 61 67 65 64 20 63 6f 64 65 20 63 61 6c 6c 65  naged code calle
5c10: 64 20 66 72 6f 6d 20 6e 61 74 69 76 65 20 63 6f  d from native co
5c20: 64 65 20 76 69 61 20 64 65 6c 65 67 61 74 65 73  de via delegates
5c30: 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73  ...      /// </s
5c40: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c  ummary>..      L
5c50: 6f 67 43 61 6c 6c 62 61 63 6b 45 78 63 65 70 74  ogCallbackExcept
5c60: 69 6f 6e 20 3d 20 30 78 38 2c 0d 0a 0d 0a 20 20  ion = 0x8,....  
5c70: 20 20 20 20 2f 2f 2f 20 3c 73 75 6d 6d 61 72 79      /// <summary
5c80: 3e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 45 6e 61  >..      /// Ena
5c90: 62 6c 65 20 6c 6f 67 67 69 6e 67 20 6f 66 20 62  ble logging of b
5ca0: 61 63 6b 75 70 20 41 50 49 20 65 72 72 6f 72 73  ackup API errors
5cb0: 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73  ...      /// </s
5cc0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 4c  ummary>..      L
5cd0: 6f 67 42 61 63 6b 75 70 20 3d 20 30 78 31 30 2c  ogBackup = 0x10,
5ce0: 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 73  ....      /// <s
5cf0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 2f  ummary>..      /
5d00: 2f 2f 20 45 6e 61 62 6c 65 20 61 6c 6c 20 6c 6f  // Enable all lo
5d10: 67 67 69 6e 67 2e 0d 0a 20 20 20 20 20 20 2f 2f  gging...      //
5d20: 2f 20 3c 2f 73 75 6d 6d 61 72 79 3e 0d 0a 20 20  / </summary>..  
5d30: 20 20 20 20 4c 6f 67 41 6c 6c 20 3d 20 4c 6f 67      LogAll = Log
5d40: 50 72 65 70 61 72 65 20 7c 20 4c 6f 67 50 72 65  Prepare | LogPre
5d50: 42 69 6e 64 20 7c 20 4c 6f 67 42 69 6e 64 20 7c  Bind | LogBind |
5d60: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ..              
5d70: 20 4c 6f 67 43 61 6c 6c 62 61 63 6b 45 78 63 65   LogCallbackExce
5d80: 70 74 69 6f 6e 20 7c 20 4c 6f 67 42 61 63 6b 75  ption | LogBacku
5d90: 70 2c 0d 0a 0d 0a 20 20 20 20 20 20 2f 2f 2f 20  p,....      /// 
5da0: 3c 73 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20  <summary>..     
5db0: 20 2f 2f 2f 20 54 68 65 20 64 65 66 61 75 6c 74   /// The default
5dc0: 20 65 78 74 72 61 20 66 6c 61 67 73 20 66 6f 72   extra flags for
5dd0: 20 6e 65 77 20 63 6f 6e 6e 65 63 74 69 6f 6e 73   new connections
5de0: 2e 0d 0a 20 20 20 20 20 20 2f 2f 2f 20 3c 2f 73  ...      /// </s
5df0: 75 6d 6d 61 72 79 3e 0d 0a 20 20 20 20 20 20 44  ummary>..      D
5e00: 65 66 61 75 6c 74 20 3d 20 4c 6f 67 43 61 6c 6c  efault = LogCall
5e10: 62 61 63 6b 45 78 63 65 70 74 69 6f 6e 0d 0a 20  backException.. 
5e20: 20 7d 0d 0a 0d 0a 20 20 2f 2f 20 54 68 65 73 65   }....  // These
5e30: 20 61 72 65 20 74 68 65 20 6f 70 74 69 6f 6e 73   are the options
5e40: 20 74 6f 20 74 68 65 20 69 6e 74 65 72 6e 61 6c   to the internal
5e50: 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 20   sqlite3_config 
5e60: 63 61 6c 6c 2e 0d 0a 20 20 69 6e 74 65 72 6e 61  call...  interna
5e70: 6c 20 65 6e 75 6d 20 53 51 4c 69 74 65 43 6f 6e  l enum SQLiteCon
5e80: 66 69 67 4f 70 73 45 6e 75 6d 0d 0a 20 20 7b 0d  figOpsEnum..  {.
5e90: 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46  .    SQLITE_CONF
5ea0: 49 47 5f 4e 4f 4e 45 20 3d 20 30 2c 20 2f 2f 20  IG_NONE = 0, // 
5eb0: 6e 69 6c 20 0d 0a 20 20 20 20 53 51 4c 49 54 45  nil ..    SQLITE
5ec0: 5f 43 4f 4e 46 49 47 5f 53 49 4e 47 4c 45 54 48  _CONFIG_SINGLETH
5ed0: 52 45 41 44 20 3d 20 31 2c 20 2f 2f 20 6e 69 6c  READ = 1, // nil
5ee0: 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f   ..    SQLITE_CO
5ef0: 4e 46 49 47 5f 4d 55 4c 54 49 54 48 52 45 41 44  NFIG_MULTITHREAD
5f00: 20 3d 20 32 2c 20 2f 2f 20 6e 69 6c 20 0d 0a 20   = 2, // nil .. 
5f10: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
5f20: 5f 53 45 52 49 41 4c 49 5a 45 44 20 3d 20 33 2c  _SERIALIZED = 3,
5f30: 20 2f 2f 20 6e 69 6c 20 0d 0a 20 20 20 20 53 51   // nil ..    SQ
5f40: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 41 4c 4c  LITE_CONFIG_MALL
5f50: 4f 43 20 3d 20 34 2c 20 2f 2f 20 73 71 6c 69 74  OC = 4, // sqlit
5f60: 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 2a 20  e3_mem_methods* 
5f70: 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e  ..    SQLITE_CON
5f80: 46 49 47 5f 47 45 54 4d 41 4c 4c 4f 43 20 3d 20  FIG_GETMALLOC = 
5f90: 35 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f 6d 65  5, // sqlite3_me
5fa0: 6d 5f 6d 65 74 68 6f 64 73 2a 20 0d 0a 20 20 20  m_methods* ..   
5fb0: 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 53   SQLITE_CONFIG_S
5fc0: 43 52 41 54 43 48 20 3d 20 36 2c 20 2f 2f 20 76  CRATCH = 6, // v
5fd0: 6f 69 64 2a 2c 20 69 6e 74 20 73 7a 2c 20 69 6e  oid*, int sz, in
5fe0: 74 20 4e 20 0d 0a 20 20 20 20 53 51 4c 49 54 45  t N ..    SQLITE
5ff0: 5f 43 4f 4e 46 49 47 5f 50 41 47 45 43 41 43 48  _CONFIG_PAGECACH
6000: 45 20 3d 20 37 2c 20 2f 2f 20 76 6f 69 64 2a 2c  E = 7, // void*,
6010: 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 4e 20 0d   int sz, int N .
6020: 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46  .    SQLITE_CONF
6030: 49 47 5f 48 45 41 50 20 3d 20 38 2c 20 2f 2f 20  IG_HEAP = 8, // 
6040: 76 6f 69 64 2a 2c 20 69 6e 74 20 6e 42 79 74 65  void*, int nByte
6050: 2c 20 69 6e 74 20 6d 69 6e 20 0d 0a 20 20 20 20  , int min ..    
6060: 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45  SQLITE_CONFIG_ME
6070: 4d 53 54 41 54 55 53 20 3d 20 39 2c 20 2f 2f 20  MSTATUS = 9, // 
6080: 62 6f 6f 6c 65 61 6e 20 0d 0a 20 20 20 20 53 51  boolean ..    SQ
6090: 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 55 54 45  LITE_CONFIG_MUTE
60a0: 58 20 3d 20 31 30 2c 20 2f 2f 20 73 71 6c 69 74  X = 10, // sqlit
60b0: 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73  e3_mutex_methods
60c0: 2a 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43  * ..    SQLITE_C
60d0: 4f 4e 46 49 47 5f 47 45 54 4d 55 54 45 58 20 3d  ONFIG_GETMUTEX =
60e0: 20 31 31 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f   11, // sqlite3_
60f0: 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 2a 20 0d  mutex_methods* .
6100: 0a 20 20 20 20 2f 2f 20 70 72 65 76 69 6f 75 73  .    // previous
6110: 6c 79 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47  ly SQLITE_CONFIG
6120: 5f 43 48 55 4e 4b 41 4c 4c 4f 43 20 31 32 20 77  _CHUNKALLOC 12 w
6130: 68 69 63 68 20 69 73 20 6e 6f 77 20 75 6e 75 73  hich is now unus
6140: 65 64 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43  ed..    SQLITE_C
6150: 4f 4e 46 49 47 5f 4c 4f 4f 4b 41 53 49 44 45 20  ONFIG_LOOKASIDE 
6160: 3d 20 31 33 2c 20 2f 2f 20 69 6e 74 20 69 6e 74  = 13, // int int
6170: 20 0d 0a 20 20 20 20 53 51 4c 49 54 45 5f 43 4f   ..    SQLITE_CO
6180: 4e 46 49 47 5f 50 43 41 43 48 45 20 3d 20 31 34  NFIG_PCACHE = 14
6190: 2c 20 2f 2f 20 73 71 6c 69 74 65 33 5f 70 63 61  , // sqlite3_pca
61a0: 63 68 65 5f 6d 65 74 68 6f 64 73 2a 20 0d 0a 20  che_methods* .. 
61b0: 20 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47     SQLITE_CONFIG
61c0: 5f 47 45 54 50 43 41 43 48 45 20 3d 20 31 35 2c  _GETPCACHE = 15,
61d0: 20 2f 2f 20 73 71 6c 69 74 65 33 5f 70 63 61 63   // sqlite3_pcac
61e0: 68 65 5f 6d 65 74 68 6f 64 73 2a 20 0d 0a 20 20  he_methods* ..  
61f0: 20 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f    SQLITE_CONFIG_
6200: 4c 4f 47 20 3d 20 31 36 2c 20 2f 2f 20 78 46 75  LOG = 16, // xFu
6210: 6e 63 2c 20 76 6f 69 64 2a 20 0d 0a 20 20 7d 0d  nc, void* ..  }.
6220: 0a 0d 0a 7d 0d 0a                                ...}..