/// Creates a database file. This just creates a zero-byte file which SQLite
/// will turn into a database when the file is opened properly.
///
- /// The file to create
- static public void CreateFile(string databaseFilename)
+ /// The file to create
+ static public void CreateFile(string databaseFileName)
{
- IO.FileStream fs = IO.File.Create(databaseFilename);
+ IO.FileStream fs = IO.File.Create(databaseFileName);
fs.Close();
}
///
/// On NTFS volumes, this function turns on the compression attribute for the given file.
/// It must not be open or referenced at the time of the function call.
///
- /// The file to compress
- static public void CompressFile(string databaseFilename)
+ /// The file to compress
+ static public void CompressFile(string databaseFileName)
{
- UnsafeNativeMethods.sqlite3_compressfile(databaseFilename);
+ UnsafeNativeMethods.sqlite3_compressfile(databaseFileName);
}
///
/// On NTFS volumes, this function removes the compression attribute for the given file.
/// It must not be open or referenced at the time of the function call.
///
- /// The file to decompress
- static public void DecompressFile(string databaseFilename)
+ /// The file to decompress
+ static public void DecompressFile(string databaseFileName)
{
- UnsafeNativeMethods.sqlite3_decompressfile(databaseFilename);
+ UnsafeNativeMethods.sqlite3_decompressfile(databaseFileName);
}
///
/// On NTFS volumes, this function turns on the EFS (Encrypted File System) attribute
/// for the given file, which causes the file to be encrypted.
@@ -256,14 +256,14 @@
///
///
/// Requires Win2K and above, plus a valid EFS certificate (which is beyond the scope
/// of this function description).
///
- /// The file to encrypt
- static public void EncryptFile(string databaseFilename)
+ /// The file to encrypt
+ static public void EncryptFile(string databaseFileName)
{
- int n = UnsafeNativeMethods.sqlite3_encryptfile(databaseFilename);
+ int n = UnsafeNativeMethods.sqlite3_encryptfile(databaseFileName);
if (n == 0) throw new System.ComponentModel.Win32Exception();
}
///
/// On NTFS volumes, this function removes the encryption attribute from the file,
@@ -272,14 +272,14 @@
///
///
/// Requires Win2K and above, plus a valid EFS certificate (which is beyond the scope
/// of this function description).
///
- /// The file to decrypt
- static public void DecryptFile(string databaseFilename)
+ /// The file to decrypt
+ static public void DecryptFile(string databaseFileName)
{
- int n = UnsafeNativeMethods.sqlite3_decryptfile(databaseFilename);
+ int n = UnsafeNativeMethods.sqlite3_decryptfile(databaseFileName);
if (n == 0) throw new System.ComponentModel.Win32Exception();
}
///
/// Returns true if the file is encrypted, or false otherwise.
@@ -286,16 +286,16 @@
///
///
/// Requires Win2K and above, plus a valid EFS certificate (which is beyond the scope
/// of this function description).
///
- /// The file to check
+ /// The file to check
/// true if the file is encrypted
- static public bool IsEncrypted(string databaseFilename)
+ static public bool IsEncrypted(string databaseFileName)
{
int status;
- int n = UnsafeNativeMethods.sqlite3_encryptedstatus(databaseFilename, out status);
+ int n = UnsafeNativeMethods.sqlite3_encryptedstatus(databaseFileName, out status);
if (n == 0) throw new System.ComponentModel.Win32Exception();
return (status == 1);
}
@@ -992,11 +992,11 @@
using (SQLiteDataReader rdTable = cmdTable.ExecuteReader(CommandBehavior.SchemaOnly))
{
tblSchema = rdTable.GetSchemaTable();
foreach (DataRow schemaRow in tblSchema.Rows)
{
- if (Convert.ToBoolean(schemaRow[SchemaTableColumn.IsKey]) == true)
+ if (Convert.ToBoolean(schemaRow[SchemaTableColumn.IsKey], CultureInfo.CurrentCulture) == true)
{
row = tbl.NewRow();
row["TABLE_CATALOG"] = strCatalog;
row["TABLE_NAME"] = rdTables.GetString(2);
row["INDEX_CATALOG"] = strCatalog;
@@ -1500,11 +1500,11 @@
using (SQLiteDataReader rdTable = cmdTable.ExecuteReader(CommandBehavior.SchemaOnly))
{
tblSchema = rdTable.GetSchemaTable();
foreach (DataRow schemaRow in tblSchema.Rows)
{
- if (Convert.ToBoolean(schemaRow[SchemaTableColumn.IsKey]) == true)
+ if (Convert.ToBoolean(schemaRow[SchemaTableColumn.IsKey], CultureInfo.CurrentCulture) == true)
{
row = tbl.NewRow();
row["CONSTRAINT_CATALOG"] = strCatalog;
row["CONSTRAINT_NAME"] = String.Format(CultureInfo.CurrentCulture, "PK_{0}_{1}", rdTables.GetString(2), schemaRow[SchemaTableColumn.BaseColumnName]);
row["TABLE_CATALOG"] = strCatalog;
Index: bin/CompactFramework/SQLite.Interop.dll
==================================================================
--- bin/CompactFramework/SQLite.Interop.dll
+++ bin/CompactFramework/SQLite.Interop.dll
cannot compute difference between binary files
Index: bin/CompactFramework/System.Data.SQLite.dll
==================================================================
--- bin/CompactFramework/System.Data.SQLite.dll
+++ bin/CompactFramework/System.Data.SQLite.dll
cannot compute difference between binary files
Index: bin/CompactFramework/testce.exe
==================================================================
--- bin/CompactFramework/testce.exe
+++ bin/CompactFramework/testce.exe
cannot compute difference between binary files
Index: bin/Designer/Install.vbs
==================================================================
--- bin/Designer/Install.vbs
+++ bin/Designer/Install.vbs
@@ -1,6 +1,6 @@
-Const SQLiteVersion = "1.0.17.0"
+Const SQLiteVersion = "1.0.18.0"
Main
Sub Main()
Index: bin/Designer/SQLite.Designer.dll
==================================================================
--- bin/Designer/SQLite.Designer.dll
+++ bin/Designer/SQLite.Designer.dll
cannot compute difference between binary files
Index: bin/System.Data.SQLite.dll
==================================================================
--- bin/System.Data.SQLite.dll
+++ bin/System.Data.SQLite.dll
cannot compute difference between binary files
Index: bin/itanium/System.Data.SQLite.DLL
==================================================================
--- bin/itanium/System.Data.SQLite.DLL
+++ bin/itanium/System.Data.SQLite.DLL
cannot compute difference between binary files
Index: bin/test.exe
==================================================================
--- bin/test.exe
+++ bin/test.exe
cannot compute difference between binary files
Index: bin/x64/System.Data.SQLite.DLL
==================================================================
--- bin/x64/System.Data.SQLite.DLL
+++ bin/x64/System.Data.SQLite.DLL
cannot compute difference between binary files
Index: readme.htm
==================================================================
--- readme.htm
+++ readme.htm
@@ -3,11 +3,11 @@
ADO.NET 2.0 SQLite Data Provider
- Version 1.0.17- Aug 27, 2005
+ Version 1.0.18- Sep 1, 2005
Interop using SQLite 3.2.5
Written by Robert Simpson (robert@blackcastlesoft.com)
Released to the public domain, use at your own risk!
This provider was written and tested using the Visual Studio 2005 Beta 2
@@ -19,46 +19,65 @@
Features:
-
- -
- Visual Studio Design-Time Support. You can add a SQLite database to the
- Servers list, design queries with the Query Designer, drag-and-drop tables onto
- a Typed DataSet, etc.
+
+ -
+ Supports the Full and Compact .NET Framework.
+
-
+ On the Compact Framework, it is faster than the newly-introduced Sql Server
+ Mobile, often more than 10x faster at inserts/updates. SQLite databases
+ are also a fraction of the size of Sql Mobile databases.
+
-
+ Full Visual Studio 2005 Design-Time Support. You can add a SQLite
+ database to the Servers list, design queries with the Query Designer,
+ drag-and-drop tables onto a Typed DataSet, etc.
+
-
+ Single file redistributable for the full .net framework (Compact Framework
+ requires 2 binaries). The core sqlite3 codebase and the ADO.NET wrapper
+ are combined into one multi-module assembly.
+
-
+ Native 64-bit multi-module assemblies for Itanium and X64 processors.
+
-
+ DbProviderFactory support.
-
- DbProviderFactory support, just add the XML below at the machine.config and/or
- app.config level.
-
-
- Full support for ATTACH'ed databases. Exposed as Catalogs
+ Full support for ATTACH'ed databases. Exposed as Catalogs
in the schema. When cloning a connection, all attached databases are
automatically re-attached to the new connection.
-
-
- DbConnection.GetSchema(...) support includes the MetaDataCollections, DataSourceInformation,
- Columns, Tables, Views, ViewColumns, Catalogs, Indexes,
- IndexColumns and ForeignKeys
+
-
+ DbConnection.GetSchema(...) support includes the MetaDataCollections, DataSourceInformation,
+ Columns, Tables, Views, ViewColumns, Catalogs, Indexes,
+ IndexColumns and ForeignKeys
keywords.
-
-
+
-
Enhanced DbDataReader.GetSchemaTable() functionality returns catalog, namespace
and detailed schema information even for complex queries.
-
-
+
-
Named and unnamed parameters.
-
-
- Full UTF-8 and UTF-16 support, each with optimized pipelines into the native database
- core.
-
-
+
-
+ Full UTF-8 and UTF-16 support, each with optimized pipelines into the native
+ database core.
+
-
Multiple simultaneous DataReaders (one DataReader per Command however).
-
-
+
-
Full support for user-defined scalar and aggregate functions, encapsulated into
an easy-to-use base class in which only a couple of overrides are necessary to
implement new SQL functions.
-
-
- Full support for user-defined collating sequences, every bit as simple to
- implement as user-defined functions and uses the same base class.
- - Create and encrypt databases using Win2K+ Encrypting File System (EFS). Supports creating NTFS compressed database files.
-
+ -
+ Full support for user-defined collating sequences, every bit as simple to
+ implement as user-defined functions and uses the same base class.
+
-
+ Create and encrypt databases using Win2K+ Encrypting File System (EFS).
+ Supports creating NTFS compressed database files.
+
-
+ Full source for the entire engine and wrapper. No copyrights.
+ Public Domain. 100% free. If you want to know if you can use it in
+ your commercial project, please read the previous sentence again -- only slower
+ and sound out the words this time.
+
+
Design-Time Support (new as of 1.0.14)
Until an installer is created, the steps for registering the provider for
design-time support are:
@@ -88,11 +107,11 @@
<configuration>
<system.data>
<DbProviderFactories>
- <add name="SQLite Data Provider" invariant="System.Data.SQLite" description=".Net Framework Data Provider for SQLite"
type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite, Version=1.0.17.0, Culture=neutral, PublicKeyToken=db937bc2d44ff139" />
+ <add name="SQLite Data Provider" invariant="System.Data.SQLite" description=".Net Framework Data Provider for SQLite"
type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite, Version=1.0.18.0, Culture=neutral, PublicKeyToken=db937bc2d44ff139" />
</DbProviderFactories>
</system.data>
</configuration>
If you choose to install the Visual Studio Design-Time support for SQLite, you
@@ -156,43 +175,53 @@
Version History
- 1.0.17 - August 27, 2005
+ 1.0.18 - September 1, 2005
+
+ -
+ Added type-specific method calls when using the various SQLite classes that
+ would've normally returned a a generic Db base class, which aligns the code
+ better with the Microsoft-supplied data providers.
+ 1.0.17 - August 26, 2005
-
Code merge with SQLite 3.2.5
-
- Added Itanium and x64 build settings to the project (needs testing)
+
-
+ Added Itanium and x64 build settings to the project (needs testing)
-
Bugfixes and enhancements to several schema types
-
- Additional design-time support to include index and foreign key enumerations.
- Requires re-registering the designer using INSTALL.CMD. The new designer code
- now allows the VS query designer and typed datasets to automatically link up foreign
- keys, use indexes, and automatically generate relationships from the schema.
-
+ Additional design-time support to include index and foreign key
+ enumerations. Requires re-registering the designer using
+ INSTALL.CMD. The new designer code now allows the VS query designer and
+ typed datasets to automatically link up foreign keys, use indexes, and
+ automatically generate relationships from the schema.
-
Additional static methods on SQLiteConnection to create a database file,
encrypt a file using the Encrypted File System (EFS) on NTFS (requires NT 2K or
above) and NTFS file compression
- 1.0.16 - August 24, 2005
+ 1.0.16 - August 24, 2005
-
Code merge with SQLite 3.2.4 with the large delete bugfix in CVS (which will
become 3.2.5 soon)
-
Added new GetSchema() types: IndexColumns, ViewColumns, ForeignKeys
- 1.0.15 - August 22, 2005
+ 1.0.15 - August 22, 2005
+
-
Code merge with SQLite 3.2.3
-
Minor updates for better design-time experience. More design-time code to
follow in subsequent releases.
- 1.0.14 - August 16, 2005
+ 1.0.14 - August 16, 2005
+
-
Fixed a bug in the SQLiteDataAdapter due to insufficient implementation of the
class. The RowUpdating and RowUpdated events are now properly
implemented, but unfortunately inserting and updating data in a DataTable or
@@ -201,210 +230,241 @@
-
Lots of schema changes to support Visual Studio's Data Designer architecture.
- Added
Designer support for the provider. It's not 100%, but you can design
queries, add typed datasets and perform quite a number of tasks all within
Visual Studio now.
- 1.0.13 - August 8, 2005
-
- -
- Fixed a named parameter bug when UseUTF16Encoding was True.
-
-
- Fixed a performance issue in SQLite3_UTF16 involving string marshaling.
-
- 1.0.12 - August 5, 2005
-
- -
- Full support for the Compact Framework. Each build (Debug/Release) now
- has a platform, either Win32 or Compact Framework. The correct
- projects are built accordingly. See the Distributing
- SQLite
- section for information on what files need to be distributed for each
- platform.
-
-
+
1.0.13 - August 8, 2005
+
+
+
+ -
+ Fixed a named parameter bug in the base SQLite_UTF16 class, which of course
+ only showed up when a database connection was opened using the
+ UseUTF16Encoding=True parameter.
+
-
+ Fixed a performance issue in SQLite_UTF16 involving string marshaling.
+
1.0.12 - August 5, 2005
+
+
+
+ -
+ Full support for the Compact Framework. Each build (Debug/Release) now
+ has a platform, either Win32 or Compact Framework. The correct
+ projects are built accordingly. See the Distributing
+ SQLite
+ section for information on what files need to be distributed for each
+ platform.
+
-
Modified SQLite3.Reset() and Step() functions to transparently handle timeouts
while waiting on the database to become available (typically when a writer is
- waiting on a reader to finish, or a reader is waiting on a writer to finish).
-
-
1.0.11 - August 1, 2005
-
- -
- For everything except the Compact Framework, System.Data.SQLite.DLL is
- now the only DLL required to use this provider! The
+ waiting on a reader to finish, or a reader is waiting on a writer to finish).
+
-
+ Lots of code cleanup as suggested by the Code Analyzer (FxCop).
+
-
+ Lots of updates to the helpfile (as you can see).
+
-
+ Statements were already prepared lazily in a SQLiteCommand, but now
+ its even more lazy. Statements are now only prepared if the statements
+ haven't been previously prepared and a Prepare() function is called (and the
+ command is associated with a connection) or just prior to the command being
+ executed.
+
1.0.11 - August 1, 2005
+
+
+ -
+ For everything except the Compact Framework, System.Data.SQLite.DLL is
+ now the only DLL required to use this provider! The
assembly is now a multi-module assembly, containing both the native SQLite3
codebase and the C# classes built on top of it. The Compact Framework
version (when completed) will not be able to support this feature, so backwards
compatibility with the Compact Framework has been preserved for the future.
-
-
+
-
Fixed a bug in SQLiteCommand.ExecuteScalar() that caused it to stop executing
commands once it obtained the first column of the first row-returning
resultset. Any remaining statements after the row-returning statement was
- ignored.
-
- 1.0.10 - June 10, 2005
-
+ 1.0.10 - June 10, 2005
+
+
+ -
Fixed a bug in the SQLite3.cs Prepare() function that created a statement even
when the SQLite engine returned a NULL pointer. Typically this occurs when
multiple statements are processed and there are trailing comments at the end of
the statement.
-
-
+
-
Fixed a bug in SQLiteStatement.cs that retrieved parameter names for a
parameterized query. SQLite's parameters are 1-based, and the function
was starting at 0. This was fine when all parameters were unnamed, but
- for named parameters it caused the parameters to be out of whack.
-
- 1.0.09a - May 25, 2005
-
- -
+ for named parameters it caused the parameters to be out of whack.
+
+
+ 1.0.09a - May 25, 2005
+
+
+ -
Fixed a broken helpfile and corrected some obsolete help remarks in
- SQLiteFunction.cs
- Added a version resource to the SQLite.Interop.DLL.
- 1.0.09 - May 24, 2005
-
- -
+ SQLiteFunction.cs
+
-
+ Added a version resource to the SQLite.Interop.DLL.
+ 1.0.09 - May 24, 2005
+
+
+ -
Code merge with the latest 3.21 version of SQLite.
-
-
- Removed obsolete methods and properties for Whidbey Beta 2
- 1.0.08 Refresh - Mar 24, 2005
-
-
- -
+
-
+ Removed obsolete methods and properties for Whidbey Beta 2
+ 1.0.08 Refresh - Mar 24, 2005
+
+
+
+ -
Code merge with the latest 3.20 version of SQLite.
-
-
- Recompiled the help file to fix a build error in it.
-
- 1.0.08 - Mar 11, 2005
-
-
- -
+
-
+ Recompiled the help file to fix a build error in it.
+
+
+ 1.0.08 - Mar 11, 2005
+
+
+
+ -
Added additional #if statements to support the old beta 1 edition of VS2005.
-
-
- Code merged the SQLite 3.14 source.
-
- 1.0.07 - Mar 5, 2005
-
- -
+
-
+ Code merged the SQLite 3.14 source.
+
+
+ 1.0.07 - Mar 5, 2005
+
+
+ -
Made more optimizations to frequently-called functions, resulting in
significant performance gains in all tests.
-
-
+
-
Recompiled the binaries using the latest VS2005 February CTP, resulting in yet
more significant speed gains. The 100k insert test used to take 3.5
seconds and the insertwithidentity took almost 8 seconds. With the above
- two changes, those tests are now executing in 1.9 and 4.9 seconds respectively.
-
- 1.0.06 - Mar 1, 2005
-
-
-
- -
+ two changes, those tests are now executing in 1.9 and 4.9 seconds respectively.
+ 1.0.06 - Mar 1, 2005
+
+
+
+ -
Speed-ups to SQLiteDataReader. It was interop'ing unnecessarily every
time it tried to fetch a field due to a logic error.
-
-
+
-
Changed/Added some code to SQLiteConvert's internal DbType, Type and
TypeAffinity functions.
-
-
+
-
Fixed the SQLiteDataReader to obey the flags set in the optional
CommandBehavior flag from SQLiteCommand.ExecuteReader().
-
-
+
-
Changed the default page size to 1024 to reflect the defaults of SQLite.
Ignores the "Page Size" connection string option for memory databases, as tests
revealed that changing it resulted in memory corruption errors.
-
-
+
-
Performance enhancements to the SQLiteCommand and SQLiteStatement classes which
reduced the 100,000 row insert execution time as well as the various Function
- execution times significantly.
-
-
-
- 1.0.05 - Feb 25, 2005
-
- -
+ execution times significantly.
+
+
+ 1.0.05 - Feb 25, 2005
+
+
+ -
Fixed the SQLite3 C# class step/reset functions to accomodate schema changes
that invalidate a prepared statement. Statements are recompiled
transparently.
-
-
+
-
Moved all native DLL declarations to an UnsafeNativeMethods class.
-
-
+
-
Split several classes into their own modules for readability.
-
-
+
-
Renamed many internal variables, reviewed access to variables marked as
internal and altered their protection levels accordingly.
-
-
+
-
Due to the presence of the altered sqlite3 codebase and so many added interop
functions, I decided to rename the sqlite3 C project and the DLL to
SQLite.Interop.DLL. This is the same core sqlite3 codebase but designed
specifically for this ADO.NET provider. This eliminates any possibility
of someone dropping another build of sqlite3.dll into the system and rendering
the provider inoperable. In the future if the folks at sqlite.org finally
introduce a method of retrieving column usage for an arbitrary prepared
statement, I'll retool this library to be a lightweight function call wrapper
around the core binary distribution.
-
-
+
-
Added [SuppressUnmanagedCodeSecurity] attribute to the UnsafeNativeMethods
class which brings VS2005 November CTP execution speeds inline with the
December CTP.
-
-
- Added a bin
+
-
+ Added a bin
directory to the project root where pre-compiled binaries can be found.
-
-
- Added a doc
+
-
+ Added a doc
directory where preliminary documentation on the class library can be found.
-
-
- Documented a lot more of the classes internally.
-
-
-
- 1.0.04 - Feb 24, 2005
-
- -
+
-
+ Documented a lot more of the classes internally.
+
+
+ 1.0.04 - Feb 24, 2005
+
+
+ -
Removed the SQLiteContext class and revamped the way UserFunctions work to
simplify the imlementation.
-
-
+
-
Fixed a counting bug in the TestCases class, specifically in the function tests
where I wasn't resetting the counter and it was consequently reporting
intrinsic and raw select calls as being much much faster than they actually
were. The numbers are now much closer to what I expected for performance,
with .NET user-functions still being the slowest, but only by a small margin.
-
-
+
-
Small performance tweaks to SQLiteDataReader.
-
-
+
-
Added PageSize to the SQLiteConnectionStringBuilder and subsequently to the
SQLiteConnection
-
-
+
-
Added a PRAGMA encoding=XXX execution statement to the SQLiteConnection after
- opening a connection.
-
- 1.0.03 - Feb 23, 2005
-
- -
+ opening a connection.
+
+
+ 1.0.03 - Feb 23, 2005
+
+
+ -
Fixed up SQLiteCommandBuilder to correct implementation errors, which resulted
in an enormous performance boost in the InsertMany test. 10,000 row
insert that executed in 1500ms now executes in 500ms.
-
-
+
-
Fixed several errors in the SQLite3_UTF16 class. ToString() was working
incorrectly and the Open() method failed to register user defined functions and
collations.
-
-
+
-
Fixed a bug in SQLiteCommand.ClearCommands() whereby only the first statement
was being properly cleaned up.
-
-
+
-
Fixed a bug in SQLiteDataReader whereby calling NextResult() would not properly
reset the previously-executed command in the sequence.
-
-
+
-
Added an InsertManyWithIdentityFetch test, which appends a select clause to
populate the ID of the last inserted row into the InsertCommand, demonstrating
- ADO.NET's ability to auto-fetch identity columns on insert.
-
-
- 1.0.02 - Feb 21, 2005
-
- -
+ ADO.NET's ability to auto-fetch identity columns on insert.
+
+
+ 1.0.02 - Feb 21, 2005
+
+ -
Tweaks to the xxx_interop functions that return char *'s, so they also return
the length. Saves an interop call to get the UTF-8 string length during
conversion to a .NET string.
-
-
+
-
Reworked the whole interop.c thing into interop.h and reduced the code required
to merge the main sqlite3 codebase.
-
-
- Added support for user-defined collations.
-
+ -
+ Added support for user-defined collations.
+
+